Go方法及其相关特性 【Go语言圣经笔记】

方法和函数的区别在于有没有指定接收器。

方法

从90年代早期开始,面向对象编程(OOP)就成为了称霸工程界和教育界的编程范式,所以之后几乎所有大规模被应用的语言都包含了对OOP的支持,go语言也不例外。

尽管没有被大众所接受的明确的OOP的定义,从我们的理解来讲,一个对象其实也就是一个简单的值或者一个变量,在这个对象中会包含一些方法,而一个方法则是一个和特殊类型关联的函数一个面向对象的程序会用方法来表达其属性和对应的操作,这样使用这个对象的用户就不需要直接去操作对象,而是借助方法来做这些事情。

(笔者注:OOP中,对象是类的具体化,确实是一个值/变量,对象的属性是由其所属类定义的数据域(即变量域)表示,而方法域则是对其属性所支持的行为的表述)

在早些的章节中,我们已经使用了标准库提供的一些方法,比如time.Duration这个类型的Seconds方法:

const day = 24 * time.Hour
fmt.Println(day.Seconds)  // 86400

并且在2.5节中,我们定义了一个自己的方法,Celsius类型的String方法:

func (c Celsuis) String() string { return fmt.Sprintf("%g°C", c)}

在本章中,OOP编程的第一方面,我们会向你展示如何有效地定义和使用方法。我们会覆盖到OOP编程的两个关键点,封装组合

方法声明

如果函数声明时,在其名字之前放上一个变量,即是一个方法这个附加的参数会将该函数附加到这种类型上即反过来讲相当于为这种类型定义了一个独占的方法

下面来写我们第一个方法的例子,这个例子在package geometry下:

package geometry

import "math"

type Point struct{ X, Y float64 }

// function 函数 未绑定类型
func Distance(p, q Point) float64 {
    return math.Hypot(q.X-p.X, q.Y-p.Y)
}

// method 方法 绑定了类型
func (p Point) Distance(q Point) float64 {
    return math.Hypot(q.X-p.X, q.Y-p.Y)
}

上面的代码里那个附加的参数p,叫做方法的接收器(receiver),早期的面向对象语言留下的遗产将调用一个方法称为“向一个对象发送消息”。

在Go语言中,我们并不会像其它语言那样用this(指java)或者self(指Python)作为接收器;我们可以任意的选择接收器的名字由于接收器的名字经常会被使用到,所以保持其在方法间传递时的一致性和简短性是很重要的这里的建议是可以使用其类型的第一个字母,比如这里使用了Point的首字母p

下面是例子:

p := Point{1, 2}
q := Point{4, 6}
fmt.Println(Distance(p,q))  // 5 function call
fmt.Println(p.Distance(q))  // 5 method call Distance这个方法和类型为Point的结构体绑定

可以看到,上面的两个函数调用都是Distance,但是却没有发生冲突。第一个Distance的调用实际上用的是包级别的函数geometry.Distance,而第二个则是使用刚刚声明的Point,调用的是Point类下声明的Point.Distance方法

这种p.Distance的表达式叫做选择器,因为它会选择合适的对应p这个对象的Distance方法来执行

选择器也会被用来选择一个struct类型的字段,比如p.X。由于方法和字段都是在同一命名空间,所以如果我们在这里声明一个X方法的话,编译器会报错,因为在调用p.X时会有歧义(笔者注:这里的意思是,如果结构体里定义了名为x的字段,又在结构体外定义了绑定该结构体的方法,则会产生歧义,无法确定调用的是结构体内部的字段X还是和结构体绑定的方法X)。

因为每种类型都有其方法的命名空间,我们在用Distance这个名字的时候,不同的Distance调用指向了不同类型里的Distance方法。让我们来定义一个Path类型,这个Path代表一个线段的集合,并且也给这个Path定义一个叫Distance的方法。

// a path is a journey (路径的意思) connecting the points with straight lines
type Path []Point

// distance returns the distance traveled along the path
func (path Path) Distance() float64{
    sum := 0.0
    for i := rang path {
        if i > 0 {
         sum += path[i-1].distance(path[i])
        }
    }
    return sum
}

Path是一个命名的slice类型,而不是Point那样的struct类型,然而我们依然可以为它定义方法。在能够给任意类型定义方法这一点上,Go和很多其它的面向对象的语言不太一样(笔者注:其他OOP只能在类中定义方法,逻辑上讲,只能给对象类型定义方法)。

