1.实现内容
实现一个在线单词查询功能,用户通过输入单词后可以调用第三方的API查询到单词的翻译。
2.实现思路
2.1 API的选取
使用彩云小译作为第三方API,具体步骤如下:
- 进入开发者模式,选择网络,在名称一列查找dist;
- 选择拷贝为curl;
- 将复制的内容在Convert网站打开,得到生成的Go语言代码;
package main
import (
"fmt"
"io"
"log"
"net/http"
"strings"
)
func main() {
client := &http.Client{}
var data = strings.NewReader(`{"trans_type":"en2zh","source":"good"}`)
req, err := http.NewRequest("POST", "https://api.interpreter.caiyunai.com/v1/dict", data)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Content-Type", "application/json;charset=utf-8")
req.Header.Set("Accept", "application/json, text/plain, */*")
req.Header.Set("Authorization", "Bearer")
req.Header.Set("Sec-Fetch-Site", "cross-site")
req.Header.Set("Accept-Language", "zh")
// req.Header.Set("Accept-Encoding", "gzip, deflate, br")
req.Header.Set("Sec-Fetch-Mode", "cors")
req.Header.Set("Origin", "https://fanyi.caiyunapp.com")
req.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15")
req.Header.Set("Referer", "https://fanyi.caiyunapp.com/")
req.Header.Set("Content-Length", "38")
req.Header.Set("Sec-Fetch-Dest", "empty")
req.Header.Set("version", "4.6.0")
req.Header.Set("X-Authorization", "token:qgemv4jr1y38jyq6vhvi")
req.Header.Set("device-id", "2a06bbbb52e14903dbad5bd3bedf62ad")
req.Header.Set("Priority", "u=3, i")
req.Header.Set("app-name", "xiaoyi")
req.Header.Set("os-type", "web")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
bodyText, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%s\n", bodyText)
}
2.2 代码生成
将生成的代码运行,得到翻译后的结果。
生成的代码主要由四个部分组成:
- 创建请求;
- 设置请求头;
- 发起请求;
- 读取响应。
2.2.1 创建请求
client := &http.Client{}
var data = strings.NewReader(`{"trans_type":"en2zh","source":"good"}`)
req, err := http.NewRequest("POST", "https://api.interpreter.caiyunai.com/v1/dict", data)
if err != nil {
log.Fatal(err)
}
通过http库创建client,data为请求的数据,NewRequest函数里面需要传入请求的类型、网址和请求的数据三个参数,通过err判断请求是否成功。
在生成的代码中,请求的数据是固定的,并且当data很大时,string类型的内存开销也很大,因此对这段代码进行修改:将请求的数据封装成json,并且采用流处理的方式运行。具体代码如下:
type DictRequest struct {
TransType string `json:"trans_type"`
Source string `json:"source"`
UserID string `json:"user_id"`
}
client := &http.Client{}
request := DictRequest{TransType: "en2zh", Source: word}
buf, err := json.Marshal(request)
if err != nil {
log.Fatalln(err)
}
var data = bytes.NewReader(buf)
req, err := http.NewRequest("POST", "https://api.interpreter.caiyunai.com/v1/dict", data)
if err != nil {
log.Fatal(err)
}
2.2.2 设置请求头
请求头一致即可。
req.Header.Set("Content-Type", "application/json;charset=utf-8")
req.Header.Set("Accept", "application/json, text/plain, */*")
req.Header.Set("Authorization", "Bearer")
req.Header.Set("Sec-Fetch-Site", "cross-site")
req.Header.Set("Accept-Language", "zh")
req.Header.Set("Sec-Fetch-Mode", "cors")
req.Header.Set("Origin", "https://fanyi.caiyunapp.com")
req.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15")
req.Header.Set("Referer", "https://fanyi.caiyunapp.com/")
req.Header.Set("Content-Length", "38")
req.Header.Set("Sec-Fetch-Dest", "empty")
req.Header.Set("version", "4.6.0")
req.Header.Set("X-Authorization", "token:qgemv4jr1y38jyq6vhvi")
req.Header.Set("device-id", "2a06bbbb52e14903dbad5bd3bedf62ad")
req.Header.Set("Priority", "u=3, i")
req.Header.Set("app-name", "xiaoyi")
req.Header.Set("os-type", "web")
2.2.3 发起请求
- 通过
resp, err := client.Do(req)达到发起请求的作用 - 请求完成后使用注册延迟调用的机制,用 defer resp.Body.Close() 关闭连接。
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
2.2.4 读取响应
bodyText, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
fmt.Printf("%s\n", bodyText)
从resp里面读取返回的数据,如果无误就将其打印出来。
由于打印出来的数据并不是我们想要的,因此需要将数据反序列化,得到翻译后的结果。将数据复制到oktools 网站中,得到Go结构体。
将代码重新改写,最终代码如下:
bodyText, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
if resp.StatusCode != 200 {
log.Fatalf("status code error: %d %s", resp.StatusCode, string(bodyText))
}
var dictResponse DictResponse
err = json.Unmarshal(bodyText, &dictResponse)
if err != nil {
log.Fatal(err)
}
fmt.Println(word, "UK:", dictResponse.Dictionary.Prons.En, "US:", dictResponse.Dictionary.Prons.EnUs)
for _, item := range dictResponse.Dictionary.Explanations {
fmt.Println(item)
}
3.总结
将上述功能封装成新的函数,代码如下:
func query(word string) {
client := &http.Client{}
request := DictRequest{TransType: "en2zh", Source: word}
buf, err := json.Marshal(request)
if err != nil {
log.Fatalln(err)
}
var data = bytes.NewReader(buf)
req, err := http.NewRequest("POST", "https://api.interpreter.caiyunai.com/v1/dict", data)
if err != nil {
log.Fatal(err)
}
req.Header.Set("Content-Type", "application/json;charset=utf-8")
req.Header.Set("Accept", "application/json, text/plain, */*")
req.Header.Set("Authorization", "Bearer")
req.Header.Set("Sec-Fetch-Site", "cross-site")
req.Header.Set("Accept-Language", "zh")
// req.Header.Set("Accept-Encoding", "gzip, deflate, br")
req.Header.Set("Sec-Fetch-Mode", "cors")
req.Header.Set("Origin", "https://fanyi.caiyunapp.com")
req.Header.Set("User-Agent", "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.1 Safari/605.1.15")
req.Header.Set("Referer", "https://fanyi.caiyunapp.com/")
req.Header.Set("Content-Length", "38")
req.Header.Set("Sec-Fetch-Dest", "empty")
req.Header.Set("version", "4.6.0")
req.Header.Set("X-Authorization", "token:qgemv4jr1y38jyq6vhvi")
req.Header.Set("device-id", "2a06bbbb52e14903dbad5bd3bedf62ad")
req.Header.Set("Priority", "u=3, i")
req.Header.Set("app-name", "xiaoyi")
req.Header.Set("os-type", "web")
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
defer resp.Body.Close()
bodyText, err := io.ReadAll(resp.Body)
if err != nil {
log.Fatal(err)
}
if resp.StatusCode != 200 {
log.Fatalf("status code error: %d %s", resp.StatusCode, string(bodyText))
}
var dictResponse DictResponse
err = json.Unmarshal(bodyText, &dictResponse)
if err != nil {
log.Fatal(err)
}
fmt.Println(word, "UK:", dictResponse.Dictionary.Prons.En, "US:", dictResponse.Dictionary.Prons.EnUs)
for _, item := range dictResponse.Dictionary.Explanations {
fmt.Println(item)
}
}
main函数如下:
func main() {
if len(os.Args) != 2 {
fmt.Fprintf(os.Stderr, `usage: simpleDict WORD example: simpleDict hello`)
os.Exit(1)
}
word := os.Args[1]
query(word)
}
运行结果如下: