【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,我们消除了遇到这个错误的风险。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 218,386评论 6 506
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 93,142评论 3 394
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 164,704评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,702评论 1 294
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,716评论 6 392
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,573评论 1 305
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,314评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 39,230评论 0 276
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,680评论 1 314
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,873评论 3 336
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,991评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,706评论 5 346
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,329评论 3 330
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,910评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 33,038评论 1 270
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 48,158评论 3 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,941评论 2 355

推荐阅读更多精彩内容