Resumo dos Destaques de Funções e Interfaces

Todo item destacado das 9 páginas desta seção, reunido em uma única página e agrupado pela página de origem.

Funções e Interfaces: Modelo de Composição do Go

• Go substitui herança por funções, métodos e interfaces para designs mais simples
• Interfaces são satisfeitas automaticamente quando os métodos correspondem, sem necessidade de implements
• Receptores de ponteiro e valor criam conjuntos de métodos diferentes que afetam a correspondência de interfaces
• Funções são valores de primeira classe, permitindo cadeias de middleware sem boilerplate de interface
• Embutir promove métodos, mas não fornece herança ou substituibilidade
• Aceitar interfaces, retornar structs mantém os chamadores dependentes do comportamento mínimo

Noções Básicas de Funções e Métodos

• Funções Go retornam valores explícitos, geralmente resultado mais erro, substituindo parâmetros de saída
• Receptores de valor copiam a struct para acessadores somente leitura, receptores de ponteiro modificam o estado
• Go pega automaticamente o endereço de uma variável de valor para chamadas de receptor de ponteiro
• Defina interfaces onde são consumidas, não nos tipos, para manter as dependências restritas
• Tipos de função nomeados documentam a intenção melhor do que repetir assinaturas de função
• Parâmetros variádicos se tornam slices dentro da função, devem ser os últimos na assinatura

Retornos Múltiplos, Retornos Nomeados e Retornos Nus

• Funções Go retornam múltiplos valores como tuplas de resultado e erro
• Retornos nomeados declaram variáveis de resultado com escopo para todo o corpo da função
• Retornos nus (sem operandos) retornam os valores atuais dos resultados nomeados
• Retornos nomeados brilham em funções curtas, mas escondem o fluxo de dados quando usados em excesso
• Closures defer observam resultados nomeados por referência, então atribuições afetam os valores de retorno
• Evite retornos nomeados em funções com mais de 40 linhas ou com muitos ramos

Funções Variádicas e Tipos de Função

• Parâmetro variádico se torna um slice dentro da função, use len e range normalmente
• Argumento variádico deve ser o último parâmetro na assinatura da função
• Operador de espalhamento expande o slice como argumentos para a função variádica
• Zero argumentos variádicos cria um slice vazio não-nil, não um slice nil
• Tipos de função permitem funções de ordem superior que aceitam comportamento como dados
• Valores de função nil causam pânico na invocação, exigem verificação nil explícita primeiro

Métodos: Receptores de Valor vs. Ponteiro

• Receptores de valor copiam a struct; mutações internas não persistem para o chamador
• Receptores de ponteiro compartilham estado; mutações persistem e evitam cópias
• Conjuntos de métodos aplicam regras de interface: *T inclui métodos de valor e ponteiro
• Métodos mutantes exigem receptores de ponteiro; receptores de valor perdem alterações
• Structs grandes precisam de receptores de ponteiro para evitar sobrecarga de cópia cara
• Escolha um estilo de receptor por tipo, a menos que documentado de outra forma

Literais de Função e Closures

• Closures capturam variáveis por referência, não por snapshot
• Closures de goroutine compartilhando variáveis de loop veem o valor final
• Corrija bugs de loop de goroutine com id := id ou passe como parâmetro de função
• Envolva o código adiado em um literal de função para adiar dentro de loops, não depois
• Variáveis capturadas mutadas causam corridas em estado compartilhado, proteja com mutex ou canal
• Fábricas retornam closures configurados que escondem e preservam estado mutável

Definindo e Implementando Interfaces

• Aceite interfaces em parâmetros, retorne structs concretas de funções
• Defina interfaces no consumidor, não no pacote produtor
• Mantenha interfaces com um a três métodos para mocks e composição mais simples
• Evite exportar interfaces grandes de pacotes produtores como contratos de compatibilidade
• Nomeie interfaces por capacidade de comportamento como Storage ou Sender, não IStorage
• Interface nil requer que os slots de tipo e valor estejam vazios, diferente de nil não tipado

Interface Nil vs. Ponteiro Nil

• Interfaces são nil apenas quando os slots de tipo e valor são nil
• Ponteiros nil tipados se tornam não-nil quando armazenados em interfaces
• Verificações de igualdade w == nil retornam false para ponteiros nil tipados
• Retornar nil de tipos de interface quebra padrões de retorno opcional
• Retorne ponteiros concretos com erros em vez de interfaces nil
• Use erros sentinela ou helpers IsNil para verificar valores opcionais

Boas Práticas de Funções, Métodos e Interfaces

• Retorne o erro por último nas assinaturas de função para compatibilidade com a convenção Go
• Envolva erros com %w e prefixos de domínio para preservar cadeias de erros
• Use receptores de ponteiro consistentemente quando qualquer método mutar o tipo
• Defina interfaces nos consumidores com 1-3 métodos para contratos focados
• Aceite interfaces, retorne tipos concretos para simplificar contratos de API
• Copie variáveis de loop antes de closures de goroutine para evitar bugs de captura

Y29kZWd1aWRlcy5pb3xjZ2lvNDkxfDIwMjYwNw