因此在Go语言里,我们为一些简单的数值、字符串、slice、map来定义一些附加行为很方便。我们可以给同一个包内的任意命名类型定义方法只要这个命名类型的底层类型不是指针或者interface

两个Distance方法有不同的类型。他们两个方法之间没有任何关系,尽管Path的Distance方法会在内部调用Point.Distance方法来计算每个连接邻接点的线段的长度。

让我们来调用一个新方法,计算三角形的周长:

perim := Path {
    {1, 1}
    {5, 1}
    {5, 4}
    {1, 1}
}
fmt.Println(perim.Distance())

在上面两个对Distance名字的方法的调用中,编译器会根据方法的名字以及接收器来决定具体调用的是哪一个函数。第一个例子中path[i-1]数组中的类型是Point,因此Point.Distance这个方法被调用;在第二个例子中perim的类型是Path,因此Distance调用的是Path.Distance。

对于一个给定的类型,其内部的方法都必须有唯一的方法名但是不同的类型却可以有同样的方法名(笔者注:其他OOP语言出现同样的方法名时是重载,但因为机制不一样,所以Go中为不同类型定义同名方法也可以看作是重载),比如我们这里Point和Path就都有Distance这个名字的方法。

所以我们没有必要非在方法名之前加类型名来消除歧义,比如PathDistance。这里我们已经看到了方法比之函数的一些好处:方法名可以简短。当我们在包外调用的时候这种好处就会被放大,因为我们可以使用这个短名字,而可以省略掉包的名字,下面是例子:

import "gopl.io.ch6/geometry"

perim := geometry.Path{{1, 1}, {5, 1}, {5, 4}, {1, 1}}
fmt.Println(geometry.PathDistance(perim)) // 12 function
fmt.Println(perim.Distance())             // 12 method of geometry.Path

笔者注:简短是说perim.Distance()geometry.PathDistance(perim)简短。

基于指针对象的方法

当调用一个函数时,会对其每一个参数值进行拷贝如果一个函数需要更新一个变量或者函数的其中一个参数实在太大我们希望能够避免进行这种默认的拷贝这种情况下我们就需要用到指针了。对应到我们这里用来更新接收器的对象的方法,当这个接受器变量本身比较大时,我们就可以用其指针而不是对象来声明方法,如下:

func (p *Point) ScaleBy(factor float64) {
    p.X *= factor
    p.Y *= factor
}

这个方法的名字是(*Point).ScaleBy。这里的括号是必须的;没有括号的话这个表达式可能会被理解为*(Point.ScaleBy)。

在现实的程序里,一般会约定如果Point这个类有一个指针作为接收器的方法,那么所有Point的方法都必须有一个指针接收器,即使是那些并不需要这个指针接收器的函数。我们在这里打破了这个约定只是为了展示一下两种方法的异同而已。

只有类型(Point)和指向他们的指针(*Point),才可能是出现在接收器声明里的两种接收器。此外,为了避免歧义,在声明方法时,如果一个类型名本身是一个指针的话,是不允许其出现在接收器中的,比如下面这个例子:

type P *int
func (P) f() { /* ... */ }  // compile error: invlaid receiver type

想要调用指针类型方法(*Point).ScaleBy,只要提供一个Point类型的指针即可,像下面这样。

r := &Point{1, 2} // 创建匿名对象取其地址作为指针赋值给r
r.ScaleBy(2)
fmt.Println(*r)  // {2, 4}

或者这样

p := Point{1, 2}  // 创建命名对象
pptr := &p       // 取其指针赋值给pptr 
pptr.ScaleBy(2)
fmt.Println(p)  // {2, 4}

或者这泱

p := Point{1, 2}
(&p).ScaleBy(2)  // 不创建指针变量 直接取其地址操作
fmt.Println(p)

不过后面两种方法有些笨拙。幸运的是,go语言本身在这种地方会帮到我们。如果接收器p是一个Point类型的变量,并且其方法需要一个Point指针作为接收器,我们可以用下面这种简短的写法:

p.ScaleBy(2)

编译器会隐式地帮我们用&p去调用ScaleBy这个方法这种简写方法只适用于“变量”,包括struct里的字段比如p.X,以及array和slice内的元素比如perim[0]。我们不能通过一个无法取到地址的接收器来调用指针方法,比如临时变量的内存地址就无法获取得到:

