Introdução a Interfaces

Parte da seção Programação Orientada a Objetos do Journey de GO da Coddy — lição 25 de 107.

Uma interface em Go define um conjunto de assinaturas de método sem implementá-las. Ela descreve o que um tipo pode fazer, não como ele faz. Qualquer tipo que implemente todos os métodos em uma interface satisfaz automaticamente essa interface.

Veja como você define uma interface:

type Speaker interface {
    Speak() string
}

Esta interface Speaker exige que qualquer tipo que a implemente tenha um método Speak() que retorne uma string. Agora, qualquer struct com este método pode ser usada onde quer que um Speaker seja esperado.

type Dog struct {
    Name string
}

func (d Dog) Speak() string {
    return d.Name + " says woof!"
}

type Cat struct {
    Name string
}

func (c Cat) Speak() string {
    return c.Name + " says meow!"
}

Tanto Dog quanto Cat satisfazem a interface Speaker porque cada um possui um método Speak() com a assinatura correta. Agora você pode escrever funções que aceitam qualquer Speaker:

func MakeSound(s Speaker) {
    fmt.Println(s.Speak())
}

func main() {
    dog := Dog{Name: "Buddy"}
    cat := Cat{Name: "Whiskers"}
    
    MakeSound(dog)  // Buddy diz woof!
    MakeSound(cat)  // Whiskers diz meow!
}

Interfaces permitem que você escreva código flexível e reutilizável que funciona com qualquer tipo que atenda aos requisitos da interface, independentemente da implementação subjacente.

Desafio

Fácil

Vamos construir um sistema de descrição de veículos que demonstra como as interfaces permitem que diferentes tipos compartilhem comportamentos comuns. Você criará uma interface que múltiplos tipos de veículos podem satisfazer e, em seguida, a usará para descrever qualquer veículo de forma uniforme.

Você organizará seu código em dois arquivos:

vehicles.go: Defina uma interface Describer com um único método Describe() string. Em seguida, crie duas structs que satisfaçam essa interface:
- Car com os campos Brand e Model (ambos strings)
- Bicycle com os campos Type (string) e Gears (int)
Cada struct deve ter um método Describe() que retorna uma string descritiva sobre o veículo.
main.go: Crie uma função chamada PrintDescription que aceita qualquer Describer e imprime o resultado da chamada de seu método Describe(). Leia as informações do veículo a partir da entrada, crie tanto um Car quanto uma Bicycle, e use sua função para imprimir as descrições de cada um.

As seguintes entradas serão fornecidas:

Linha 1: Marca do carro
Linha 2: Modelo do carro
Linha 3: Tipo de bicicleta
Linha 4: Número de marchas (inteiro)

Seus métodos Describe() devem retornar strings nestes formatos:

Car: [Brand] [Model]
Bicycle: [Type] bike with [Gears] gears

Por exemplo, dados Toyota, Camry, Mountain, e 21, sua saída deve ser:

Toyota Camry
Mountain bike with 21 gears

O ponto principal é que sua função PrintDescription funciona com qualquer tipo que possua um método Describe()—ela não precisa saber se está lidando com um Car, Bicycle ou qualquer outro tipo de veículo que você possa adicionar posteriormente.

Folha de consulta

Uma interface em Go define um conjunto de assinaturas de métodos sem implementá-los. Qualquer tipo que implemente todos os métodos satisfaz automaticamente essa interface.

Definindo uma interface:

type Speaker interface {
    Speak() string
}

Tipos que implementam os métodos exigidos satisfazem a interface:

type Dog struct {
    Name string
}

func (d Dog) Speak() string {
    return d.Name + " says woof!"
}

type Cat struct {
    Name string
}

func (c Cat) Speak() string {
    return c.Name + " says meow!"
}

Funções podem aceitar qualquer tipo que satisfaça a interface:

func MakeSound(s Speaker) {
    fmt.Println(s.Speak())
}

func main() {
    dog := Dog{Name: "Buddy"}
    cat := Cat{Name: "Whiskers"}
    
    MakeSound(dog)  // Buddy says woof!
    MakeSound(cat)  // Whiskers says meow!
}

Experimente você mesmo

package main

import (
	"fmt"
)

// TODO: Crie uma função PrintDescription que aceite qualquer Describer
// e imprima o resultado da chamada do seu método Describe()

func main() {
	// Lê a entrada
	var carBrand string
	var carModel string
	var bicycleType string
	var gears int

	fmt.Scanln(&carBrand)
	fmt.Scanln(&carModel)
	fmt.Scanln(&bicycleType)
	fmt.Scanln(&gears)

	// TODO: Crie um Car com a marca e o modelo da entrada

	// TODO: Crie uma Bicycle com o tipo e as marchas da entrada

	// TODO: Use PrintDescription para imprimir a descrição do carro

	// TODO: Use PrintDescription para imprimir a descrição da bicicleta
}