03_Go1_03 实现基本的API请求框架

1. 当前目录结构

 2. API请求流程

2.1 main.go 进入

package main

import (
    "net/http"

    "github.com/julienschmidt/httprouter"
)

func RegisterHandlers() *httprouter.Router {
    // *Router路由指针
    router := httprouter.New()

    // 使用POST方法注册一个适配/user路径的CreateUser函数
    router.POST("/user", CreateUser)

    // 用户登录
    router.POST("/user/:user_name", Login)

    // *Router作为参数传给ListenAndServe函数启动HTTP服务
    return router
}

func main() {
    r := RegisterHandlers()
    http.ListenAndServe(":8000", r)
}

/*

API请求流程：
    1. handler
    2. validatin
        a. request 是否合法
        b. user 是否存在
    3. 逻辑处理
    4. response

*/

2.2 handlers.go 处理

package main

import (
    "io"
    "net/http"

    "github.com/julienschmidt/httprouter"
)

// 创建用户
func CreateUser(w http.ResponseWriter, r *http.Request, p httprouter.Params) {
    io.WriteString(w, "Create User Handler")
}

// 用户登录
func Login(w http.ResponseWriter, r *http.Request, p httprouter.Params) {
    // 通过这种方式获取参数
    uname := p.ByName("user_name")
    io.WriteString(w, uname)
}

2.3 api.go 用户校验-数据库

package dbops

import "database/sql"

// 内部方法
func openConn() *sql.DB {

}

// 用户注册
func AddUserCrendential(loginName string, pwd string) error {

}

// 用户登录
func GetUserCredential(loginName string) (string, error) {

}

2.4 apidef.go 用户校验-用户模型

package defs

// 定义用户数据模型
type UserCredential struct {
    UserName string `json:"user_name`
    UserPwd  string `json:"user_pwd"`
}

2.5 errors.go 请求校验-错误类型

package defs

type Err struct {
    Error     string `json:"error"`
    ErrorCode string `json:"error_code"`
}

type ErroResponse struct {
    HttpSc int
    Error  Err
}

var (

    // request 传进来的参数无法解析
    ErrorRequestBodyParseFailed = ErroResponse{
        HttpSc: 400,
        Error: Err{
            Error:     "Request body is not correct",
            ErrorCode: "001",
        },
    }

    // 用户不存在
    ErrorNotAuthUser = ErroResponse{
        HttpSc: 401,
        Error: Err{
            Error:     "User authentication failed",
            ErrorCode: "002",
        },
    }
)

2.6 response.go 最终返回

package main

import "net/http"

func sendErrorResponse(w http.ResponseWriter) {

}

func sendNormalResponse(w http.ResponseWriter) {

}