Go Web开发入门指南＜前半＞

Go Web开发入门指南

关注博主不迷路：可乐可乐可

内容：Go Web开发套装，Gin，Gorm，viper，validator，zap，go-redis，grpc

本文难度：适合入门

一般开发web项目，需要处理这些

路由匹配，参数获取，ORM持久化操作，日志

更高级一些，将使用redis，Elasticsearch，以及rpc远程调用

如果你是Java转行而来，你需要首先意识到一个问题：Go语言没有Spring那种包办的生态，需要各种框架拼装起来（祈求🎈有Spring这种角色吧）好在Go的设计就是两个字：简单，所以用起来倒是不难

目前，滴滴开源了Go语言的ioc框架go- spring，但是在Go的社区中，并没有使用ioc的风气，大家仍然使用手动管理依赖的模式（可能大多数是python和C++来的人的原因，如果都是Java来的，怕是早已风靡一时）

本文需要的知识储备：Go语言基础（基础语法，json，简易web服务）

从原生Web框架整起

Go语言是一名新生儿（相比隔壁Jvav，C艹老哥），所以Go语言诞生之时就能很轻松的进行主流Web开发（不依托框架），这在Java来看，是很可怕的事情，很难想象没有汤姆猫，Java的咖啡杯还能不能轻松端起来（包括Netty框架）

所以我们首先从Go原生框架做起，从内存存储到io操作，到数据库存储，一步步升级

一个原生服务器

关于Golang原生web框架，看这里：

package main

import (
   "fmt"
   "go-web-tutorial/handler"
   "log"
   "net/http"
)

func main() {
   
   fmt.Println("Starting the server ...")
   helloHandler := handler.NewHelloHandler()
   http.Handle("/hello", helloHandler)
   // 创建服务器，ListenAndServe若服务器宕机，会返回异常
   log.Fatal(http.ListenAndServe("localhost:8080", nil))
}

package handler

import (
	"bytes"
	"fmt"
	"net/http"
)

type HelloHandler struct {
   
	m map[string]string
}

func NewHelloHandler() *HelloHandler {
   
	return &HelloHandler{
   m: make(map[string]string)}
}

// 回声服务器，返回接受的body，
// 实现Handler接口
func (h HelloHandler) ServeHTTP(writer http.ResponseWriter, request *http.Request) {
   
	b := request.Body
	buf := bytes.Buffer{
   }
	buf.ReadFrom(b)
	b.Close()
	s := buf.String()
	fmt.Printf("get request: \nMethod:%s\n%s\n%s\n", request.Method, request.RequestURI, s)
	writer.Write(buf.Bytes())
}

这段代码中：

我们实现了一个简易的后端，读取了body的值，但是这个后端太简单了，

1. 路由拦截下来后才能得知请求方法
2. 我们需要手动处理io，
3. 读取io后body需要手动映射到实例中，
4. 链接上的参数需要我们手动使用正则取下来
5. 路由分组问题，比如 /test/t /test/t2
6. 返回值需要我们手动处理为[]byte类型

后面我们将一步一步进行解决，逐步配上所有的框架

改进路由系统

gin等框架的路由采用的实际上是httprouter框架

httprouter框架：https://github.com/julienschmidt/httprouter

httprouter框架改进了原生的Handler路由配置模式

回顾GoWeb原生开发中的知识，Handler使用http.Handle来进行注册，如果我们注册了http.ListenAndServe(“localhost:8080”, nil)中nil位置的这个Handler（记作默认Handler），Go将忽略http.Handle中注册的路由，使用该位置的Handler解析所有的路由

httprouter就是构建了nil这个位置的Handler，请求发送到服务，被拦截后，经过默认Handler进行处理，然后进入httprouter框架，分发给你在框架中注册的路由

router := httprouter.New()
router.GET("/", defaultHandler.ServeHTTP)
router.GET("/hello/:name", helloHandler.ServeHTTP)
// 开启监听，使用httprouter作为Handler
log.Fatal(http.ListenAndServe(":8080", router))

httprouter提供了一套高性能的Restful风格的接口，如下，

router.GET("/", defaultHandler.ServeHTTP)
router.POST("/hello/:name", helloHandler.ServeHTTP)

其中，首个参数是Path，第二个参数一个func变量，相对原生更灵活，不再需要类型支撑

同时，httprouter支持配置CORS，同时我们可以利用Go函数闭包（匿名函数），将原有逻辑封装一层，达到预处理的效果

需要注意的是，httprouter只是路由框架，这里使用的本质上还是原生的http服务器

CORS的官方demo如下

router.GlobalOPTIONS = http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
   
    if r.Header.Get("Access-Control-Request-Method") != "" {
   
        // Set CORS headers
        header := w.Header()
        header.Set("Access-Control-Allow-Methods", r.Header.Get("Allow"))
        header.Set("Access-Control-Allow-Origin", "*")
    }

    // Adjust status code to 204
    w.WriteHeader(http.StatusNoContent)
})

预处理的官方demo如下

package main

import (
	"fmt"
	"log"
	"net/http"

	"github.com/julienschmidt/httprouter"
)

// BasicAuth 闭包，预处理一层，然后执行Handle函数参数
func BasicAuth(h httprouter.Handle, requiredUser, requiredPassword string) httprouter.Handle {
   
	return func(w http.ResponseWriter, r *http.Request, ps httprouter.Params) {
   
		// Get the Basic Authentication credentials
		user, password, hasAuth := r.BasicAuth()

		if hasAuth && user == requiredUser && password == requiredPassword {
   
			// Delegate request to the given handle
			h(w, r, ps)
		} else {
   
			// Request Basic Authentication otherwise
			w.Header().Set("WWW-Authenticate", "Basic realm=Restricted")
			http.Error(w, http.StatusText(http.StatusUnauthorized), http.StatusUnauthorized)
		}
	}
}

func Index(w http.ResponseWriter, r *http.Request, _ httprouter.Params) {
   
	fmt.Fprint(w, "Not protected!\n")
}

func Protected(w http.ResponseWriter, r *http.Request, _ httprouter.Params) {
   
	fmt.Fprint(w, "Protected!\n")
}

func main() {
   
	user := "gordon"
	pass := "secret!"

	router := httprouter.New()
	router.GET("/", Index)
	router.GET("/protected/", BasicAuth(Protected, user, pass))

	log.Fatal(http.ListenAndServe(":8080", router))
}

我们升级一下原生服务器

package main

import (
   "fmt"
   "github.com/julienschmidt/httprouter"