【Go Web开发】GET请求处理

上一篇文章我们介绍了POST请求处理，今天我们来看看GET请求的处理。

同样，我们将从数据库模型开始，首先将Get()方法更新为执行以下SQL查询:

SELECT id, create_at, title, year, runtime, genres, version
FROM moives
where id = $1

因为movies表使用id列作为它的主键，所以这个查询将只返回一行数据(如果对应id不存在的话不返回任何行)。因此，我们应该再次使用Go的QueryRow()方法来执行这个查询。
打开internal/data/movies.go文件，更新以下代码：

func (m MovieModel) Get(id int64) (*Movie, error) {
    //PostgreSQL的bigserial类型用于movie的ID，将自增1，因此我们知道id不会小于1。
    //为了避免不必要的查询，这里加个判断。
    if id < 1 {
        return nil, ErrRecordNotFound
    }
    //定义SQL查询语句用于查询movie
    query := `
        SELECT id, create_at, title, year, runtime, genres, version
        FROM movies
        where id = $1`
    var movie Movie
    err := m.DB.QueryRow(query, id).Scan(
        &movie.ID,
        &movie.CreateAt,
        &movie.Title,
        &movie.Year,
        &movie.Runtime,
        pq.Array(&movie.Genres),
        &movie.Version,
        )
    //错误处理，如果没找到对应的movie，Scan()将返回sql.ErrNoRows错误。
    //检查错误类型并返回自定义ErrRecordNotFound
    if err != nil {
        switch {
        case errors.Is(err, sql.ErrNoRows):
            return nil, ErrRecordNotFound
        default:
            return nil, err
        }
    }
    //否则，返回Movie指针
    return &movie, nil
}

上面代码唯一值得注意的是，当扫描来自PostgreSQL text[]数组的类型数据时，我们需要再次使用pq.Array()函数。如果我们不使用这个适配器函数，将在运行时得到以下错误:

sql: Scan error on column index 5, name "genres": unsupported Scan, storing driver.Value type []uint8 into type *[]string

更新对应的API处理程序

接下来要做的就是更新showMovieHandler可以调用movie模型的Get()方法。处理程序需要查看Get()函数是否返回ErrRecordNotFound错误，如果返回该错误，向客户端发送404 Not Found响应。否则，我们可以继续在JSON响应中呈现返回的Movie结构体。如下所示：

File：cmd/api/movies.go

---

package main

...

func (app *application) showMovieHandler(w http.ResponseWriter, r *http.Request) {
    id, err := app.readIDParam(r)
    if err != nil {
        app.notFoundResponse(w, r)
        return
    }
    //调用Get()方法获取数据库中对应id的movie信息。并使用errors.Is()方法检查返回错误类型
    //如果是未找到对应id的movie就返回404 Not Found响应
    movie, err := app.models.Movies.Get(id)
    if err != nil {
        switch {
        case errors.Is(err, data.ErrRecordNotFound):
            app.notFoundResponse(w, r)
        default:
            app.serverErrorResponse(w, r, err)
        }
        return
    }

    err = app.writeJSON(w, http.StatusOK, envelope{"movie": movie}, nil)
    if err != nil {
        app.serverErrorResponse(w, r, err)
    }
}

代码很简洁，多亏了前面准备的帮助函数。您可以通过重新启动API服务，并查找已经在数据库中创建的movie数据。例如:

$ curl -i localhost:4000/v1/movies/2
HTTP/1.1 200 OK
Content-Type: application/json
Date: Sun, 28 Nov 2021 12:44:06 GMT
Content-Length: 145

{
        "movie": {
                "id": 2,
                "title": "Black Panther",
                "runtime": "134 mins",
                "genres": [
                        "action",
                        "adventure"
                ],
                "Version": 1
        }
}

同样地，你也可以尝试用一个在数据库中不存在的ID发启请求。在那种情况下，你应该收到404 Not Found响应，像这样:

$ curl -i localhost:4000/v1/movies/42
HTTP/1.1 404 Not Found
Content-Type: application/json
Date: Sun, 28 Nov 2021 12:45:35 GMT
Content-Length: 59

{
        "error": "the requested  resource could not be found"
}

附加内容

为什么不使用无符号整数作为电影ID?

在Get()方法的开头，我们用以下代码来检查id参数是否小于1:

func (m MovieModel) Get(id int64) (*Movie, error) { 
    if id < 1 {
        return nil, ErrRecordNotFound 
    }
    ...
}

你可能想知道：如果电影ID不为负，在Go代码中为什么我们不使用unsigned uint64类型来存储ID，而使用int64?

有两个原因：

• 第一个原因是PostgreSQL没有无符号整数。为了避免溢出或其他兼容性问题，将Go和数据库整数类型对齐是明智的，因为PostgreSQL没有unsigned integer，这意味着我们应该避免在Go代码中使用uint*类型来读取或写入PostgreSQL的任何值。

相反，最好根据下表对齐整型:

PostgreSQL 类型	Go 类型
smallint, smallserial	int16(-32768 到 32767)
integer, serial	int32(-2147483648 到 2147483647)
bigint, bigserial	int64 (-9223372036854775808 to 9223372036854775807)

还有另一个原因。Go的database/sql包实际上不支持任何大于9223372036854775807 (int64的最大值)的整型值。uint64可能大于这个值，这会导致Go产生类似这样的运行时错误:

sql: converting argument $1 type: uint64 values with high bit set are not supported

通过在Go代码中使用int64，我们消除了遇到这个错误的风险。