Options Pattern em Go

Felipe — Sun, 17 Mar 2024 17:08:04 +0000

Essa semana estive estudando alguns Padrões de Design em Go e achei bastante interessante a implementação do padrão Options. A ideia desse artigo é explicar a motivação na adoção desse design pattern e destrinchar sua implementação.

Rabiscando um personagem de RPG

Imagine que você, renomado consultor de engenharia de software, é responsável por entregar um protótipo de RPG para um cliente. Você decide começar desenvolvendo pelo personagem Warrior, e implementa dessa forma:

type Warrior struct {
    Attack   int
    Defense  int
    useSword bool
}

func NewWarrior(attack int, def int, useSwordbool) *Warrior {
    w := &Warrior{}
    w.Attack = attack
    w.Defense = def
    w.useSword= useSword

    return w
}

Seu cliente não tem lá um padrão de qualidade muito alto e curtiu muito sua implementação. E ele sai criando vários e vários Warriors pela base de código dessa forma:

w := NewWarrior(10, 5, true)

Beleza. Seu cliente lançou uma versão v0 do tão esperado RPG.

Alguns meses passam, e seu cliente quer mais umas “coisinhas simples” no código para lançar a versão v1 do game. Ele decidiu que seria ótimo se o personagem Warrior também tivesse outros atributos, como hasAxe e hasClub.

Prontamente você modifica a struct e a função construtora:

type Warrior struct {
    Attack   int
    Defense  int
    useSword bool
    useAxe   bool
    useClub  bool
}

func NewWarrior(attack int, def int, useSword bool, useAxe bool, useClub bool) *Warrior {
    w := &Warrior{}
    w.Attack = attack
    w.Defense = def
    w.useSword = useSword
    w.useAxe = useAxe
    w.useClub = useClub

    return w
}

Agora, pra inicializar um novo Warrior na nova versão v1, seu cliente faz dessa forma:

w := NewWarrior(10, 5, true, false, false)

Entretanto, essa implementação tem dois problemas:

Com o aumento da quantidade de atributos da struct Warrior, torna-se inviável usar a função NewWarrior e passar uma quantidade tão grande de argumentos.
Você introduz uma breaking change entre as versões v0 e v1. Seu cliente terá de refatorar toda a base de código para atualizar a assinatura e declaração da função NewWarrior com os novos atributos que a struct Warrior recebeu.

Talvez você já tenha pensado em uma solução: ao invés de passar os valores dos atributos de Warrior como argumento da função construtora, passar uma struct com os atributos, dessa forma:

type Warrior struct {
    attributes Attributes
}

type Attributes struct {
    attack   int
    defense  int
    hasSword bool
}

func NewWarrior(attributes Attributes) *Warrior {
    w := &Warrior{
        attributes: attributes,
    }

    return w
}

func main() {
    w := NewWarrior(
        Attributes{
            10,
            5,
            true,
        },
    )

    fmt.Println(w)
}

Por mais que essa solução resolva o primeiro problema, o segundo ainda será uma dor de cabeça para seu cliente.

Usando o padrão Options

Como fazer um bom código significa escrever código extensível/com fácil manutenção, vamos explorar uma outra abordagem utilizando o padrão Options.

Voltando na implementação da primeira versão v0, vamos criar um novo objeto Warrior dessa forma:

type Warrior struct {
    attack   int
    defense  int
    useSword bool
}

func NewWarrior(options ...func(*Warrior)) *Warrior {
    w := &Warrior{}

    for _, option := range options {
        option(w)
    }

    return w
}

WHAT?!

Eu confesso que de cara não é a função mais fácil de ser entendida, mas você vai ver que daqui alguns minutos tudo fará sentido. Segue o jogo!

A nova função NewWarrior recebe como argumento uma função com assinatura func(*Warrior). Ou seja, recebe como argumento uma outra função cujo argumento é um ponteiro para a struct Warrior, ou melhor, um ponteiro para um objeto de Warrior. Os três pontinhos ali (ou reticências, pra soar mais bonito) indicam que NewWarrior é uma função variádica, ou seja, recebe qualquer número de argumentos. Se eu quiser passar 1, 2, ou 100 funções como argumento de Warrior, a função vai executar normalmente.

O loop for na função faz algo bastante simples: ele executa cada função, passada como argumento em NewWarrior, colocando o objeto w como argumento. Ou seja, a função NewWarrior nada mais é que um loop que vai executar várias funções colocando o objeto w como argumento. No fim, só retorna esse objeto.

Beleza, mas que tipo de função a gente vai passar como argumento de NewWarrior?

Se liga na implementação dessa funçãozinha aqui, que vai setar o valor do ataque do nosso Warrior:

func WithAttack(attack int) func(*Warrior) {
    return func(w *Warrior) {
        w.attack = attack
    }
}

A função WithAttack recebe o valor do ataque desejado e retorna uma nova função func(*Warrior). Logo em seguida, já implementamos essa função de retorno, que é uma função também simples: ela funciona de forma similar a um setter, caso você já tenha estudado um pouquinho de Orientação a Objetos antes.

Agora veja como o seu cliente vai inicializar um novo objeto:


package main

import "fmt"

type Warrior struct {
    attack   int
    defense  int
    useSword bool
}

func NewWarrior(options ...func(*Warrior)) *Warrior {
    w := &Warrior{}

    for _, option := range options {
        option(w)
    }

    return w
}

func WithAttack(attack int) func(*Warrior) {
    return func(w *Warrior) {
        w.attack = attack
    }
}

func WithDefense(def int) func(*Warrior) {
    return func(w *Warrior) {
        w.defense = def
    }
}

func UseSword(useSword bool) func(*Warrior) {
    return func(w *Warrior) {
        w.useSword = useSword
    }
}

func main() {
    w := NewWarrior(
        WithAttack(10),
        WithDefense(5),
        UseSword(true),
    )

    fmt.Println(w)
}

Na nossa nova função construtora de Warrior, vamos passar funções que vão setar os atributos do objetos, ao invés de passar os valores diretamente. Lembre-se que NewWarrior irá apenas executar, em loop, todas as funções passadas a ele usando um objeto do tipo *Warrior como argumento.

Dessa forma, se eu lançar uma nova versão da minha aplicação com novos atributos (como useAxe e useClub), o código não vai quebrar por conta dos objetos inicializados sem esses atributos. Afinal, como NewWarrior é só um loop que executa funções, se eu não passar setters de useAxe e useClub, a função NewWarrior só não vai executar estes setters e o objeto criado terá o valor default para esses atributos.

Esse Design Pattern é bastante útil no design de structs relacionados a configuração de um objeto, como no caso de um server http. Como desafio, recomendo colocar mais alguns atributos na struct Warrior pra você ver como é fácil estender essa struct sem introduzir um breaking change na sua aplicação =)

Referências:
https://golang.cafe/blog/golang-functional-options-pattern.html
https://github.com/tmrts/go-patterns/blob/master/idiom/functional-options.md

DEV Community: Felipe

Options Pattern em Go

Rabiscando um personagem de RPG

Usando o padrão Options