Point{1, 2}.ScaleBy(2)  // compile error: can't take address of Point literal

但是我们可以用一个*Point这样的接收器来调用Point的方法,因为我们可以通过地址来找到这个变量,只要用解引用符号*来取到该变量即可。编译器在这里也会给我们隐式地插入*这个操作符,所以下面这两种写法等价的:

pptr.Distance(q)
(*pptr).Distance(q)  // 编译器会自动给上面的代码中的pptr前加上* 只要它是一个类型变量

这里的几个例子可能让你有些困惑,所以我们总结一下:在每一个合法的方法调用表达式中,也就是下面三种情况里的任意一种情况都是可以的:

不论接收器的实际参数和其形式参数是相同与否,比如两者都是类型T或者都是类型*T:

Point{1, 2}.Distance(q)  // 
pptr.ScaleBy(2)

或者接收器实参是类型T,但接收器形参是类型*T,这种情况下编译器会隐式地为我们取变量的地址:

p.ScaleBy(2)  // implicit (&p)

或者接收器实参是类型*T,形参是类型T。编译器会隐式地为我们解引用,取到指针指向的实际变量:

pptr.Distance(q)  // implicit (*pptr)

如果命名类型T(译注:用type xxx定义的类型)的所有方法都是用T类型自己来做接收器(而不是*T),那么拷贝这种类型的实例就是安全的;调用他的任何一个方法也就会产生一个值的拷贝。比如time.Duration的这个类型,在调用其方法时就会被全部拷贝一份,包括在作为参数传入函数的时候。但是如果一个方法使用指针作为接收器你需要避免对其进行拷贝因为这样可能会破坏掉该类型内部的不变性。比如你对bytes.Buffer对象进行了拷贝,那么可能会引起原始对象和拷贝对象只是别名而已实际上它们指向的对象是一样的。紧接着对拷贝后的变量进行修改可能会有让你有意外的结果

笔者注:总结如下两点:

  1. 不关方法的接收器实参是指针类型还是命名类型,编译器都会帮你自动转换为正确的形参类型。
  2. 声明一个方法的接收器是指针类型还是命名类型时,需要考虑拷贝其值后会不会对其修改,传命名类型在修改的情况下适用,因为本质上是复制一份,互不干扰,但传指针类型时,有可能因为对其修改会影响其他引用了该指针的方法。

Nil也是一个合法的接收器类型

就像一些函数允许nil指针作为参数一样方法理论上也可以用nil指针作为其接收器尤其当nil对于对象来说是合法的零值时,比如map或者slice。在下面的简单int链表的例子里,nil代表的是空链表:

// IntList defined as the liked list of int
// a nil *IntList represents a empty LinkList

type IntList struct {
    Value int
    Tail *IntList
}

// sum returns the sum of the list elements
func (list *IntList) Sum() int {
    if list == nil {
        return 0
    }
    return list.Value + list.Tail.Sum()  // 尾递归
}

当你定义一个允许nil作为接收器值的方法的类型时,在类型前面的注释中指出nil变量代表的意义是很有必要的,就像我们上面例子里做的这样。

下面是net/url包里Values类型定义的一部分。

package url

// values maps a string key to a list of values
type Values map[string][]string

// Get returns the first value associated with the given key or "" if there are none
func (v Values) Get(key string) string {
    if vs := v[key]; len(vs) > 0 {
        return vs[0]
    }
    return ""
}

// Add adds the value to key
// it appends to any existing values associated with key
func (v Values) Add(key, value string) {
    v[key] = append(v[key], value)
}

这个定义向外部暴露了一个map的命名类型,并且提供了一些能够简单操作这个map的方法。这个map的value字段是一个string的slice,所以这个Values是一个多维map。客户端使用这个变量的时候可以使用map固有的一些操作(make,切片,m[key]等等),也可以使用这里提供的操作方法,或者两者并用,都是可以的:

m := url.Values{"lang": {"en"}}  // direct construction
m.Add("item", "1")
m.Add("item", "2")

fmt.Println(m.Get("lang"))  // en
fmt.Println(m.Get("q"))     // ""
fmt.Println(m.Get("item"))  // [1 2]

m = nil
fmt.Println(m.Get("item")) // ""
m.Add("item", 3)           // panic: assignmen to entry in nil map

