Go实战案例一|青训营笔记

120 阅读6分钟

这是我参与「第五届青训营 」笔记创作活动的第7天

一、本堂课重点内容:

guessing-game

猜谜游戏主要是对go基础语法的实践,不包含复杂项目逻辑。

1、设置随机种子,保证随机。

2、然后接下来我们需要实现用户输入输出,并理解析成数字。 每个程序执行的时候都会打开几个文件,stdin stdout stderr等,stdin 文件可以用 os.Stdin 来得到。然后直接操作这个文件很不方便,我们会用 bufio.NewReader 把一个文件转换成一个 reader 变量。reader 变量上会有很多用来操作一个流的操作,我们可以用它的 ReadString 方法来读取一行。如果失败了的话,我们会打印错误并能退出。ReadString 返回的结果包含结尾的换行符,我们把它去掉,再转换成数字。如果转换失败,我们同样打印错误,退出。

3、使用bufio读取数据较复杂(大项目会用bufio),也可以使用fmt.Scanf来简化代码。

Code:

package main
import (
    "bufio"
    "fmt"
    "math/rand"
    "os"
    "strconv"
    "strings"
    "time"
)
func main() {
    maxNum := 100
    rand.Seed(time.Now().UnixNano())  //设置随机种子
    secretNumber := rand.Intn(maxNum)
    //fmt.Println("The secret number is ", secretNumber)
    fmt.Println("Please input your guess")
    reader := bufio.NewReader(os.Stdin)  //得到输入流
    for {
        input, err := reader.ReadString('\n')  //读取一行
        if err != nil {
            fmt.Println("An error occured while reading input. Please try again", err)
            continue
        }
        input = strings.Trim(input, "\r\n")  //去掉末尾换行符

        guess, err := strconv.Atoi(input)  //转数字
        if err != nil {
            fmt.Println("Invalid input. Please enter an integer value")
            continue
        }
        fmt.Println("You guess is", guess)
        if guess > secretNumber {
            fmt.Println("Your guess is bigger than the secret number. Please try again")
        } else if guess < secretNumber {
            fmt.Println("Your guess is smaller than the secret number. Please try again")
        } else {
            fmt.Println("Correct, you Legend!")
            break
        }
    }
}

simple dict

实现简单的命令行在线词典。以hello单词为例,获取到请求curl后,使用在线工具生成go请求代码,再使用生成工具生成结构体,将请求得到的JSON反序列化存入生成的结构体中,然后输出结构体中我们需要的音标和翻译,最后从命令行读取单词变量,替换掉一开始的hello即可。

1功能介绍

执行命令 go run simpledict\v4\main.go hello 得到如下输出:

hello UK: [ˈheˈləu] US: [həˈlo]
int.喂;哈罗  
n.引人注意的呼声  
v.向人呼(喂)  

2抓包

进入彩云小译fanyi.caiyunapp.com ,输入hello点击翻译,然后右键检查找到Network,过滤选择All,找到HTTP的post类型的请求(dict),也可点击Preview浏览请求内容。

请求的 header 的相当的复杂,有十来个。然后请求头是一个 json 里面有两个字段,一个是代表你要你是从什么语言转化成什么语言, source 就是你要查询的单词。 API 的返回结果里面会有 Wiki 和 dictionary 两个字段。我们需要用的结果主要在dictionary.Explanations 字段里面。其他有些字段里面还包括音标等信息。

3代码生成

我们需要在 Golang 里面去发送这个请求。因为这个请求比较复杂,用代码构造很麻烦,实际上我们有一种非常简单的方式来生成代码,我们可以选定某个dict请求,然后右键选中 copy as curl(bash)。 copy完成之后可以在终端粘贴一下 curl 命令,应该可以成功返回一大串 json(实际上没有成功)。

然后我们打开一个网站:curlconverter.com/#go ,粘贴 curl 请求(copy as curl(bash)才能成功生成),在右边的语言里面选 Golang 就能够看到一串很长的代码,我们直接把它 copy 到我们的编辑器里面。 有几个header比较复杂,生成代码有转义导致的编译错误,删掉这几行即可。

import (
    "fmt"
    "io"
    "log"
    "net/http"
    "strings"
)
func main() {
    client := &http.Client{}  //创建HTTP client
    var data = strings.NewReader(`{"trans_type":"en2zh","source":"hello"}`)  //data流
    req, err := http.NewRequest("POST", "https://api.interpreter.caiyunai.com/v1/dict", data)
    if err != nil {
            log.Fatal(err)
    }
    req.Header.Set("authority", "api.interpreter.caiyunai.com")  //删去部分Header
    req.Header.Set("referer", "https://fanyi.caiyunapp.com/")
    req.Header.Set("accept-language", "zh-CN,zh;q=0.9,en-GB;q=0.8,en;q=0.7,an;q=0.6")
    resp, err := client.Do(req)  //发送请求
    if err != nil {
        log.Fatal(err)  //解析失败 断网等出现错误
    }
    defer resp.Body.Close()  //body同样是流,防止资源泄露需要添加 defer手动关闭
    // 使用defer延迟关闭,当函数执行结束后,从下往上依次触发
    bodyText, err := io.ReadAll(resp.Body)
    if err != nil {
        log.Fatal(err)
    }
    fmt.Printf("%s\n", bodyText)  //打印返回的JSON
}

然后,我们需要用到第一节中介绍的 JSON 序列化,因为POST请求中的data应该是从命令行输入的变量,而不能只是‘hello’。

4生成request body

