37 How to Use Interfaces in Go

如何在 Go 使用 interface #

简述 #

编写灵活的、可重复使用的、模块化的代码对于开发多功能的程序至关重要。以这种方式开发,可以避免在多个地方做同样的修改,从而确保代码更容易维护。如何完成这个目标,不同语言有不同的实现方法来完成这个目标。例如,继承是一种常见的方法,在 Java、C++、C#等语言中都有使用。

开发者们也可以通过组合实现这个设计目标。组合是一个将多个对象和数据类型组合到一个复杂的结构体中的方式。这个是 Go 用来促进代码复用,模块化和灵活性的方法。在 Go 中 intrerface 提供了一个方法用于构建复杂的组合,学习使用它们,将会使你创建通用的可重复使用的代码。

在这篇文章中,我们将会学习如何构建那些有相同行为的自定义类型,用于复用代码。 我们还将学习如何为我们自己的自定义类型实现 interface,以满足在另一个包中定义的接口。

定义一个行为 #

组合实现的核心之一是使用 interface。一个 interface 定义一个类型的行为。Go 标准库中最常用的 interface 之一是fmt.Stringer 接口:

type Stringer interface {
    String() string
}

第一行代码定义一个typeStringer。然后表明它是一个interface。就好像定义一个结构体,Go 使用大括号({})来囊括 interface 的定义。跟结构体的定义相比,我们只定义interface行为,就是“这个类型可以做什么”

对这个Stringer接口的例子来说,唯一的行为就是String()这个方法。这个方法没有参数。

接着,让我们看一些代码,这些代码有fmt.Stringer的行为:

package main

import "fmt"

type Article struct {
	Title string
	Author string
}

func (a Article) String() string {
	return fmt.Sprintf("The %q article was written by %s.", a.Title, a.Author)
}

func main() {
	a := Article{
		Title: "Understanding Interfaces in Go",
		Author: "Sammy Shark",
	}
	fmt.Println(a.String())
}

第一件事是我们创建了一个新的类型叫做Article。这个类型有一个Title和一个Author字段,两个都是 string 的 数据类型:

...
type Article struct {
	Title string
	Author string
}
...

接着,我们为 Article 类型定义了一个叫做 String 的 方法String方法将会返回一个用于表示Article类型的字符串:

...
func (a Article) String() string {
	return fmt.Sprintf("The %q article was written by %s.", a.Title, a.Author)
}
...

然后,在我们的mainfunction里,我们创建一个Article类型的实例,并且将它赋值给一个变量a。我们给Title字段设置了一个值,为"理解Go中的Interfaces",给Author字段赋值"Sammy Shark"

...
a := Article{
	Title: "Understanding Interfaces in Go",
	Author: "Sammy Shark",
}
...

紧接着,我们通过调用fmt.Println并传入调用a.String()后的结果,打印出String方法的结果:

...
fmt.Println(a.String())

随后运行程序,你会发现如下输出:

Output
The "Understanding Interfaces in Go" article was written by Sammy Shark.

至此,我们还没有使用 interface,但是我们创建了一个具备一个行为的类型。这个行为匹配fmt.Stringer接口。随后,让我们看看如何利用这种行为来使我们的代码更容易重复使用。

定义一个 interface #

现在,我们已经用所需的行为定义了我们的类型,我们可以看看如何使用该行为。

然而,在这之前,让我们看看如果我们想在一个函数中从Article类型中调用String方法,我们需要做什么:

package main

import "fmt"

type Article struct {
	Title string
	Author string
}

func (a Article) String() string {
	return fmt.Sprintf("The %q article was written by %s.", a.Title, a.Author)
}

func main() {
	a := Article{
		Title: "Understanding Interfaces in Go",
		Author: "Sammy Shark",
	}
	Print(a)
}

func Print(a Article) {
	fmt.Println(a.String())
}

这段代码中,我们添加了一个名为Print的新函数,该函数接收一个Article作为参数。请注意,Print函数唯一做的事情是调用String方法。正因为如此,我们则可以定义一个接口来传递给函数。

package main

import "fmt"

type Article struct {
	Title string
	Author string
}

func (a Article) String() string {
	return fmt.Sprintf("The %q article was written by %s.", a.Title, a.Author)
}

type Stringer interface {
	String() string
}

func main() {
	a := Article{
		Title: "Understanding Interfaces in Go",
		Author: "Sammy Shark",
	}
	Print(a)
}

func Print(s Stringer) {
	fmt.Println(s.String())
}

这里我们创建了一个 interface 叫做Stringer

...
type Stringer interface {
	String() string
}
...

Stringerinterface 只有一个方法,叫做String(),返回一个stringmethod是一个特殊的函数,在 Go 中被限定于一个特殊类型。不像函数,一个方法只能从它所定义的类型的实例中被调用。

然后我们更新Print方法的签名来接收一个Stringer,而不是一个Article的具体类型。因为编译器知道Stringer接口定义了String方法,所以它只接收也有String方法的类型。

现在我们可以对任何满足Stringer接口的东西使用Print方法。让我们创建另一个类型来证明这一点:

package main

import "fmt"

type Article struct {
	Title  string
	Author string
}

func (a Article) String() string {
	return fmt.Sprintf("The %q article was written by %s.", a.Title, a.Author)
}

type Book struct {
	Title  string
	Author string
	Pages  int
}

func (b Book) String() string {
	return fmt.Sprintf("The %q book was written by %s.", b.Title, b.Author)
}

type Stringer interface {
	String() string
}

func main() {
	a := Article{
		Title:  "Understanding Interfaces in Go",
		Author: "Sammy Shark",
	}
	Print(a)

	b := Book{
		Title:  "All About Go",
		Author: "Jenny Dolphin",
		Pages:  25,
	}
	Print(b)
}