对Get的最后一次调用中,nil接收器的行为即是一个空map的行为。我们可以等价地将这个操作写成Value(nil).Get(“item”),但是如果你直接写nil.Get(“item”)的话是无法通过编译的因为nil的字面量编译器无法判断其准确类型。所以相比之下,最后的那行m.Add的调用就会产生一个panic,因为他尝试更新一个空map。

由于url.Values是一个map类型,并且间接引用了其key/value对,因此url.Values.Add对这个map里的元素做任何的更新、删除操作对调用方都是可见的。实际上,就像在普通函数中一样,虽然可以通过引用来操作内部值,但在方法想要修改引用本身时是不会影响原始值的,比如把他置换为nil,或者让这个引用指向了其它的对象,调用方都不会受影响。(笔者注:传递任何参数都是拷贝值的过程,传递指针的时候也拷贝了一份指针的内存地址值到变量中,修改这个变量并不会影响原始变量).

通过嵌入结构体来扩展类型

来看看ColoredPoint这个类型:

import "image/color"

type Point struct{ X, Y float64 }

type ColoredPoint struct {
    Point
    Color color.RGBA
}

我们完全可以将ColoredPoint定义为一个有三个字段的struct,但是我们却将Point这个类型嵌入到ColoredPoint来提供X和Y这两个字段。像我们在4.4节中看到的那样,内嵌可以使我们在定义ColoredPoint时得到一种句法上的简写形式,并使其包含Point类型所具有的一切字段,然后再定义一些自己的。如果我们想要的话,我们可以直接认为通过嵌入的字段就是ColoredPoint自身的字段,而完全不需要在调用时指出Point,比如下面这样。

var cp ColoredPoint
cp.X = 1
fmt.Println(cp.Point.X)  // 1\
cp.Point.Y = 2
fmt.Println(cp.Y)

对于Point中的方法我们也有类似的用法,我们可以把ColoredPoint类型当作接收器来调用Point里的方法,即使ColoredPoint里没有声明这些方法:

red := color.RGBA{255, 0, 0, 255}
blue := color.RGBA{0, 0, 255, 255}
var p = ColoredPoint{Point{1, 1}, red}
var q = ColoredPoint{Point{5, 4}, blue}

fmt.Println(p.Distance(q.Point))  // 5
p.ScaleBy(2)
q.ScaleBy(2)
fmt.Println(p.Distance(q.Point))  // 10

Point类的方法也被引入了ColoredPoint。用这种方式,内嵌可以使我们定义字段特别多的复杂类型,我们可以将字段先按小类型分组,然后定义小类型的方法,之后再把它们组合起来。

(笔者注:作者想讲明白的主要意思是:结构体可以嵌套定义,内嵌结构体成员所有的字段及其关联的方法也都会被继承)

读者如果对基于类来实现面向对象的语言比较熟悉的话,可能会倾向于将Point看作一个基类,而ColoredPoint看作其子类或者继承类,或者将ColoredPoint看作"is a" Point类型。但这是错误的理解。请注意上面例子中对Distance方法的调用。Distance有一个参数是Point类型,但q并不是一个Point类,所以尽管q有着Point这个内嵌类型,我们也必须要显式地选择它。尝试直接传q的话你会看到下面这样的错误:

p.Distance(q)  // compile error: cannot use q (ColoredPoint) as Point

一个ColoredPoint并不是一个Point,但它"has a"Point,并且它有从Point类里引入的Distance和ScaleBy方法。如果你喜欢从实现的角度来考虑问题内嵌字段会指导编译器去生成额外的包装方法来委托已经声明好的方法,和下面的形式是等价的:

func (p ColoredPoint) Distance(q Point) float64 {
    return p.Point.Distance(q)
}

func (p *ColoredPoint) ScaleBy(factor float64) {
    p.Point.ScaleBy(factor)
}

笔者注:ColoredPoint内嵌Point之后,这两个方法由编译器自动帮你生成,而不需要手动指定。

当Point.Distance被第一个包装方法调用时,它的接收器值是p.Point,而不是p,当然了,在Point类的方法里,你是访问不到ColoredPoint的任何字段的(笔者注:即被嵌套结构体不能访问嵌套结构体的任何字段,这是合理的)。

在类型中内嵌的匿名字段也可能是一个命名类型的指针这种情况下字段和方法会被间接地引入到当前的类型中(译注:访问需要通过该指针指向的对象去取)。添加这一层间接关系让我们可以共享通用的结构并动态地改变对象之间的关系。

