如何使用 Gin 處理多部分/表單資料請求中的 JSON 資料和影像？

Go：使用Gin 處理表單中的JSON 資料和影像

Gin 是Go 中一個流行的Web 框架，可簡化HTTP 請求的處理。本文解決了使用 Gin 的綁定機制解析來自 multipart/form-data 請求的 JSON 資料和影像的特定問題。

請求處理程式碼

請求Gin 中的 handler 函數接收並處理 HTTP 請求。在這種情況下，它期望收到包含 JSON 資料和映像檔的多部分請求。

func (h *Handlers) UpdateProfile() gin.HandlerFunc {
    type request struct {
        Username    string `json:"username" binding:"required,min=4,max=20"`
        Description string `json:"description" binding:"required,max=100"`
    }

    return func(c *gin.Context) {
        var updateRequest request

        // Bind JSON data to `updateRequest` struct.
        if err := c.BindJSON(&updateRequest); err != nil {
            // Handle error here...
            return
        }

        // Get the image file from the request.
        avatar, err := c.FormFile("avatar")
        if err != nil {
            // Handle error here...
            return
        }

        // Validate file size and content type.
        if avatar.Size > 3<<20 || !avatar.Header.Get("Content-Type") { // if avatar size more than 3mb
            // Handle error here...
            return
        }

        // Handle image processing and database operations here...
        // Save username, description, and image to a database.

        c.IndentedJSON(http.StatusNoContent, gin.H{"message": "successful update"})
    }
}

測試案例

包含單元測試來驗證處理程序的功能。它使用多部分/表單資料主體設定模擬請求。請求包含 JSON 資料和圖像。

func TestUser_UpdateProfile(t *testing.T) {
    type testCase struct {
        name               string
        image              io.Reader
        username           string
        description        string
        expectedStatusCode int
    }

    // Set up mock request with multipart/form-data body.
    // ...

    for _, tc := range testCases {
        // ...

        w := httptest.NewRecorder()
        router.ServeHTTP(w, req)

        assert.Equal(t, tc.expectedStatusCode, w.Result().StatusCode)
    }
}

測試期間出錯

測試期間，由於請求正文中存在無效字元而發生錯誤。錯誤訊息是「錯誤#01：數字文字中的字元'-'無效。」

根本原因

Gin 的c.BindJSON 函數用於解析JSON 資料資料來自請求正文。但是，它假設請求正文以有效的 JSON 開頭。在 multipart/form-data 請求的情況下，正文以邊界 (--30b24345de...) 開頭，這對 JSON 文字來說是無效字元。

解決方案

為了解決這個問題，我們可以使用Gin 的c.ShouldBind 函數和binding.FormMultipart 來明確綁定到多部分/表單資料體。這使得 Gin 能夠正確解析 JSON 資料和映像檔。

// Bind JSON data and image file to `updateRequest` struct.
if err := c.ShouldBindWith(&updateRequest, binding.FormMultipart); err != nil {
    // Handle error here...
    return
}

結論

本文示範如何同時處理 JSON 資料和影像檔案在使用 Gin 的多部分/表單資料請求中。它強調了使用正確的綁定方法（c.ShouldBindWith(..., binding.FormMultipart)）以避免解析錯誤的重要性。

以上是如何使用 Gin 處理多部分/表單資料請求中的 JSON 資料和影像？的詳細內容。更多資訊請關注PHP中文網其他相關文章！