golang基础-http server

mob604756e80bb7 · · 465 次点击 · · 开始浏览    
这是一个创建于 的文章,其中的信息可能已经有所发展或是发生改变。

golang实现一个简单的http server

如果搜索golang http server,会发现网上有很多不同的写法,本节将介绍多种写法,并把他们的关系捋清楚。

写法1

直接传入函数

func SayHello(w http.ResponseWriter, r *http.Request) {     w.Write([]byte("hello")) } func main() { http.HandleFunc("/say_hello", SayHello) err := http.ListenAndServe(":12345", nil) if err != nil { log.Fatal("ListenAndServe: ", err) } } 复制代码

写法2

定义结构体,需要实现ServerHTTP方法。

type ValueHandler struct {} func (p *ValueHandler) ServerHTTP(w http.ResponseWriter, r *http.Request) {     w.Write([]byte("value-pretty")) } func main() { http.Handle("/get_value", &ValueHandler) err := http.ListenAndServe(":12345", nil) if err != nil { log.Fatal("ListenAndServe: ", err) } } 复制代码

1,2两种写法极其相似,区别在于写法2需要一个结构体,并且必须实现ServerHTTP这个接口。1其实是对2的简化,相当于在net/http帮大家定义了一个实现了ServerHTTP的函数定义。

  • http.HandleFunc 注册了路由关系
  • http.ListenAndServe表示启动了一个服务。

写法3

显示使用Mux,Mux即multiplexor,保存了路由和方法的映射。可以记录多个url和handler的对应关系。

func SayHello(w http.ResponseWriter, r *http.Request) {     w.Write([]byte("hello")) } func main() {     mux := http.NewServeMux()     mux.HandleFunc("/say_hello", SayHello)     err := http.ListenAndServe(":12345", mux)     if err != nil { log.Fatal("ListenAndServe: ", err) } } 复制代码

这里可能会问,http.HanlderFunc没有使用mux,也可以注册多路映射。实际是底层有DefaultMux,在http Server中若没有传递,即用默认的。以下是http.HanlderFunc定义:

func HandleFunc(pattern string, handler func(ResponseWriter, *Request)) {     DefaultServeMux.HandleFunc(pattern, handler) } var DefaultServeMux = &defaultServeMux var defaultServeMux ServeMux 复制代码

写法4

使用server.ListenAndServe

func SayHello(w http.ResponseWriter, r *http.Request) {     w.Write([]byte("hello")) } func main() { mux := http.NewServeMux() mux.HandleFunc("/say_hello", SayHello) server := http.Server{ Addr:        ":12345", Handler:     serveMux, ReadTimeout: 5 * time.Second, }     err := server.ListenAndServe()     if err != nil { log.Fatal("ListenAndServe: ", err) } } 复制代码

和写法3的区别,在于监听函数http.ListenAndServe,替换为了server.ListenAndServe 。其实Server结构体是必然存在的,http.ListenAndServe只是做了封装,实际还是生成了一个Server字段,默认填了addr, handler两个参数。以下是http.ListenAndServe定义

func ListenAndServe(addr string, handler Handler) error {     server := &Server{Addr: addr, Handler: handler}     return server.ListenAndServe() } 复制代码

显示指定http.Server,可以灵活选择更多配置。比如超时时间。

小结

四种写法本质上是一样的,建议使用最完整的方法4。 因为其能提供更完整,灵活的配置,同时也并不复杂。

流程分析

通过对http包的分析之后,现在让我们来梳理一下整个的代码执行过程。

HandleFunc 流程

如果是Http.HandleFunc,首先会调用调用了DefaultServeMux的HandleFunc。

进入实际流程:

  • 调用了DefaultServeMux的Handle
  • 往路由映射表map[string]muxEntry,添加对应的handler和路由规则