下面这个ColoredPoint的声明内嵌了一个*Point的指针。

type ColoredPoint struct {
    *Point
    Color color.RGBA
}

p := ColoredPoint{&Point{1, 1}, red}
q := ColoredPoint{&Point{5, 4}, blue}

fmt.Println(p.Distance(*q.Point))  // 5
q.Point = p.Point
p.ScaleBy(2)  // 指针绑定 修改会影响所有该指针指向地址的内容
fmt.Println(*p.Point, *q.Point)  // {2, 2} {2, 2}

一个struct类型也可能会有多个匿名字段。我们将ColoredPoint定义为下面这样:

type ColoredPoint struct {
    Point
    color.RGBA
}

然后这种类型的值便会拥有Point和RGBA类型的所有方法,并直接定义在ColoredPoint中的方法。

当编译器解析一个选择器到方法时,比如p.ScaleBy,它会首先去找直接定义在这个类型里的ScaleBy方法,然后找被ColoredPoint的内嵌字段们引入的方法即去找Point和RGBA的内嵌字段引入的方法,然后一直递归向下找

如果选择器有二义性的话编译器会报错,比如你在同一级里有两个同名的方法。、

**方法只能在命名类型(像Point)**或者指向命名类型的指针上定义,但是借助内嵌,我们也可以给匿名struct类型来定义方法。

下面是一个小trick。这个例子展示了简单的cache,其使用两个包级别的变量来实现,一个mutex互斥量(§9.2)和它所操作的cache:

var (
    mu sync.Mutex. // guards mapping
    mapping = make(map[string]string)
)

func Lookup(key string) string {
    mu.Lock()
    v := mapping[key]
    mu.Unlock()
    return v
}

下面这个版本在功能上是一致的,但将两个包级别的变量放在了cache这个struct一组内:

var cache = struct {
    sync.Mutex
    mapping map[string]string
} {
    mapping: make(map[string]string) 
}

func Lookup(key string) string {
    cache.Lock()
    v := cache.mapping[key]
    cache.Unlock()
    return v
}

我们给新的变量起了一个更具表达性的名字:cache。因为sync.Mutex字段也被嵌入到了这个struct里,其Lock和Unlock方法也就都被引入到了这个匿名结构中了,这让我们能够以一个简单明了的语法来对其进行加锁解锁操作。

方法值和方法表达式

我们经常选择一个方法(笔者注:即通过选择器选择方法,请联系上下文理解),并且在同一个表达式里执行,比如常见的p.Distance()形式,实际上将其分成两步来执行也是可能的。p.Distance叫作“选择器”选择器会返回一个方法值"->**一个将方法(Point.Distance)绑定到特定接收器变量的函数。**这个函数可以不通过指定其接收器即可被调用;即调用时不需要指定接收器(因为方法在定义是已经指定接收器了,事实上方法和函数的区别就在于有没有指定接收器),只要传入函数的参数即可:

p := Point{1, 2}
q := Point{4, 6}

distanceFromP := p.Distance    // method value
fmt.Println(distanceFromP(q))   // 5
var origin Point              // {0, 0}
fmt.Println(distanceFromP(origin))  // 2.23606797749979, sqrt(5)

scaleP := p.ScaleBy  // method value
scaleP(2)  // 2, 4
scaleP(3)  // 6, 12
scaleP(10)  // 60, 120

在一个包的API需要一个函数值并且调用方希望操作的是某一个绑定了对象的方法的话,方法值会非常实用。

举例来说,下面例子中的time.AfterFunc这个函数的功能是在指定的延迟时间之后来执行一个函数。且这个函数操作的是一个Rocket对象r。

type Rocket struct { /* ... */ }
func (r *Rocket) Launch() { /* ... */ }
r := new(Rocket)
time.AfterFunc(10 * time.Second, func() {r.Launch()})

直接用方法值传入AfterFunc的话可以更为简短:

time.AfterFunc(10 * time.Second, func() { r.Launch() })
time.AfterFunc(10 * time.Second, r.Launch) // 上下等价

和方法值相关的还有方法表达式。当调用一个方法时,与调用一个普通的函数相比我们必须要用选择器(p.Distance)语法来指定方法的接收器

