gf/g/net/ghttp/ghttp_request.go

// Copyright 2017 gf Author(https://gitee.com/johng/gf). All Rights Reserved.
//
// This Source Code Form is subject to the terms of the MIT License.
// If a copy of the MIT was not distributed with this file,
// You can obtain one at https://gitee.com/johng/gf.

package ghttp

import (
    "io/ioutil"
    "net/http"
    "gitee.com/johng/gf/g/encoding/gjson"
    "gitee.com/johng/gf/g/container/gtype"
    "gitee.com/johng/gf/g/util/gregex"
    "gitee.com/johng/gf/g/os/gtime"
)

// 请求对象
type Request struct {
    http.Request
    parsedGet  *gtype.Bool         // GET参数是否已经解析
    parsedPost *gtype.Bool         // POST参数是否已经解析
    queryVars  map[string][]string // GET参数
    routerVars map[string][]string // 路由解析参数
    exit       *gtype.Bool         // 是否退出当前请求流程执行
    Id         int                 // 请求id(唯一)
    Server     *Server             // 请求关联的服务器对象
    Cookie     *Cookie             // 与当前请求绑定的Cookie对象(并发安全)
    Session    *Session            // 与当前请求绑定的Session对象(并发安全)
    Response   *Response           // 对应请求的返回数据操作对象
    Router     *Router             // 匹配到的路由对象
    EnterTime  int64               // 请求进入时间(微秒)
    LeaveTime  int64               // 请求完成时间(微秒)
    Param      interface{}         // 开发者自定义参数
    parsedHost *gtype.String       // 解析过后不带端口号的服务器域名名称
    clientIp   *gtype.String       // 解析过后的客户端IP地址
}

// 创建一个Request对象
func newRequest(s *Server, r *http.Request, w http.ResponseWriter) *Request {
    request := &Request{
        parsedGet  : gtype.NewBool(),
        parsedPost : gtype.NewBool(),
        queryVars  : make(map[string][]string),
        routerVars : make(map[string][]string),
        exit       : gtype.NewBool(),
        Id         : s.servedCount.Add(1),
        Server     : s,
        Request    : *r,
        Response   : newResponse(w),
        EnterTime  : gtime.Microsecond(),
        parsedHost : gtype.NewString(),
        clientIp   : gtype.NewString(),
    }
    // 会话处理
    request.Cookie           = GetCookie(request)
    request.Session          = GetSession(request)
    request.Response.request = request
    return request
}

// 获取Web Socket连接对象
func (r *Request) WebSocket() (*WebSocket, error) {
    if conn, err := wsUpgrader.Upgrade(r.Response.ResponseWriter.ResponseWriter, &r.Request, nil); err == nil {
        return &WebSocket {
            conn,
        }, nil
    } else {
        return nil, err
    }
}

// 获得指定名称的参数字符串(Router/GET/POST)，同 GetRequestString
// 这是常用方法的简化别名
func (r *Request) Get(k string) string {
    return r.GetRequestString(k)
}

// 获取原始请求输入字符串，注意：只能获取一次，读完就没了
func (r *Request) GetRaw() []byte {
    result, _ := ioutil.ReadAll(r.Body)
    return result
}

// 获取原始json请求输入字符串，并解析为json对象
func (r *Request) GetJson() *gjson.Json {
    data := r.GetRaw()
    if data != nil {
        if j, err := gjson.DecodeToJson(data); err == nil {
            return j
        }
    }
    return nil
}

// 退出当前请求执行，原理是在Request.exit做标记，由服务逻辑流程做判断，自行停止
func (r *Request) Exit() {
    r.exit.Set(true)
}

// 判断当前请求是否停止执行
func (r *Request) IsExited() bool {
    return r.exit.Val()
}

// 获取请求的服务端IP/域名
func (r *Request) GetHost() string {
    host := r.parsedHost.Val()
    if len(host) == 0 {
        array, _ := gregex.MatchString(`(.+):(\d+)`, r.Host)
        if len(array) > 1 {
            host = array[1]
        } else {
            host = r.Host
        }
        r.parsedHost.Set(host)
    }
    return host
}

// 获取请求的客户端IP地址
func (r *Request) GetClientIp() string {
    ip := r.clientIp.Val()
    if len(ip) == 0 {
        array, _ := gregex.MatchString(`(.+):(\d+)`, r.RemoteAddr)
        if len(array) > 1 {
            ip = array[1]
        } else {
            ip = r.RemoteAddr
        }
        r.clientIp.Set(ip)
    }
    return ip
}