pcsoft.br.windevCopyright 2026, PC SOFT25 Jul 2025 06:15:19 Z25 Jul 2025 06:11:23 Z**O Padrão Builder** é um padrão de design criacional que separa a construção de um objeto complexo de sua representação , permitindo criar objetos de forma estruturada e flexível. ### Características principais: 1. **Construção Step-by-Step**: Permite construir objetos complexos passo a passo 1. **Flexibilidade**: O mesmo processo de construção pode criar diferentes representações 1. **Legibilidade**: Oferece uma interface fluente que permite encadear métodos, tornando o código mais intuitivo e legível 1. **Validação**: Garante que todos os parâmetros obrigatórios sejam definidos antes do objeto ser construído ### Principais vantagens: - **Evita construtores complexos** com muitos parâmetros - **Permite validação** antes da criação do objeto - **Facilita criação de objetos imutáveis** - **Melhora a legibilidade** do código O exemplo que criei mostra como implementar este padrão em WinDev para um sistema de criação de relatórios, demonstrando a sintaxe fluente e as validações típicas do padrão Builder. # Padrão Builder em WinDev (Builder Design Pattern) ## O que é o Padrão Builder? O **Padrão Builder** é um padrão de design criacional que permite construir objetos complexos passo a passo. Ele separa a construção de um objeto complexo de sua representação, permitindo que o mesmo processo de construção possa criar diferentes representações do objeto. ### Principais características: - **Construção Step-by-Step**: Permite criar objetos em etapas - **Flexibilidade**: Mesmo processo pode criar diferentes representações - **Legibilidade**: Código mais claro e intuitivo - **Validação**: Permite validar o objeto antes da criação ## Exemplo em WinDev (Português) ### Cenário: Sistema de Criação de Relatórios ```windev // Classe principal - Relatório Relatorio é uma Classe PRIVADO m_titulo é cadeia m_subtitulo é cadeia m_dados é array de cadeia m_formato é cadeia m_orientacao é cadeia FIM // Getters PROPRIEDADE Titulo() RESULTADO m_titulo FIM PROPRIEDADE Subtitulo() RESULTADO m_subtitulo FIM PROPRIEDADE Dados() RESULTADO m_dados FIM FIM // Classe Builder RelatorioBuilder é uma Classe PRIVADO m_relatorio é Relatorio FIM // Construtor PROCEDIMENTO Construtor() m_relatorio = novo Relatorio() FIM // Métodos de construção PROCEDIMENTO ComTitulo(titulo é cadeia) m_relatorio.m_titulo = titulo RESULTADO Este FIM PROCEDIMENTO ComSubtitulo(subtitulo é cadeia) m_relatorio.m_subtitulo = subtitulo RESULTADO Este FIM PROCEDIMENTO AdicionarDados(dados é cadeia) m_relatorio.m_dados.Adicionar(dados) RESULTADO Este FIM PROCEDIMENTO ComFormato(formato é cadeia) m_relatorio.m_formato = formato RESULTADO Este FIM PROCEDIMENTO ComOrientacao(orientacao é cadeia) m_relatorio.m_orientacao = orientacao RESULTADO Este FIM // Método final de construção PROCEDIMENTO Construir() // Validações antes de criar o objeto SE m_relatorio.m_titulo = "" ENTÃO RESULTADO Nulo FIM relatorio_final é Relatorio = m_relatorio m_relatorio = novo Relatorio() // Reset para próximo uso RESULTADO relatorio_final FIM FIM // Uso do Builder PROCEDIMENTO CriarRelatorio() builder é RelatorioBuilder = novo RelatorioBuilder() relatorio é Relatorio = builder.ComTitulo("Relatório de Vendas") .ComSubtitulo("Janeiro 2025") .AdicionarDados("Vendas: R$ 150.000") .AdicionarDados("Meta: R$ 120.000") .ComFormato("PDF") .ComOrientacao("Retrato") .Construir() SE relatorio <> Nulo ENTÃO Info("Relatório criado: " + relatorio.Titulo()) SENÃO Erro("Erro ao criar relatório - dados obrigatórios não informados") FIM FIM ``` ## Example in WinDev (English) ### Scenario: Report Creation System ```windev // Main class - Report Report IS a Class PRIVATE m_title is string m_subtitle is string m_data is array of string m_format is string m_orientation is string END // Getters PROPERTY Title() RESULT m_title END PROPERTY Subtitle() RESULT m_subtitle END PROPERTY Data() RESULT m_data END END // Builder class ReportBuilder IS a Class PRIVATE m_report is Report END // Constructor PROCEDURE Constructor() m_report = new Report() END // Construction methods PROCEDURE WithTitle(title is string) m_report.m_title = title RESULT This END PROCEDURE WithSubtitle(subtitle is string) m_report.m_subtitle = subtitle RESULT This END PROCEDURE AddData(data is string) m_report.m_data.Add(data) RESULT This END PROCEDURE WithFormat(format is string) m_report.m_format = format RESULT This END PROCEDURE WithOrientation(orientation is string) m_report.m_orientation = orientation RESULT This END // Final construction method PROCEDURE Build() // Validations before creating the object IF m_report.m_title = "" THEN RESULT Null END final_report is Report = m_report m_report = new Report() // Reset for next use RESULT final_report END END // Using the Builder PROCEDURE CreateReport() builder is ReportBuilder = new ReportBuilder() report is Report = builder.WithTitle("Sales Report") .WithSubtitle("January 2025") .AddData("Sales: $150,000") .AddData("Target: $120,000") .WithFormat("PDF") .WithOrientation("Portrait") .Build() IF report <> Null THEN Info("Report created: " + report.Title()) ELSE Error("Error creating report - required data not provided") END END ``` ## Vantagens do Padrão Builder ### 1. **Legibilidade do Código** O código fica mais claro e auto-documentado, mostrando exatamente como o objeto está sendo construído. ### 2. **Flexibilidade** Permite criar diferentes tipos de objetos usando o mesmo processo de construção. ### 3. **Validação** Pode validar os dados antes de criar o objeto final, garantindo consistência. ### 4. **Method Chaining** Permite encadear métodos para uma sintaxe mais fluente. ### 5. **Objetos Imutáveis** Facilita a criação de objetos imutáveis e thread-safe. ## Quando Usar o Padrão Builder - **Objetos complexos** com muitos parâmetros opcionais - **Construção passo a passo** é necessária - **Diferentes representações** do mesmo objeto - **Validação complexa** antes da criação - **Evitar construtores** com muitos parâmetros ## Advantages of Builder Pattern ### 1. **Code Readability** The code becomes clearer and self-documenting, showing exactly how the object is being constructed. ### 2. **Flexibility** Allows creating different types of objects using the same construction process. ### 3. **Validation** Can validate data before creating the final object, ensuring consistency. ### 4. **Method Chaining** Enables method chaining for more fluent syntax. ### 5. **Immutable Objects** Facilitates creation of immutable and thread-safe objects. ## When to Use Builder Pattern - **Complex objects** with many optional parameters - **Step-by-step construction** is needed - **Different representations** of the same object - **Complex validation** before creation - **Avoid constructors** with many parameters -- Adriano José Boller ______________________________________________ Consultor e Representante Oficial da PcSoft no Brasil +55 (41) 99949 1800 adrianoboller@gmail.com skype: adrianoboller http://wxinformatica.com.br/30WEBDEVpt_BRhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder/read.awpmoderateur@pcsoft.fr (The moderator)webmaster@pcsoft.fr (The webmaster)Bollerpcsoft.br.windevhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5155/read.awp25 Jul 2025 06:15:19 ZEsses exemplos serão mais detalhados, incluindo integração com o ambiente WinDev (como uso de HFSQL para persistência de dados e…https://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5155/read.awphttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5155/read.awpO que é o Padrão Builder?Bollerpcsoft.br.windevhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5154/read.awp25 Jul 2025 06:14:30 ZVamos criar uma classe Fatura para representar uma fatura eletrônica em um sistema de faturamento, inspirado no comentário de Ol…https://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5154/read.awphttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5154/read.awpO que é o Padrão Builder?Bollerpcsoft.br.windevhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5153/read.awp25 Jul 2025 06:13:48 ZVamos criar uma classe Evento para representar um evento em um sistema de gestão de eventos. O evento terá atributos como ID do …https://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5153/read.awphttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5153/read.awpO que é o Padrão Builder?Bollerpcsoft.br.windevhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5152/read.awp25 Jul 2025 06:13:18 ZAbaixo, apresento novos exemplos do padrão Builder em WLangage (usado no ambiente WinDev), conforme solicitado, com um exemplo e…https://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5152/read.awphttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5152/read.awpO que é o Padrão Builder?Bollerpcsoft.br.windevhttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5151/read.awp25 Jul 2025 06:12:42 ZDesculpe pela confusão! Abaixo, apresento uma explicação revisada do padrão Builder com exemplos em WLangage (linguagem usada no…https://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5151/read.awphttps://forum.pcsoft.fr/en-US/pcsoft.br.windev/5150-que-padrao-builder-5151/read.awpO que é o Padrão Builder?