当T是一个类型时,方法表达式可能会写作T.f或者(*T).f,会返回一个函数值这种函数会将其第一个参数用作接收器所以可以用通常(省略选择器)的方式来对其进行调用

p := Point{1, 2}
q := Point{4, 6}

distance = Point.Distance  // method expression 方法值赋值给变量的表达式即为方法表达式
fmt.Println(distance(p, q))  // 5
fmt.Println("%T\n", distance)  // func(Point, Point) float64

// Distance是指前面定义好的方法,其指定Point对象作为接收器
// 即 func (p Point) Distance() 它只有一个参数
// 但 distance(即Point.Distance)却接收了两个参数
// 其中一个参数p即为接收器

当你根据一个变量来决定调用同一个类型的哪个函数时,方法表达式就显得很有用了。你可以根据选择来调用接收器各不相同的方法

type Point struct{ X, Y float64 }

func (p Point) Add(q Point) Point {return Point{p.X + q.X, P.Y + q.Y}}
func (p Point) Sub(q Point) Point {return Point{p.X - q.X, p.Y - q.Y}}

type Path []Point

func (path Path) TranslateBy(offset Point, add bool) {
    var op func(p, q Point) Point  // op是一个函数值变量
    if add {
        op = Point.Add  // 使用方法表达式给函数值变量赋值 函数值就转化为了方法值 默认2jiang函数的第一个参数被指定为接收器 下同
    } else {
        op = Point.Sub
    }
    for i := range path {
        // call path[i].Add(offset) or path[i].Sub(offset)
        path[i] = op(path[i], offset) // path[i]用作接收器
    }
}

示例:Bit数组

Go语言里的集合(即set)一般会用map[T]bool这种形式来表示T代表元素类型。例如在数据流分析领域,集合元素通常是一个非负整数,集合会包含很多元素,并且集合会经常进行并集、交集操作,这种情况下,bit数组会比map表现更加理想。(译注:这里再补充一个例子,比如我们执行一个http下载任务,把文件按照16kb一块划分为很多块,需要有一个全局变量来标识哪些块下载完成了,这种时候也需要用到bit数组)

一个bit数组通常会用一个无符号数或者称之为“字”的slice来表示,每一个元素的每一位都表示集合里的一个值。当集合的第i位被设置时,我们才说这个集合包含元素i。下面的这个程序展示了一个简单的bit数组类型,并且实现了三个函数来对这个bit数组来进行操作:

// An IntSet is a set of small non-negative integers
// Its zeros value represents the empty set

type IntSet struct {
    words []uint64
}

// reports whether the set contains elem x or not
func (s IntSet) Has(x int) bool {
    word, bit := x/64, uint(x%64) 
    // /64 等价于 右移6位 得到x对应bit数组中的索引
    // %64 等价于 取前6位 作为x应该在bit元素的位置
    return word < len(s.words) && s.words[word]&(1 << bit) != 0
    // word < len(s.words) 表示word在bit数组能表示的范围内 6位内
    // s.words[word]取出对应的bit元素 1 << bit 得到x应该在bit元素中的二进制表示的位置 或者说得到其标志位flag
    // 如果两者相与等于1 则证明该元素存在
}

// adds an non-negative value x to the set
func (s *IntSet) Add(x int) {
    word, bit := x/64, x%64
    for word >= len(s.words) {
        s.words = appned(s.words, 0)
    }
    s.words[word] |= 1 << bit
}


// sets s the union of s and t
func (s *IntSet) UnionWorh(t *IntSet) {
    for i, tword := range t.words {
        if i < len(s.words) {
            s.words[i] |= tword
        } else {
            s.words = append(s.words, tword)
        }
    }
}

因为每一个字都有64个二进制位,所以为了定位x的bit位,我们用了x/64的商作为字的下标,并且用x%64得到的值作为这个字内的bit的所在位置。UnionWith这个方法里用到了bit位的“或”逻辑操作符号|来一次完成64个元素的或计算。

当前这个实现还缺少了很多必要的特性,下面我们将IntSet作为一个字符串来打印。这里我们来实现它,让我们来给上面的例子添加一个String方法:

// returns the set as a string of the form like {1, 2, 3}
func(s *IntSet) String() {
    var buf bytes.Buffer
    buf.WriteByte('{')
    for i, word := range s.words {
        if word == 0 {
            continue
        }
        for j := 0; j < 64; j++ {
            if word &(1 << unit(j)) != 0 {
                if buf.Len() > len("{") {
                    buf.WriteByte(' ')
                }
                fmt.Fprintf(&buf, "%d", 64*i+j)
            }
        } 
    }
    buf.Writebyte('}')
    return buf.String()
}