func Print(s Stringer) {
	fmt.Println(s.String())
}

现在,我们添加了第二个类型叫Book。它同样也有定义String方法。这表示它也满足Stringer接口。因此,我们也可以传递它到Print函数:

Output
The "Understanding Interfaces in Go" article was written by Sammy Shark.
The "All About Go" book was written by Jenny Dolphin. It has 25 pages.

到目前为止,我们已经演示了如何只使用一个 interface。然而,一个 interface 可以有不止一个行为的定义。接下来,我们将看到如何通过声明更多的方法来使我们的 interface 更加通用。

多行为 interface #

编写 Go 代码的核心原则之一是编写小而简洁的类型,并将它们组成更大,更复杂的类型。组合 interface 也是一样的。为了了解我们是如何建立一个 interface 的,我们先从只定义一个 interface 开始。我们将会定义 2 个形状,一个Circle和一个Square,然后他们都会定义一个方法叫Area。这个方法会返回它们对应形状的几何面积:

package main

import (
	"fmt"
	"math"
)

type Circle struct {
	Radius float64
}

func (c Circle) Area() float64 {
	return math.Pi * math.Pow(c.Radius, 2)
}

type Square struct {
	Width  float64
	Height float64
}

func (s Square) Area() float64 {
	return s.Width * s.Height
}

type Sizer interface {
	Area() float64
}

func main() {
	c := Circle{Radius: 10}
	s := Square{Height: 10, Width: 5}

	l := Less(c, s)
	fmt.Printf("%+v is the smallest\n", l)
}

func Less(s1, s2 Sizer) Sizer {
	if s1.Area() < s2.Area() {
		return s1
	}
	return s2
}

因为每个类型都定义了Area方法,我们可以创建一个 interface 来定义这个行为。我们创建如下的Sizerinterface:

...
type Sizer interface {
	Area() float64
}
...

然后定义一个函数叫做Less,传入 2 个Sizer并返回最小的那一个:

...
func Less(s1, s2 Sizer) Sizer {
	if s1.Area() < s2.Area() {
		return s1
	}
	return s2
}
...

注意到我们不仅接收 2 个都为Sizer的类型,而且返回的结果也用Sizer。这意味着我们不再返回一个Square或者一个Circle,而是Sizerinterface。

最后,我们打印出哪一个是最小的面积:

Output
{Width:5 Height:10} is the smallest

接着,让我们给每个类型添加另一个行为。这次我们添加String()方法,返回一个 string。这个满足fmt.Stringerinterface:

package main

import (
	"fmt"
	"math"
)

type Circle struct {
	Radius float64
}

func (c Circle) Area() float64 {
	return math.Pi * math.Pow(c.Radius, 2)
}

func (c Circle) String() string {
	return fmt.Sprintf("Circle {Radius: %.2f}", c.Radius)
}

type Square struct {
	Width  float64
	Height float64
}

func (s Square) Area() float64 {
	return s.Width * s.Height
}

func (s Square) String() string {
	return fmt.Sprintf("Square {Width: %.2f, Height: %.2f}", s.Width, s.Height)
}

type Sizer interface {
	Area() float64
}

type Shaper interface {
	Sizer
	fmt.Stringer
}

func main() {
	c := Circle{Radius: 10}
	PrintArea(c)

	s := Square{Height: 10, Width: 5}
	PrintArea(s)

	l := Less(c, s)
	fmt.Printf("%v is the smallest\n", l)

}

func Less(s1, s2 Sizer) Sizer {
	if s1.Area() < s2.Area() {
		return s1
	}
	return s2
}

func PrintArea(s Shaper) {
	fmt.Printf("area of %s is %.2f\n", s.String(), s.Area())
}

因为CircleSquare类型都同时实现了AreaString方法,我们现在可以创建另一个 interface 来描述这些更广泛的行为。为了实现这个,我们创建了一个 interface 叫做Shaper。这个Shaper将由Sizerinterface 和fmt.Stringerinterface 组成:

...
type Shaper interface {
	Sizer
	fmt.Stringer
}
...

**注意:**基于习惯,尝试以er结尾来给你的 interface 命名,例如fmt.Stringerio.Writer等等。这也是为什么我们用Shaper来命名我们的 interface,而不是Shape

现在我们可以创建一个名为PrintArea的函数,该函数以Shaper为参数。这意味着我们可以对传入的值调用AreaString这两个方法:

...
func PrintArea(s Shaper) {
	fmt.Printf("area of %s is %.2f\n", s.String(), s.Area())
}

如果我们运行程序,将会收到如下输出:

Output
area of Circle {Radius: 10.00} is 314.16
area of Square {Width: 5.00, Height: 10.00} is 50.00
Square {Width: 5.00, Height: 10.00} is the smallest

我们现在已经看到了我们如何创建较小的 interface,并根据需要将它们建立成较大的 interface。虽然我们可以从较大的 interface 开始,并将其传递给我们所有的函数,但最好的做法是只将最小的 interface 发送给需要的函数。这通常会使代码更加清晰,因为任何接收特定的较小的 interface 的东西都只打算执行其定义的行为。

例如,如果我们将Shaper传递给Less函数,我们可能会认为它要同时调用AreaString方法。然而,由于我们只打算调用Area方法,这使得Less函数很清楚,因为我们知道我们只能调用传递给它的任何参数的Area方法。

总结 #

我们已经看到,创建较小的 interface 并将其构建为较大的 interface,可以让我们只分享我们需要的函数或方法。我们还了解到,我们可以从其他 interface 中组成我们的 interface,包括从其他包中定义的 interface,而不仅仅是我们的包。