Resumen de Puntos Destacados de Funciones e Interfaces

Cada punto destacado de las 9 páginas de esta sección, reunido en una sola página y agrupado por la página de origen.

Funciones e Interfaces: El Modelo de Composición de Go

• Go reemplaza la herencia con funciones, métodos e interfaces para diseños más simples
• Las interfaces se satisfacen automáticamente cuando los métodos coinciden, no se necesita implements
• Los receptores de puntero y de valor crean diferentes conjuntos de métodos que afectan la coincidencia de interfaces
• Las funciones son valores de primera clase que permiten cadenas de middleware sin código repetitivo de interfaz
• El anidamiento promueve métodos pero no proporciona herencia ni sustituibilidad
• Aceptar interfaces, devolver structs mantiene a los llamadores dependientes del comportamiento mínimo

Conceptos Básicos de Funciones y Métodos

• Las funciones de Go devuelven valores explícitos, a menudo resultado más error, reemplazando los parámetros de salida
• Los receptores de valor copian la struct para accesores de solo lectura, los receptores de puntero modifican el estado
• Go toma automáticamente la dirección de una variable de valor para llamadas de receptor de puntero
• Define interfaces donde se consumen, no en los tipos, para mantener las dependencias estrechas
• Los tipos de función con nombre documentan mejor la intención que repetir las firmas de función
• Los parámetros variádicos se convierten en slices dentro de la función, deben ser los últimos en la firma

Retornos Múltiples, Retornos Nombrados y Retornos Desnudos

• Las funciones de Go devuelven múltiples valores como tuplas de resultado y error
• Los retornos nombrados declaran variables de resultado con ámbito en todo el cuerpo de la función
• Los retornos desnudos (sin operandos) devuelven los valores actuales de los resultados nombrados
• Los retornos nombrados brillan en funciones cortas pero ocultan el flujo de datos cuando se abusa de ellos
• Las clausuras diferidas observan los resultados nombrados por referencia, por lo que las asignaciones afectan los valores de retorno
• Evita los retornos nombrados en funciones que exceden las 40 líneas o con muchas ramas

Funciones Variádicas y Tipos de Función

• El parámetro variádico se convierte en un slice dentro de la función, usa len y range normalmente
• El argumento variádico debe ser el último parámetro en la firma de la función
• El operador de expansión expande el slice como argumentos a la función variádica
• Cero argumentos variádicos crea un slice vacío no nulo, no un slice nulo
• Los tipos de función permiten funciones de orden superior que aceptan el comportamiento como datos
• Los valores de función nulos provocan pánico al invocarse, requieren una verificación nula explícita primero

Métodos: Receptores de Valor vs. Puntero

• Los receptores de valor copian la struct; las mutaciones internas no persisten en el llamador
• Los receptores de puntero comparten el estado; las mutaciones persisten y evitan la copia
• Los conjuntos de métodos imponen reglas de interfaz: *T incluye métodos de valor y puntero
• Los métodos que mutan requieren receptores de puntero; los receptores de valor pierden los cambios
• Las structs grandes necesitan receptores de puntero para evitar sobrecarga de copia costosa
• Elige un estilo de receptor por tipo a menos que se documente lo contrario

Literales de Función y Clausuras

• Las clausuras capturan variables por referencia, no por instantánea
• Las clausuras de Goroutine que comparten variables de bucle ven el valor final
• Corrige errores de bucle de Goroutine con id := id o pásalo como parámetro de función
• Envuelve el código diferido en un literal de función para diferir dentro de los bucles, no después
• Las variables capturadas mutadas causan carreras en el estado compartido, protégelas con mutex o canal
• Las fábricas devuelven clausuras configuradas que ocultan y preservan el estado mutable

Definición e Implementación de Interfaces

• Aceptar interfaces en parámetros, devolver structs concretas de funciones
• Define interfaces en el consumidor, no en el paquete productor
• Mantén las interfaces de uno a tres métodos para mocks y composición más simples
• Evita exportar interfaces grandes de paquetes productores como contratos de compatibilidad
• Nombra las interfaces por capacidad de comportamiento como Storage o Sender, no IStorage
• La interfaz nula requiere que tanto el tipo como los espacios de valor estén vacíos, a diferencia del nulo sin tipo

Interfaz Nula vs. Puntero Nulo

• Las interfaces son nulas solo cuando los espacios de tipo y valor están nulos
• Los punteros nulos tipados se vuelven no nulos cuando se almacenan en interfaces
• Las comprobaciones de igualdad w == nil devuelven false para punteros nulos tipados
• Devolver nil de tipos de interfaz rompe los patrones de retorno opcional
• Devuelve punteros concretos con errores en lugar de interfaces nulas
• Usa errores centinela o ayudantes IsNil para verificar valores opcionales

Mejores Prácticas de Funciones, Métodos e Interfaces

• Devuelve el error al final de las firmas de función para la compatibilidad con la convención de Go
• Envuelve errores con %w y prefijos de dominio para preservar las cadenas de error
• Usa receptores de puntero de manera consistente cuando cualquier método muta el tipo
• Define interfaces en los consumidores con 1-3 métodos para contratos enfocados
• Acepta interfaces, devuelve tipos concretos para simplificar los contratos de API
• Copia las variables de bucle antes de las clausuras de Goroutine para evitar errores de captura

Y29kZWd1aWRlcy5pb3xjZ2lvNDkxfDIwMjYwNw