这里留意一下String方法,是不是和3.5.4节中的intsToString方法很相似;bytes.Buffer在String方法里经常这么用。当你为一个复杂的类型定义了一个String方法时,fmt包就会特殊对待这种类型的值,这样可以让这些类型在打印的时候看起来更加友好,而不是直接打印其原始的值。fmt会直接调用用户定义的String方法这种机制依赖于接口和类型断言,在第7章中我们会详细介绍。

(笔者注:这也是为什么官方推荐使用fmt.Print系列函数而不是print系列函数的原因,如果一个复杂类型定义了String方法,是用不带fmt的打印方法是无法打印预期值的。)

现在我们就可以在实战中直接用上面定义好的IntSet了:

var x, y IntSet

x.Add(1)
x.Add(144)
x.Add(9)
fmt.Println(x.String()) // {1 9 144}

y.Add(9)
y.Add(42)
fmt.Println(y.String()) // {9 42}

x.UnionWith(&y)
fmt.Println(x.String()) // {1 9 42 144}
fmt.Println(x.Has(9), x.Has(123)) // true false

这里要注意:我们声明的String和Has两个方法都是以指针类型*IntSet来作为接收器的,但实际上对于这两个类型来说,把接收器声明为指针类型也没什么必要。不过另外两个函数就不是这样了,因为另外两个函数操作的是s.words对象,如果你不把接收器声明为指针对象,那么实际操作的是拷贝对象,而不是原来的那个对象。但也由于我们的String方法定义在IntSet指针上,所以当我们的变量是IntSet类型而不是IntSet指针时,可能会有下面这样让人意外的情况:

fmt.Println(&x)        // {1 9 42 144} fmt会最大自动调用String()方法打印 同下
fmt.Println(x.String()) // {1 9 42 144}
fmt.Println(x)         // {[4398046511618 0 65536]} 猜测是x的实际值即内存地址

在第一个Println中,我们打印一个*IntSet的指针,这个类型的指针确实有自定义的String方法。第二Println,我们直接调用了x变量的String()方法;这种情况下编译器会隐式地在x前插入&操作符,这样相当于我们还是调用的IntSet指针的String方法。在第三个Println中,因为IntSet类型没有String方法,所以Println方法会直接以原始的方式理解并打印。所以在这种情况下&符号是不能忘的。在我们这种场景下,你把String方法绑定到IntSet对象上,而不是IntSet指针上可能会更合适一些,不过这也需要具体问题具体分析。

封装

一个对象的变量或者方法如果对调用方是不可见的话一般就被定义为“封装”封装有时候也被叫做信息隐藏,同时也是面向对象编程最关键的一个方面。

(笔者注:面向对象有三大特性:封装、继承、多态)

Go语言只有一种控制可见性的手段大写首字母的标识符会从定义它们的包中被导出小写字母的则不会这种限制包内成员的方式同样适用于struct或者一个类型的方法因而如果我们想要封装一个对象,我们必须将其定义为一个struct

这也就是前面的小节中IntSet被定义为struct类型的原因,尽管它只有一个字段:

type IntSet struct {
    words []uint64
}

当然,我们也可以把IntSet定义为一个slice类型,但这样我们就需要把代码中所有方法里用到的s.words用*s替换掉了:

type IntSet []uint64

尽管这个版本的IntSet在本质上是一样的,但它也允许其它包中可以直接读取并编辑这个slice。换句话说,相对于*s这个表达式会出现在所有的包中,s.words只会在定义IntSet的包中出现。

这种基于名字的方法使得在语言中最小的封装单元是package而不是像其它语言一样的类型一个struct类型的字段对同一个包的所有代码都有可见性无论你的代码是写在一个函数还是一个方法里

封装提供了三方面的优点:
1. 第一,因为调用方不能直接修改对象的变量值,其只需要关注少量的语句并且只要弄懂少量变量的可能的值即可。
2. 第二,隐藏实现的细节,可以防止调用方依赖那些可能变化的具体实现,这样使设计包的程序员在不破坏对外的api情况下能得到更大的自由。
3. 第三,也是最重要的优点,是阻止了外部调用方对对象内部的值任意地进行修改。