e := muxEntry{h: handler, pattern: pattern} mux.m[pattern] = e type ServeMux struct {     mu    sync.RWMutex     m     map[string]muxEntry     es    []muxEntry // slice of entries sorted from longest to shortest.     hosts bool       // whether any patterns contain hostnames } 复制代码

ListenAndServe流程

若http.ListenAndServe(":9090", nil),首先实例化Server

server := &Server{Addr: addr, Handler: handler} type Server struct {     Addr    string  // TCP address to listen on, ":http" if empty     Handler Handler // handler to invoke, http.DefaultServeMux if nil     TLSConfig *tls.Config     ReadTimeout time.Duration     ReadHeaderTimeout time.Duration     WriteTimeout time.Duration     IdleTimeout time.Duration     MaxHeaderBytes int     TLSNextProto map[string]func(*Server, *tls.Conn, Handler)     ConnState func(net.Conn, ConnState)     ErrorLog *log.Logger     disableKeepAlives int32     // accessed atomically.     inShutdown        int32          nextProtoOnce     sync.Once // guards setupHTTP2_* init     nextProtoErr      error          mu         sync.Mutex     listeners  map[*net.Listener]struct{}     activeConn map[*conn]struct{}     doneChan   chan struct{}     onShutdown []func() } 复制代码

Server结构比较复杂,关注ReadTimeout,WriteTimeout,Handler几个常用字段即可。

实际流程:

  • 调用Server的ListenAndServe()
  • 调用net.Listen("tcp", addr)监听端口,拿到Listen的实例
  • srv.Serve 传入上面的Listen示例
  • Accept请求,每收到一个请求,开启一个协程处理
  • 协程中会根据路由和handler的映射,选择handler来处理请求

处理函数如何拿到参数

the http.Request 包含了请求的所有信息,我们可以从中拿出请求的参数:

  • 针对Get 请求: vars := r.URL.Query(); vars["username"][0]
  • 针对Post 表单请求,r.ParseForm(); r.Form("username")
  • 针对Post json请求: 解析r.Body
// deal get func SayHello(w http.ResponseWriter, r *http.Request) {     vars := r.URL.Query()     username := vars["username"][0] io.WriteString(w, "hello world " + username) } // 处理表单 func SayHello(w http.ResponseWriter, r *http.Request) {     r.ParseForm()     username, err :=  request.Form["username"] io.WriteString(w, "hello world " + username) } //deal json type User struct {     UserName string } func SayHello(w http.ResponseWriter, r *http.Request) {         err := json.NewDecoder(r.Body).Decode(&u)         if err != nil {             http.Error(w, err.Error(), 400)             return         }         io.WriteString(w, "hello world " + u.Username) } 复制代码

中间件抽象

如果需要计算接口处理时间,那么我们可以这么写

func SayHello(w http.ResponseWriter, r *http.Request) {         timeStart := time.Now()         err := json.NewDecoder(r.Body).Decode(&u)         if err != nil {             http.Error(w, err.Error(), 400)             return         }         io.WriteString(w, "hello world " + u.Username)         timeElapsed := time.Since(timeStart)         fmt.Println(timeElapsed) } 复制代码

存在一个问题,就是如果有二十个接口,那同样的代码得写20次,当有类似需求增加,或者修改时。需要改几十处。这些同样的代码,我们要想办法抽象起来。

func timeMiddleware(next http.Handler) http.Handler {     return http.HandlerFunc(func(wr http.ResponseWriter, r *http.Request) {         timeStart := time.Now()         // next handler         next.ServeHTTP(wr, r)         timeElapsed := time.Since(timeStart)         fmt.Println(timeElapsed)     }) } 复制代码

如此就可以通过中间件的思想,抽象出公用代码。而且这种中间件思想,还可以嵌套使用。拥有很强的扩展性。

更优雅的写法

// 示例来自《go语言高级编程》 r = NewRouter() r.Use(timeMiddleware) r.Use(ratelimitMiddleware) r.Add("/", SayHello) 复制代码
type middleware func(http.Handler) http.Handler type Router struct {     middlewareChain [] middleware     mux map[string] http.Handler } func NewRouter() *Router{     return &Router{} } func (r *Router) Use(m middleware) {     r.middlewareChain = append(r.middlewareChain, m) } func (r *Router) Add(route string, h http.Handler) {     var mergedHandler = h     for i := len(r.middlewareChain) - 1; i >= 0; i-- {         mergedHandler = r.middlewareChain[i](mergedHandler)     }     r.mux[route] = mergedHandler } 复制代码

web框架

在实际开发中,基本上都会用到一些完善的框架,比如gin, beego, echo等。 均提供了比较方便,简单的编程架子。并且拥有良好的程序结构。 后续会针对其中一些进行单独介绍。




有疑问加站长微信联系(非本文作者)

本文来自:51CTO博客

感谢作者:mob604756e80bb7

查看原文:golang基础-http server

入群交流(和以上内容无关):加入Go大咖交流群,或添加微信:liuxiaoyan-s 备注:入群;或加QQ群:692541889

465 次点击  
加入收藏 微博
暂无回复
添加一条新回复 (您需要 登录 后才能回复 没有账号 ?)
  • 请尽量让自己的回复能够对别人有帮助
  • 支持 Markdown 格式, **粗体**、~~删除线~~、`单行代码`
  • 支持 @ 本站用户;支持表情(输入 : 提示),见 Emoji cheat sheet
  • 图片支持拖拽、截图粘贴等方式上传