Интерфейс — контракт

Контракт

type Storage interface {
    Save(name string, data []byte) error
}

type LocalDisk struct{}
func (LocalDisk) Save(name string, data []byte) error {
    // пишет файл на локальный диск
    return nil
}

type S3Backend struct{}
func (S3Backend) Save(name string, data []byte) error {
    // кладёт объект в облако
    return nil
}

var st Storage = LocalDisk{}

Интерфейс — это контракт: «у меня есть метод Save с такой сигнатурой». Кто его выполняет — локальный диск или облако — неважно. Это про поведение, а не про данные: интерфейс не может содержать поля.

Неявная реализация

В Go нет слова implements. Тип удовлетворяет интерфейсу автоматически, если его method set покрывает все методы интерфейса:

Это ключевое отличие от языков с явной реализацией: интерфейс можно ввести задним числом, и существующие типы «подойдут» под него без правок. Стандартная библиотека так и устроена: io.Reader, io.Writer, fmt.Stringer — маленькие интерфейсы, которым удовлетворяют тысячи типов по всему коду. Так же получилось в «Полке»: LocalDisk написан давно и ничего не знал про Storage, но подошёл под него без единой правки.

Интерфейс принимает реализацию

Функция, принимающая интерфейс, работает с любым типом, выполняющим контракт:

func persist(st Storage, name string, data []byte) error {
    return st.Save(name, data)
}

persist(LocalDisk{}, "report.pdf", data)
persist(S3Backend{}, "report.pdf", data)