Go 语言:如何利用好 TDD 学习指针并了解 Golang 中的 error 处理
Wallet(钱包)
结构体,我们可以利用它存放 Bitcoin(比特币)
首先写测试
func TestWallet(t *testing.T) { wallet := Wallet{} wallet.Deposit(10) got := wallet.Balance()
want := 10 if got != want {
t.Errorf("got %d want %d", got, want)
}
}
在前面的示例中,我们直接使用字段名称访问字段,但是在 非常强调安全性的钱包 中,我们不想暴露自己的内部状态,而是通过方法来控制访问的权限。
尝试运行测试
./wallet_test.go:7:12: undefined: Wallet
为测试的运行编写最少量的代码并检查失败测试的输出
编译器不知道 Wallet
是什么,所以让我们告诉它。
type Wallet struct { }
现在我们已经生成了自己的钱包,尝试再次运行测试
./wallet_test.go:9:8: wallet.Deposit undefined (type Wallet has no field or method Deposit)
./wallet_test.go:11:15: wallet.Balance undefined (type Wallet has no field or method Balance)
func (w Wallet) Deposit(amount int) { } func (w Wallet) Balance() int {
return 0
}
测试现在应该编译通过了,然后运行
wallet_test.go:15: got 0 want 10
编写足够的代码使其通过
结构中需要一些 balance(余额)
变量来存储状态
type Wallet struct {
balance int
}
balance
func (w Wallet) Deposit(amount int) {
w.balance += amount
} func (w Wallet) Balance() int {
return w.balance
}
现在我们的事业在金融科技的保护下,将会运行并轻松的通过测试
wallet_test.go:15: got 0 want 10
为什么报错了?
这让人很困惑,我们的代码看上去没问题,我们在余额中添加了新的金额,然后余额的方法应该返回它当前的状态值。
在 Go 中,当调用一个函数或方法时,参数会被复制。
当调用 func (w Wallet) Deposit(amount int)
时,w
是来自我们调用方法的副本。
不需要太过计算机化,当你创建一个值,例如一个 wallet
,它就会被存储在内存的某处。你可以用 &myval
找到那块内存的地址。
通过在代码中添加一些 prints
来试验一下
func TestWallet(t *testing.T) { wallet := Wallet{} wallet.Deposit(10) got := wallet.Balance() fmt.Println("address of balance in test is", &wallet.balance) want := 10 if got != want {
t.Errorf("got %d want %d", got, want)
}
}
func (w Wallet) Deposit(amount int) {
fmt.Println("address of balance in Deposit is", &w.balance)
w.balance += amount
}
现在重新运行测试
balance
的地址是不同的。balance
的值时,我们处理的是来自测试的副本。因此,balance
在测试中没有被改变。func (w *Wallet) Deposit(amount int) {
w.balance += amount
} func (w *Wallet) Balance() int {
return w.balance
}
*Wallet
而不是 Wallet
,你可以将其解读为「指向 wallet
的指针」。重构
我们曾说过我们正在制做一个比特币钱包,但到目前为止我们还没有提到它们。我们一直在使用 int
,因为当用来计数时它是不错的类型!
为此创建一个结构体似乎有点过头了。就 int
的表现来说已经很好了,但问题是它不具有描述性。
Go 允许从现有的类型创建新的类型。
语法是 type MyName OriginalType
type Bitcoin int type Wallet struct {
balance Bitcoin
} func (w *Wallet) Deposit(amount Bitcoin) {
w.balance += amount
} func (w *Wallet) Balance() Bitcoin {
return w.balance
}
func TestWallet(t *testing.T) { wallet := Wallet{} wallet.Deposit(Bitcoin(10)) got := wallet.Balance() want := Bitcoin(10) if got != want {
t.Errorf("got %d want %d", got, want)
}
}
要生成 Bitcoin(比特币)
,你只需要用 Bitcoin(999)
的语法就可以了。
类型别名有一个有趣的特性,你还可以对它们声明 方法。当你希望在现有类型之上添加一些领域内特定的功能时,这将非常有用。
type Stringer interface {
String() string
}
这个接口是在 fmt
包中定义的。当使用 %s
打印格式化的字符串时,你可以定义此类型的打印方式。
func (b Bitcoin) String() string {
return fmt.Sprintf("%d BTC", b)
}
如你所见,在类型别名上创建方法的语法与结构上的语法相同。
接下来,我们需要更新测试中的格式化字符串,以便它们将使用 String()
方法。
if got != want {
t.Errorf("got %s want %s", got, want)
}
为了看到这一点,故意令测试失败我们就能看到
wallet_test.go:18: got 10 BTC want 20 BTC
这使得我们的测试更加清晰。
下一个需求是 Withdraw(提取)
函数。
先写测试
几乎跟 Deposit()
相反
func TestWallet(t *testing.T) { t.Run("Deposit", func(t *testing.T) {
wallet := Wallet{} wallet.Deposit(Bitcoin(10)) got := wallet.Balance() want := Bitcoin(10) if got != want {
t.Errorf("got %s want %s", got, want)
}
}) t.Run("Withdraw", func(t *testing.T) {
wallet := Wallet{balance: Bitcoin(20)} wallet.Withdraw(10) got := wallet.Balance() want := Bitcoin(10) if got != want {
t.Errorf("got %s want %s", got, want)
}
}) }
尝试运行测试
./wallet_test.go:26:9: wallet.Withdraw undefined (type Wallet has no field or method Withdraw)
为测试的运行编写最少量的代码并检查失败测试的输出
func (w *Wallet) Withdraw(amount Bitcoin) { }
wallet_test.go:33: got 20 BTC want 10 BTC
编写足够的代码使其通过
func (w *Wallet) Withdraw(amount Bitcoin) {
w.balance -= amount
}
重构
func TestWallet(t *testing.T) { assertBalance := func(t *testing.T, wallet Wallet, want Bitcoin) {
got := wallet.Balance() if got != want {
t.Errorf("got %s want %s", got, want)
}
} t.Run("Deposit", func(t *testing.T) {
wallet := Wallet{}
wallet.Deposit(Bitcoin(10))
assertBalance(t, wallet, Bitcoin(10))
}) t.Run("Withdraw", func(t *testing.T) {
wallet := Wallet{balance: Bitcoin(20)}
wallet.Withdraw(Bitcoin(10))
assertBalance(t, wallet, Bitcoin(10))
}) }
如果你试图从账户中取出更多的钱,会发生什么?目前,我们的要求是假定没有透支设备。
我们如何在使用 Withdraw
时标记出现的问题呢?
在 Go 中,如果你想指出一个错误,通常你的函数要返回一个 err
,以便调用者检查并执行相应操作。
让我们在测试中试试。
先写测试
t.Run("Withdraw insufficient funds", func(t *testing.T) {
startingBalance := Bitcoin(20)
wallet := Wallet{startingBalance}
err := wallet.Withdraw(Bitcoin(100)) assertBalance(t, wallet, startingBalance) if err == nil {
t.Error("wanted an error but didn't get one")
}
})
如果 你尝试取出超过你余额的比特币,我们想让 Withdraw
返回一个错误,而余额应该保持不变。
然后,如果测试失败,我们检查错误是否为 nil
nil
是其他编程语言的 null
。错误可以是 nil
,因为返回类型是 error
,这是一个接口。
如果你看到一个函数,它接受参数或返回值的类型是接口,它们就可以是 nil
。
如果你尝试访问一个值为 nil
的值,它将会引发 运行时的 panic。这很糟糕!你应该确保你检查了 nil
的值。
尝试运行测试
./wallet_test.go:31:25: wallet.Withdraw(Bitcoin(100)) used as value
错误信息可能不太清楚,但我们之前对于 Withdraw
的意图只是调用它,它永远不会返回一个值。
为了使它编译通过,我们需要更改它,以便它有一个返回类型。
为测试的运行编写最少量的代码并检查失败测试的输出
func (w *Wallet) Withdraw(amount Bitcoin) error {
w.balance -= amount
return nil
}
再次强调,编写足够的代码来满足编译器的要求是非常重要的。
我们纠正了自己的 Withdraw
方法返回 error
,现在我们必须返回 一些东西,所以我们就返回 nil
好了。
编写足够的代码使其通过
func (w *Wallet) Withdraw(amount Bitcoin) error { if amount > w.balance {
return errors.New("oh no")
} w.balance -= amount
return nil
}
记住要将 errors
导入到代码中。
errors.New
创建了一个新的 error
,并带有你选择的消息。
重构
让我们为错误检查做一个快速测试的助手方法,以帮助我们的测试读起来更清晰。
assertError := func(t *testing.T, err error) {
if err == nil {
t.Error("wanted an error but didnt get one")
}
}
并且在我们的测试中
t.Run("Withdraw insufficient funds", func(t *testing.T) {
wallet := Wallet{Bitcoin(20)}
err := wallet.Withdraw(Bitcoin(100)) assertBalance(t, wallet, Bitcoin(20))
assertError(t, err)
})
希望在返回「oh no」的错误时,你会认为我们可能会迭代这个问题,因为它作为返回值看起来没什么用。
假设错误最终会返回给用户,让我们更新测试以断言某种错误消息,而不只是让错误存在。
先写测试
更新一个 string
的助手方法来比较。
assertError := func(t *testing.T, got error, want string) {
if got == nil {
t.Fatal("didn't get an error but wanted one")
} if got.Error() != want {
t.Errorf("got '%s', want '%s'", got, want)
}
}
同时再更新调用者
t.Run("Withdraw insufficient funds", func(t *testing.T) {
startingBalance := Bitcoin(20)
wallet := Wallet{startingBalance}
err := wallet.Withdraw(Bitcoin(100)) assertBalance(t, wallet, startingBalance)
assertError(t, err, "cannot withdraw, insufficient funds")
})
我们已经介绍了 t.Fatal
。如果它被调用,它将停止测试。这是因为我们不希望对返回的错误进行更多断言。
如果没有这个,测试将继续进行下一步,并且因为一个空指针而引起 panic
尝试运行测试
wallet_test.go:61: got err 'oh no' want 'cannot withdraw, insufficient funds'
编写足够的代码使其通过
func (w *Wallet) Withdraw(amount Bitcoin) error { if amount > w.balance {
return errors.New("cannot withdraw, insufficient funds")
} w.balance -= amount
return nil
}
重构
我们在测试代码和 Withdraw
代码中都有重复的错误消息
如果有人想要重新定义这个错误,那么测试就会失败,这将是非常恼人的,而对于我们的测试来说,这里有太多的细节了。
我们并不关心具体的措辞是什么,只是在给定条件的情况下返回一些有意义的错误。
在 Go 中,错误是值,因此我们可以将其重构为一个变量,并为其提供一个单一的事实来源。
var InsufficientFundsError = errors.New("cannot withdraw, insufficient funds") func (w *Wallet) Withdraw(amount Bitcoin) error { if amount > w.balance {
return InsufficientFundsError
} w.balance -= amount
return nil
}
var
关键字允许我们定义包的全局值。Withdraw
函数看起来很清晰。func TestWallet(t *testing.T) { t.Run("Deposit", func(t *testing.T) {
wallet := Wallet{}
wallet.Deposit(Bitcoin(10))
assertBalance(t, wallet, Bitcoin(10))
}) t.Run("Withdraw with funds", func(t *testing.T) {
wallet := Wallet{Bitcoin(20)}
wallet.Withdraw(Bitcoin(10))
assertBalance(t, wallet, Bitcoin(10))
}) t.Run("Withdraw insufficient funds", func(t *testing.T) {
wallet := Wallet{Bitcoin(20)}
err := wallet.Withdraw(Bitcoin(100)) assertBalance(t, wallet, Bitcoin(20))
assertError(t, err, InsufficientFundsError)
})
} func assertBalance(t *testing.T, wallet Wallet, want Bitcoin) {
got := wallet.Balance() if got != want {
t.Errorf("got '%s' want '%s'", got, want)
}
} func assertError(t *testing.T, got error, want error) {
if got == nil {
t.Fatal("didn't get an error but wanted one")
} if got != want {
t.Errorf("got '%s', want '%s'", got, want)
}
}
InsufficientFundsError 进行相等的检查,并采取相应的操作
未经检查的错误
虽然 Go 编译器对你有很大帮助,但有时你仍然会忽略一些事情,错误处理有时会很棘手。
有一种情况我们还没有测试过。要找到它,在一个终端中运行以下命令来安装 errcheck
,这是许多可用的 linters(代码检测工具)之一。
go get -u github.com/kisielk/errcheck
然后,在你的代码目录中运行 errcheck .
你应该会得到如下类似的内容:
wallet_test.go:17:18: wallet.Withdraw(Bitcoin(10))
这告诉我们的是,我们没有检查在代码行中返回的错误。
我的计算机上的这行代码与我们的正常 withdraw
的场景相对应,因为我们没有检查 Withdraw
是否成功,因此没有返回错误
最终的测试代码
func TestWallet(t *testing.T) { t.Run("Deposit", func(t *testing.T) {
wallet := Wallet{}
wallet.Deposit(Bitcoin(10)) assertBalance(t, wallet, Bitcoin(10))
}) t.Run("Withdraw with funds", func(t *testing.T) {
wallet := Wallet{Bitcoin(20)}
err := wallet.Withdraw(Bitcoin(10)) assertBalance(t, wallet, Bitcoin(10))
assertNoError(t, err)
}) t.Run("Withdraw insufficient funds", func(t *testing.T) {
wallet := Wallet{Bitcoin(20)}
err := wallet.Withdraw(Bitcoin(100)) assertBalance(t, wallet, Bitcoin(20))
assertError(t, err, InsufficientFundsError)
})
} func assertBalance(t *testing.T, wallet Wallet, want Bitcoin) {
got := wallet.Balance() if got != want {
t.Errorf("got %s want %s", got, want)
}
} func assertNoError(t *testing.T, got error) {
if got != nil {
t.Fatal("got an error but didnt want one")
}
} func assertError(t *testing.T, got error, want error) {
if got == nil {
t.Fatal("didn't get an error but wanted one")
} if got != want {
t.Errorf("got %s, want %s", got, want)
}
}
总结
指针
- 当你传值给函数或方法时,Go 会复制这些值。因此,如果你写的函数需要更改状态,你就需要用指针指向你想要更改的值
- Go 取值的副本在大多数时候是有效的,但是有时候你不希望你的系统只使用副本,在这种情况下你需要传递一个引用。例如,非常庞大的数据或者你只想有一个实例(比如数据库连接池)
- 指针可以是 nil
- 当函数返回一个的指针,你需要确保检查过它是否为 nil,否则你可能会抛出一个执行异常,编译器在这里不能帮到你
- 错误是在调用函数或方法时表示失败的
- 通过测试我们得出结论,在错误中检查字符串会导致测试不稳定。因此,我们用一个有意义的值重构了,这样就更容易测试代码,同时对于我们 API 的用户来说也更简单。
- 错误处理的故事远远还没有结束,你可以做更复杂的事情,这里只是抛砖引玉。后面的部分将介绍更多的策略。
- 用于为值添加更多的领域内特定的含义
- 可以让你实现接口
指针和错误是 Go 开发中重要的组成部分,你需要适应这些。幸运的是,如果你做错了,编译器通常会帮你解决问题,你只需要花点时间读一下错误信息。
Go 语言:如何利用好 TDD 学习指针并了解 Golang 中的 error 处理的更多相关文章
- .Net语言 APP开发平台——Smobiler学习日志:在应用中添加WeiXin组件
最前面的话:Smobiler是一个在VS环境中使用.Net语言来开发APP的开发平台,也许比Xamarin更方便 控件说明 WeiXin组件. 效果演示 1. 分享好友 2. 分享朋友圈 图1 图2 ...
- go语言学习--指针的理解
Go 的原生数据类型可以分为基本类型和高级类型,基本类型主要包含 string, bool, int 及 float 系列,高级类型包含 struct,array/slice,map,chan, fu ...
- Python+selenium测试环境成功搭建,简单控制浏览器(firefox)接下来,继续学习其他浏览器上的测试环境搭建;学习Python语言,利用Python语言来写测试用例。加油!!!
Python+selenium测试环境成功搭建,简单控制浏览器(firefox)接下来,继续学习其他浏览器上的测试环境搭建:学习Python语言,利用Python语言来写测试用例.加油!!!
- [Go语言]从Docker源码学习Go——指针和Structs
这两天在看reflect这个包在Docker中的使用时,遇到了各种问题,最后虽然知道怎么用了. 但是对于这块的原理还不是太懂,于是把"THE WAY TO GO"中关键的几章看了下 ...
- 动态可视化 数据可视化之魅D3,Processing,pandas数据分析,科学计算包Numpy,可视化包Matplotlib,Matlab语言可视化的工作,Matlab没有指针和引用是个大问题
动态可视化 数据可视化之魅D3,Processing,pandas数据分析,科学计算包Numpy,可视化包Matplotlib,Matlab语言可视化的工作,Matlab没有指针和引用是个大问题 D3 ...
- 转 利用 Console 来学习、调试JavaScript
利用 Console 来学习.调试JavaScript 一 什么是 Console Console 是用于显示 JS和 DOM 对象信息的单独窗口.并且向 JS 中注入1个 console 对象 ...
- 20165312 C语言基础调查和JAVA学习展望
C语言基础调查和JAVA学习展望 一.有关学习技能的经历 掌握一项技能,我认为最重要的是练习和认真程度. 我在上幼儿园的时候学过电子琴,上台表演过多次,但是三四年之后就半途而废了,后来小学毕业之后对钢 ...
- C语言复习:字符串和一级指针
字符串基本操作 字符数组初始化方法 int main() { //1 {}号法 初始化列表 //数组初始化有2种方法 默认元素个数.指定元素个数 char buf1[] = { ...
- 从实例学习 Go 语言、"基础与进阶" 学习笔记及心得体会、Go指南
第一轮学习 golang "基础与进阶"学习笔记,Go指南练习题目解析.使用学习资料 <Go-zh/tour tour>.记录我认为会比较容易忘记的知识点,进行补充,整 ...
- 【C语言入门教程】4.6 指针 和 数组
数组在内存中以顺序的形式存放,数组的第一个存储单元的地址即数组的首地址.对一维数组来说,直接引用数组名就能获得该数组的首地址.指针变量可以存放于其内容相同的数组首地址,也可以指向某一具体的数组元素.通 ...
随机推荐
- 【七侠传】冲刺阶段--Day2
[七侠传]冲刺阶段--Day2 团队成员 20181221曾宇涛 20181202李祎铭 20181209沙桐 20181215薛胜瀚 20181216杨越麒 20181223何家豪 20181232 ...
- Django启动时提示ModuleNotFoundError: No module named 'xxx'的原因
①创建项目:django-admin startproject DL ②创建app:python manage.py startapp myapp ③启动服务:python manage.py run ...
- springboot修改默认端口
方案一: src/main/resuorces 文件夹下新建application.properties 文件 并添加内容server.port=8011即可 方案二: 使用EmbeddedServl ...
- CSS手册
3. CSS背景 1. 颜色 body {background-color:#b0c4de;} 十六进制 - 如:"#ff0000" RGB - 如:"rgb(255,0 ...
- 第15章 授权:保护您的应用程序(ASP.NET Core in Action, 2nd Edition)
本章包括 使用授权控制谁可以使用你的应用 对策略使用基于声明的授权 创建自定义策略以处理复杂的需求 根据所访问的资源授权请求 隐藏用户未经授权访问的Razor模板中的元素 在第14章中,我向您展示了如 ...
- vue-封装组件-结合vant实现点击按钮弹出泡泡(Popover)事件控制多个泡泡出现时,弹出对应的泡泡
<template> <div class="sale-share-box"> <span class="sale-share-btn&qu ...
- 面向对象ooDay8
精华笔记: 接口: 是一种数据类型(引用类型) 由interface定义 只能包含常量和抽象方法(所有数据默认都是常量,所有方法默认都是抽象的) 接口不能被实例化 接口是需要被实现/继承的,实现/派生 ...
- python——pkl文件
pkl文件是python里面保存文件的一种格式,如果直接打开会显示一堆序列化的东西. cPickle在python3中更名为pickle 使用方式如下: import pickle as p shop ...
- sql server 计算时间差的一部分函数【转】
在做Sql Server开发的时候有时需要获取表中今天.昨天.本周.上周.本月.上月等数据,这时候就需要使用DATEDIFF()函数及GetDate()函数了.DATEDIFF ( datepart ...
- 【基础知识】C++算法基础(快速排序)
快速排序: 1.执行流程(一趟快排): 2.一趟快排的结果:获得一个枢纽,在此左边皆小于此数,在此右边皆大于此数,因此可以继续使用递归获得最终的序列.