iris 路由註冊和上下文context

路由註冊到app.routes

http請求的處理，相較於基本的net/http包，iris框架將http請求(w,*r)及其它上下文，封裝成ctx，逐個呼叫handler閉包進行處理，最後分發函式返回值（反射）以及響應。請求響應相當於流水線上的一個商品，被一組當中的每個handler處理。路由註冊的過程，在完成之前的方法解析，path解析之後，就需要組裝一個handler鏈到路由了。

每一步先由api.relativePath和方法傳入的引數構成fullPath。

第二步然後新增handler，順序為：

• macroHandler，解析路徑中的引數值
• api.middleware，型別為[]handler
• anymiddleware，由app.Handle()方法傳入
• 控制器方法的對應閉包
• api.doneHandlers
• api的全域性handlers

第三步構建Route:

type Route struct {
        Name       string          `json:"name"`
        Method     string          `json:"method"`
        methodBckp string
        Subdomain  string          `json:"subdomain"`
        tmpl       *macro.Template
        beginHandlers context.Handlers
        Handlers        context.Handlers `json:"-"`
        MainHandlerName string           `json:"mainHandlerName"`
        doneHandlers context.Handlers
        Path         string `json:"path"`
        FormattedPath string `json:"formattedPath"`
}

Name格式為defaultName := method + subdomain + 未注值的路徑格式。其中路徑有三個相關變數：Subdomain Path FormattedPath。FormattedPath是將path中的:變數替換為%v。構建路由Router時將路徑解析的macroHandler，新增在最前面。

最後將路由註冊到app.APIBuilder.routes，型別為[]Route。

context資料結構

iris框架定義了handler閉包的操作物件context.context。不是指TCP的context，也不是net/http中的context。資料結構如下：

type context struct {
        id uint64
        writer ResponseWriter
        request *http.Request
        currentRouteName string

        app Application
        handlers Handlers
        currentHandlerIndex int
}

前文已經提過，由於反射欄位的不可複用性，造成go的反射效率下降。如果處理每次的請求都要在執行時重新構建context，就會降低效能。iris用c.pool儲存ctx，實現ctx的可複用。c.pool的型別是sync.pool。id確定ctx的唯一性，方便儲存在c.pool集合中。request writer都是net/http標準庫的型別，直接傳遞。

params RequestParams 是一個專用的KV儲存，型別為[string]interface{}。用來儲存path param。values用來儲存其它KV資訊。

app引用自iris例項，可以獲取全部的例項欄位。其中路由資訊單獨拿出：currentRouteName路由名，對應c.routes的鍵。路由handlers，currentHandlerIndex。

ctx是可複用的，需要構建ctx時，不是初始化而是直接從池中拿一個例項。空例項僅配置了app欄位。第一步包裝net/http包的(w,*r)。第二步根據request確定路由資訊，並賦到ctx相應欄位。第三步會執行流水線式地Do(handlers)，反射呼叫得到響應資訊，並寫入到ctx中。最後一步將針對特定http請求的資訊清掉，並放回c.pool。

標準庫中的net/http Request

type Request struct {
    Method string

    URL *url.URL

    Header Header

    Body io.ReadCloser

    GetBody func() (io.ReadCloser, error)

    ContentLength int64

    TransferEncoding []string

    Close bool

    Host string

    Form url.Values

    PostForm url.Values

    MultipartForm *multipart.Form

    Trailer Header

    RemoteAddr string

    RequestURI string

    TLS *tls.ConnectionState

    Cancel <-chan struct{}

    Response *Response

    ctx context.Context
}

標準庫net/http Response

type Response struct {
    Status     string 
    StatusCode int    
    Proto      string 
    ProtoMajor int    
    ProtoMinor int    

    Header Header

    Body io.ReadCloser

    ContentLength int64

    TransferEncoding []string

    Close bool

    Uncompressed bool

    Trailer Header

    Request *Request

    TLS *tls.ConnectionState
}