Go语言工程实践:在线词典 | 豆包MarsCode AI刷题

67 阅读3分钟

1.实现内容

实现一个在线单词查询功能,用户通过输入单词后可以调用第三方的API查询到单词的翻译。

2.实现思路

2.1 API的选取

使用彩云小译作为第三方API,具体步骤如下:

  • 进入开发者模式,选择网络,在名称一列查找dist; image.png
  • 选择拷贝为curl; image.png
  • 将复制的内容在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 代码生成

将生成的代码运行,得到翻译后的结果。 image.png

生成的代码主要由四个部分组成:

  • 创建请求;
  • 设置请求头;
  • 发起请求;
  • 读取响应。

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结构体。

image.png

将代码重新改写,最终代码如下:

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)
}

运行结果如下:

image.png