Golang的API项目快速开始_代码007(未授权)

本文介绍: 开启一个简单的API服务。golang的教程网上一大堆，官网也有非常详细的教程，这里不在赘述这些基础语法教程，我们意在快速进入项目开发阶段。

开启一个简单的API服务。

golang的教程网上一大堆，官网也有非常详细的教程，这里不在赘述这些基础语法教程，我们意在快速进入项目开发阶段。

golang好用语法教程传送门： m.runoob.com/go/

前提：按照上一篇文档初始化项目

# 在项目文件下执行go命令下载gin依赖
go mod get github.com/gin-gonic/gin

package apis

import (
	"fmt"
	"net/http"

	"github.com/gin-gonic/gin"
	"github.com/gin-gonic/gin/binding"
)

// API入参参数
type HttpRequest struct {
	Name string `json:"name"`
}

// API响应参数
type HttpRespone struct {
	Status  int    `json:"status"`
	Message string `json:"message"`
	Data    string `json:"data"`
}

/*
实现一个入参为name，响应为：hello name的api
这个例子中，异常信息通过status和message返回，api响应状态正常，如果需要响应400等异常状态，可以更换c.JSON(http.StatusOK, res)中的StatusOK
*/
func Hello(c *gin.Context) {
	// 声明req
	var req HttpRequest
	// 声明res并初始化
	var res = HttpRespone{}

	// 获取api请求参数
	err := c.ShouldBindBodyWith(&req, binding.JSON)
	// 出现错误，则响应错误信息
	if err != nil {
		res.Status = 10
		res.Message = "读取请求参数错误"
		c.JSON(http.StatusOK, res)
		return
	}
	// 判断是否入参name
	if req.Name == "" {
		res.Status = 20
		res.Message = "参数name为空"
		c.JSON(http.StatusOK, res)
		return
	}
	// 正常响应 hello name
	res.Status = 0
	res.Message = "成功"
	res.Data = fmt.Sprintf("hello %v", req.Name)
	c.JSON(http.StatusOK, res)
}

package apis

import (
	"net/http"

	"github.com/gin-gonic/gin"
)

func StartHttp() {
	// 设置为发布模式（初始化路由之前设置）
	gin.SetMode(gin.ReleaseMode)
	// gin 默认中间件
	r := gin.Default()

	// 访问一个错误路由时，返回404
	r.NoRoute(func(c *gin.Context) {
		c.JSON(http.StatusNotFound, gin.H{
			"status":  404,
			"message": "404, page not exists!",
		})
	})

	// 注册hello路由
	r.POST("/hello", Hello)

	// 启动API服务
	if err := r.Run(":8080"); err != nil {
		panic(err)
	}
}

package main

import "prj_aiee/apis"

func main() {
	apis.StartHttp()
}

# 项目文件夹下执行go命令
go run main.go

# 执行curl命令调用API
curl -X POST "http://localhost:8080/hello" -H "content-type: application/json" -d "{"name": "aiee"}"

显示所有内容

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。

编写第一个API

发表回复取消回复

编写第一个API

相关文章

发表回复 取消回复

发表回复取消回复