type DictRequest struct {  //定义JSON结构体,字段开头大写
    TransType string `json:"trans_type"`
    Source    string `json:"source"`
    UserID    string `json:"user_id"`
}

request := DictRequest{TransType: "en2zh", Source: "hello"}  //new一个结构体变量并初始化
buf, err := json.Marshal(request)  //序列化结构体,得到buf数组
if err != nil {
    log.Fatal(err)
}
var data = bytes.NewReader(buf)  //由于是数组,而不是字符串所以不用strings.NewReader

5解析response body

生成的抓包代码返回的response body是JSON格式,我们要从中获取翻译信息。

在 js/Python 这些脚本语言里面,body 是一个字典或者 map 的结构, 可以直接从里面取值。 但是golang是个强类型语言,这种做法并不是最佳实践。

更常用的方式是和 request 的方式一样,写一个结构体,把返回的 JSON 反序列化到结构体里面。但是我们在浏览器里面可以看到这个 API 返回的结构非常复杂,如果要一一定义结构体字段,非常繁琐并且容易出错。

那么此时我们可以使用对应的代码生成工具:oktools.net/json2go 打开这个网站 ,把json字符串粘贴进去(即网页端Response内容),这样我们就能够生成对应的结构体DictResponse。

在某些时刻,如果不需要对这个返回结果做很多精细的操作,选择转换嵌套按钮即可,能让生成的代码更加紧凑。

var dictResponse DictResponse
 //反序列化bodyText到结构体dictResponse,注意取地址才能写入
err = json.Unmarshal(bodyText, &dictResponse) 
if err != nil {
        log.Fatal(err)
}
fmt.Printf("%#v\n", dictResponse) //详细打印整个结构体

6打印结果

我们只需要打印结构体中的音标和解释即可。

fmt.Println(word, "UK:", dictResponse.Dictionary.Prons.En, "US:", dictResponse.Dictionary.Prons.EnUs)
for _, item := range dictResponse.Dictionary.Explanations {
    fmt.Println(item)
}

7完善代码

从命令行获取不同的单词

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

最终Code:

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "log"
    "net/http"
    "os"
)

type DictRequest struct {
    TransType string `json:"trans_type"`
    Source    string `json:"source"`
    UserID    string `json:"user_id"`
}

type DictResponse struct {
    Rc   int `json:"rc"`
    Wiki struct {
        KnownInLaguages int `json:"known_in_laguages"`
        Description struct {
            Source string      `json:"source"`
            Target interface{} `json:"target"`
        } `json:"description"`
        ID   string `json:"id"`
        Item struct {
            Source string `json:"source"`
            Target string `json:"target"`
        } `json:"item"`
        ImageURL  string `json:"image_url"`
        IsSubject string `json:"is_subject"`
        Sitelink  string `json:"sitelink"`
    } `json:"wiki"`
    Dictionary struct {
        Prons struct {
            EnUs string `json:"en-us"`
            En   string `json:"en"`
        } `json:"prons"`
        Explanations []string      `json:"explanations"`
        Synonym      []string      `json:"synonym"`
        Antonym      []interface{} `json:"antonym"`
        WqxExample   [][]string    `json:"wqx_example"`
        Entry        string        `json:"entry"`
        Type         string        `json:"type"`
        Related      []interface{} `json:"related"`
        Source       string        `json:"source"`
    } `json:"dictionary"`
}

func query(word string) {
    client := &http.Client{}
    //var data = strings.NewReader(`{"trans_type":"en2zh","source":"good"}`)

    request := DictRequest{TransType: "en2zh", Source: word}
    buf, err := json.Marshal(request)
    if err != nil {
        log.Fatal(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("authority", "api.interpreter.caiyunai.com")
    req.Header.Set("sec-ch-ua", `" Not A;Brand";v="99", "Chromium";v="98", "Google Chrome";v="98"`)
    req.Header.Set("sec-ch-ua-mobile", "?0")
    req.Header.Set("user-agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/98.0.4758.102 Safari/537.36")
    req.Header.Set("app-name", "xy")
    req.Header.Set("content-type", "application/json;charset=UTF-8")
    req.Header.Set("accept", "application/json, text/plain, */*")
    req.Header.Set("os-type", "web")
    req.Header.Set("x-authorization", "token:qgemv4jr1y38jyq6vhvi")
    req.Header.Set("sec-ch-ua-platform", `"Windows"`)
    req.Header.Set("origin", "https://fanyi.caiyunapp.com")
    req.Header.Set("sec-fetch-site", "cross-site")
    req.Header.Set("sec-fetch-mode", "cors")
    req.Header.Set("sec-fetch-dest", "empty")
    req.Header.Set("referer", "https://fanyi.caiyunapp.com/")
    req.Header.Set("accept-language", "zh-CN,zh;q=0.9,en-GB;q=0.8,en;q=0.7,an;q=0.6")
    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 {  //校验response是否合法
        log.Fatal("bad StatusCode:", resp.StatusCode, "body", string(bodyText))
    }
    //fmt.Printf("%s\n", bodyText)
    var dictResponse DictResponse
    err = json.Unmarshal(bodyText, &dictResponse)
    if err != nil {
        log.Fatal(err)
    }
    //fmt.Printf("%#v\n", dictResponse)
    fmt.Println(word, "UK:", dictResponse.Dictionary.Prons.En, "US:", dictResponse.Dictionary.Prons.EnUs)
    for _, item := range dictResponse.Dictionary.Explanations {
        fmt.Println(item)
    }
}

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

proxy SOCKS5 代理