把bytes.Buffer这个类型作为例子来考虑。这个类型在做短字符串叠加的时候很常用,所以在设计的时候可以做一些预先的优化,比如提前预留一部分空间,来避免反复的内存分配。又因为Buffer是一个struct类型,这些额外的空间可以用附加的字节数组来保存,且放在一个小写字母开头的字段中。这样在外部的调用方只能看到性能的提升,但并不会得到这个附加变量。Buffer和其增长算法我们列在这里,为了简洁性稍微做了一些精简:

// 这个例子是为了说明前两个优点

type Buffer struct {
    buf     []byte
    initial [64]byte
    /* ... */
}

// expands the buffer's capacity, if necessary
// to guarantee space for another n bytes. [...]
func (b *Buffer) Grow(n int) {
    if b.buf == nil {
        b.buf = b.initial[:0] // use preallocated space initially 取切片是因为buf是切片类型 
    }
    if len(b.buf) + n > cap(b.buf) {
        buf := make([]byte, b.len(), 2*Cap(b.buf))  // 创建了一个新的切片 两倍容量
        copy(buf, b.buf)  // 旧切片数据复制到新切片哈桑
        b.buf = buf
    }
}

封装的第三个优点也是最重要的优点是阻止了外部调用方对对象内部的值任意地进行修改因为对象内部变量只可以被同一个包内的函数修改所以包的作者可以让这些函数确保对象内部的一些值的不变性

比如下面的Counter类型允许调用方来增加counter变量的值,并且允许将这个值reset为0,但是不允许随便设置这个值。

type Counter struct { n int }
func (c *Counter) N() int { return c.n }
func (c *Counter) Increment() { c.n++ }
func (c *Counter) Reset() { c.n = 0}

(笔者注:在这个例子中,你只能按照api提供方定义的方法来操作Counter,而不能随意修改它,这确切的讲是封装提供了一定程度的安全性,即针对对象的所有修改都是使用提供的方法进行的,这些方法由于是api定义的所以能保证调用方不能随意进行修改)

只用来访问或修改内部变量的函数被称为setter或者getter(典型的例子是Java),例子如下,比如log包里的Logger类型对应的一些函数。在命名一个getter方法时,我们通常会省略掉前面的Get前缀。这种简洁上的偏好也可以推广到各种类型的前缀比如Fetch,Find或者Lookup。

package log

type Logger struct {
    flags  int
    prefix string
    // ...
}

func (l *Logger) Flags() int   // getter
func (l *Logger) SetFlags(flag int)  // setter
func (l *Logger) Prefix() string  // getter
func (l *Logger) SetPrefix(prefix string)  // setter

Go的编码风格不禁止直接导出字段。当然,一旦进行了导出,就没有办法在保证API兼容的情况下去除对其的导出所以在一开始的选择一定要经过深思熟虑并且要考虑到包内部的一些不变量的保证,未来可能的变化,以及调用方的代码质量是否会因为包的一点修改而变差

封装并不总是理想的。 虽然封装在有些情况是必要的,但有时候我们也需要暴露一些内部内容,比如:time.Duration将其表现暴露为一个int64数字的纳秒,使得我们可以用一般的数值操作来对时间进行对比,甚至可以定义这种类型的常量:

const day = 24 * time.Hour
fmt.Println(day.Seconds())  // 86400

另一个例子,将IntSet和本章开头的geometry.Path进行对比。Path被定义为一个slice类型,这允许其调用slice的字面方法来对其内部的points用range进行迭代遍历;在这一点上,IntSet是没有办法让你这么做的。

这两种类型决定性的不同:geometry.Path的本质是一个坐标点的序列,不多也不少,我们可以预见到之后也并不会给他增加额外的字段,所以在geometry包中将Path暴露为一个slice。相比之下,IntSet仅仅是在这里用了一个[]uint64的slice。这个类型还可以用[]uint类型来表示,或者我们甚至可以用其它完全不同的占用更小内存空间的东西来表示这个集合,所以我们可能还会需要额外的字段来在这个类型中记录元素的个数。也正是因为这些原因,我们让IntSet对调用方不透明。

在这章中,我们学到了如何将方法与命名类型进行组合,并且知道了如何调用这些方法。尽管方法对于OOP编程来说至关重要,但他们只是OOP编程里的半边天。为了完成OOP,我们还需要接口

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值