Padrão Builder (Builder Pattern)

Construa objetos de configuração ou de domínio complexos passo a passo com padrões, setters fluentes e validação em build().

Receita

let client = HttpClient::builder()
    .timeout(Duration::from_secs(10))
    .build()?;

Quando usar isso: Muitos campos opcionais ou validação que devem ser executados uma vez na construção.

Exemplo de Trabalho

#[derive(Default)]
struct ConfigBuilder {
    port: Option<u16>,
    host: Option<String>,
}
 
impl ConfigBuilder {
    pub fn port(mut self, port: u16) -> Self { self.port = Some(port); self }
    pub fn host(mut self, host: impl Into<String>) -> Self { self.host = Some(host.into()); self }
    pub fn build(self) -> Result<Config, &'static str> {
        Ok(Config {
            port: self.port.ok_or("port required")?,
            host: self.host.unwrap_or_else(|| "localhost".into()),
        })
    }
}

O que isso demonstra:

• Apenas Config é público após a construção bem-sucedida
• Padrões vivem no builder, não espalhados nos pontos de chamada
• build() retorna Result para erros de validação
• Métodos encadeáveis que consomem self

Mergulho Profundo

Use derive com typed-builder ou bon para structs grandes. Para clientes assíncronos, o builder pode produzir um Client que se conecta em build().await.

Armadilhas

• Builder exposto, mas campos da struct públicos - ignora a validação. Correção: campos privados no tipo de produto.
• Builder com muitas chamadas clone - lento. Correção: use mut self na cadeia sem clonar strings até o build.
• Campos opcionais infinitos sem documentação de padrões - confusão. Correção: documente os padrões no rustdoc.

Alternativas

FAQs

Relacionados

• Padrão Typestate - builders em estágios
• Noções Básicas de Padrões Rust - visão geral
• Design de Configuração e Funcionalidades
• Melhores Práticas de Padrões Rust

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.