## 调用REST API
为REST API编写客户端不仅可以帮助你更好地理解相关API,还可以为使用该API的所有应用程序提供有用的工具。本节将探索构建客户端并展示一些在日常开发中可以使用的策略。
本节我们假设身份验证由基本auth处理,同时也支持token令牌。为简单起见,假设我们的API公开了一个端点GetGoogle(),该端点将执行GET获得的状态码返回给https//www.google.com。
### 实践
1. 建立 client.go:
```
package rest
import "net/http"
// APIClient是我们自定义的client
type APIClient struct {
*http.Client
}
// NewAPIClient 使用自定义的Transport初始化client
func NewAPIClient(username, password string) *APIClient {
t := http.Transport{}
return &APIClient{
Client: &http.Client{
Transport: &APITransport{
Transport: &t,
username: username,
password: password,
},
},
}
}
// GetGoogle 是一个API调用 我们抽象出API操作
func (c *APIClient) GetGoogle() (int, error) {
resp, err := c.Get("http://www.google.com")
if err != nil {
return 0, err
}
return resp.StatusCode, nil
}
```
2. 建立 transport.go:
```
package rest
import "net/http"
// APITransport 为每个请求执行SetBasicAuth函数
// 实现了RoundTripper接口
type APITransport struct {
*http.Transport
username, password string
}
// RoundTrip 在默认传输之前添加基础的auth
func (t *APITransport) RoundTrip(req *http.Request) (*http.Response, error) {
req.SetBasicAuth(t.username, t.password)
return t.Transport.RoundTrip(req)
}
```
3. 建立 exec.go:
```
package rest
import "fmt"
// Exec 创建API客户端并使用其GetGoogle方法,然后打印结果
func Exec() error {
c := NewAPIClient("username", "password")
StatusCode, err := c.GetGoogle()
if err != nil {
return err
}
fmt.Println("Result of GetGoogle:", StatusCode)
return nil
}
```
4. 建立 main.go:
```
package main
import "github.com/agtorre/go-cookbook/chapter6/rest"
func main() {
if err := rest.Exec(); err != nil {
panic(err)
}
}
```
5. 这会输出:
```
Result of GetGoogle: 200
```
### 说明
本节演示了如何使用Transport接口隐藏诸如身份验证,令牌刷新等逻辑。它还演示了通过方法公开API调用。 如果我们需要实现用户API这样的东西,可以考虑:
```
type API interface{
GetUsers() (Users, error)
CreateUser(User) error
UpdateUser(User) error
DeleteUser(User)
}
```
如果你已经读过第5章的"创建存储接口以实现数据可移植性",会发现可以考虑使用同样的方式进行思考。通过接口,特别是常见的接口,如RoundTripper接口,这种组合为编写API提供了很大的灵活性。此外,像我们之前所做的那样编写顶级接口并直接传递接口而不是client可能很有用。
* * * *
学识浅薄,错误在所难免。欢迎在群中就本书提出修改意见,以飨后来者,长风拜谢。
Golang中国(211938256)
beego实战(258969317)
Go实践(386056972)
- 前言
- 第一章 I/O和文件系统
- 常见 I/O 接口
- 使用bytes和strings包
- 操作文件夹和文件
- 使用CSV格式化数据
- 操作临时文件
- 使用 text/template和HTML/templates包
- 第二章 命令行工具
- 解析命令行flag标识
- 解析命令行参数
- 读取和设置环境变量
- 操作TOML,YAML和JSON配置文件
- 操做Unix系统下的pipe管道
- 处理信号量
- ANSI命令行着色
- 第三章 数据类型转换和解析
- 数据类型和接口转换
- 使用math包和math/big包处理数字类型
- 货币转换和float64注意事项
- 使用指针和SQL Null类型进行编码和解码
- 对Go数据编码和解码
- Go中的结构体标签和反射
- 通过闭包实现集合操作
- 第四章 错误处理
- 错误接口
- 使用第三方errors包
- 使用log包记录错误
- 结构化日志记录
- 使用context包进行日志记录
- 使用包级全局变量
- 处理恐慌
- 第五章 数据存储
- 使用database/sql包操作MySQL
- 执行数据库事务接口
- SQL的连接池速率限制和超时
- 操作Redis
- 操作MongoDB
- 创建存储接口以实现数据可移植性
- 第六章 Web客户端和APIs
- 使用http.Client
- 调用REST API
- 并发操作客户端请求
- 使用OAuth2
- 实现OAuth2令牌存储接口
- 封装http请求客户端
- 理解GRPC的使用
- 第七章 网络服务
- 处理Web请求
- 使用闭包进行状态处理
- 请求参数验证
- 内容渲染
- 使用中间件
- 构建反向代理
- 将GRPC导出为JSON API
- 第八章 测试
- 使用标准库进行模拟
- 使用Mockgen包
- 使用表驱动测试
- 使用第三方测试工具
- 模糊测试
- 行为驱动测试
- 第九章 并发和并行
- 第十章 分布式系统
- 第十一章 响应式编程和数据流
- 第十二章 无服务器编程
- 第十三章 性能改进