Golang 接收 GET/POST 请求并返回 JSON 数据

概述

Golang 是一门快速、安全，易于使用的程序语言，它被广泛地用于Web和网络编程领域。本文将详细介绍如何使用 Golang 编写一个能够接收 HTTP GET/POST 请求并返回 JSON 数据的 Web 服务器。

准备工作

在开始编写代码之前，需要确保工作环境已经准备就绪。我们需要安装 Golang 和依赖包，可以从官方网站[1]下载并安装。然后使用 go get 命令安装以下依赖包：

1. github.com/gorilla/mux：路由库，方便我们处理 URL 路径的映射；
2. github.com/unrolled/render：渲染库，用于将 JSON 数据渲染到 HTTP 响应中。

编写代码

以下是完整的代码实现，可以把它保存为 main.go 文件：

package main

import (
    "encoding/json" //用于 JSON 数据的编码和解码
    "net/http"      // 用于 HTTP 请求和响应
    "github.com/unrolled/render" // JSON 渲染库
    "github.com/gorilla/mux" // 路由库
)

type User struct {
    Name string `json:"name"`
    Age int `json:"age"`
    Email string `json:"email"`
}

func main() {
    r := mux.NewRouter()

    r.HandleFunc("/user/{name}", getUser).Methods("GET")
    r.HandleFunc("/user", addUser).Methods("POST")

    http.ListenAndServe(":8080", r)
}

func getUser(w http.ResponseWriter, r *http.Request) {
    params := mux.Vars(r) 
    name := params["name"]

    // 创建一个用户对象
    user := User{Name: name, Age: 25, Email: "[e-mail]"}

    // 将用户对象编码为 JSON 格式
    jsonData, _ := json.Marshal(user)

    // 将 JSON 数据渲染到 HTTP 响应中
    renderer := render.New()
    renderer.JSON(w, http.StatusOK, string(jsonData))
}

func addUser(w http.ResponseWriter, r *http.Request) {
    var user User

    // 从 HTTP POST 请求中解码 JSON 数据，并存储到用户对象中
    err := json.NewDecoder(r.Body).Decode(&user)
    if err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }

    // 将用户对象编码为 JSON 格式
    jsonData, _ := json.Marshal(user)

    // 将 JSON 数据渲染到 HTTP 响应中
    renderer := render.New()
    renderer.JSON(w, http.StatusOK, string(jsonData))
}

代码解释

上述代码定义了一个结构体类型 User，其中包含了用户的名称、年龄和电子邮箱等信息。为了能够将 User 类型的数据渲染到 HTTP 响应中，我们使用了 github.com/unrolled/render 库，它能够很容易地将 JSON 数据渲染到 HTTP 响应中。

在 main 函数中，我们创建了一个 mux.Router 路由器来处理 HTTP 请求。我们在路由器中添加了两个路由：

1. /user/{name} 路由用于接收 HTTP GET 请求，其中 {name} 是一个 URL 参数，表示用户的名称；
2. /user 路由用于接收 HTTP POST 请求，其中 JSON 数据中包含了要添加的用户信息。

在 getUser 和 addUser 函数中，我们分别处理 /user/{name} 和 /user 的 HTTP GET 和 POST 请求，解析 URL 参数或 JSON 数据，并将用户信息编码为 JSON 数据后渲染到 HTTP 响应中。

运行程序

保存代码之后，使用以下命令编译并运行程序：

go build main.go
./main

接着打开浏览器，访问 http://localhost:8080/user/John，用户的名称将被渲染为 JSON 数据并显示在浏览器中。然后可以使用 HTTP 客户端发送 POST 请求，以添加新用户的相关信息。

结论

这篇文章介绍了如何使用 Golang 编写一个Web服务器，它能够接收 HTTP GET/POST 请求并返回 JSON 数据。我们使用了 github.com/gorilla/mux 路由库和 github.com/unrolled/render 渲染库来处理 HTTP 请求和渲染响应。值得一提的是，Golang 凭借着它的高性能、易用性和安全性成为越来越多 Web 应用开发者的首选语言。