网站免费建站,网站建设目标的管理可行性,专业做公司网站,成都建设学校网站〇、前言
Context 是 gin 中最重要的部分。 例如#xff0c;它允许我们在中间件之间传递变量、管理流程、验证请求的 JSON 并呈现 JSON 响应。
Context 中封装了原生的 Go HTTP 请求和响应对象#xff0c;同时还提供了一些方法#xff0c;用于获取请求和响应的信息、设置响…〇、前言
Context 是 gin 中最重要的部分。 例如它允许我们在中间件之间传递变量、管理流程、验证请求的 JSON 并呈现 JSON 响应。
Context 中封装了原生的 Go HTTP 请求和响应对象同时还提供了一些方法用于获取请求和响应的信息、设置响应头、设置响应状态码等操作。
在 Gin 中Context 是通过中间件来传递的。在处理 HTTP 请求时Gin 会依次执行注册的中间件每个中间件可以对 Context 进行一些操作然后将 Context 传递给下一个中间件。
一、gin.Context 结构
type Context struct {writermem responseWriterRequest *http.RequestWriter ResponseWriterParams Paramshandlers HandlersChainindex int8fullPath stringengine *Engineparams *ParamsskippedNodes *[]skippedNode// 该互斥锁保护键映射。mu sync.RWMutex// Keys 是专门用于每个请求上下文的键/值对。Keys map[string]any// 错误是附加到使用此上下文的所有处理程序/中间件的错误列表。Errors errorMsgs// 已接受定义了用于内容协商的手动接受格式的列表。Accepted []string// queryCache 缓存 c.Request.URL.Query() 的查询结果。queryCache url.Values// formCache 缓存 c.Request.PostForm其中包含从 POST、PATCH 或 PUT 正文参数解析的表单数据。 formCache url.Values// SameSite 允许服务器定义 cookie 属性从而使浏览器无法随跨站点请求发送此 cookie。sameSite http.SameSite
}这里面需要重点关注的的几个字段就是 writermem responseWriterRequest *http.RequestWriter ResponseWriterParams Paramsparams *Params
1、writermem responseWriter
type responseWriter struct {http.ResponseWritersize intstatus int
}responseWriter 包含了一个 interface 类型 ResponseWriter
type ResponseWriter interface {// Header returns the header map that will be sent by WriteHeader.Header() Header// Write writes the data to the connection as part of an HTTP reply.Write([]byte) (int, error)// WriteHeader sends an HTTP response header with the provided status code.WriteHeader(statusCode int)
}2、Request *http.Request
Request 表示服务器接收到并由客户端发送的 HTTP 请求这也是一个复杂的结构
type Request struct {Method stringURL *url.URLProto stringProtoMajor intProtoMinor intHeader HeaderBody io.ReadCloserGetBody func() (io.ReadCloser, error)ContentLength int64TransferEncoding []stringClose boolHost stringForm url.ValuesPostForm url.ValuesMultipartForm *multipart.FormTrailer HeaderRemoteAddr stringRequestURI stringTLS *tls.ConnectionStateCancel -chan struct{}Response *Responsectx context.Context
}可以看到里面提供了各种我们常用的字段 Method stringURL *url.URLHeader HeaderHost stringForm url.ValuesPostForm url.ValuesResponse *Responsectx context.Context看到这里有一个 *Response
type Response struct {Status stringStatusCode intProto stringProtoMajor intProtoMinor intHeader HeaderBody io.ReadCloserContentLength int64TransferEncoding []stringClose boolUncompressed boolTrailer HeaderRequest *RequestTLS *tls.ConnectionState
}关于Response是导致创建此请求的重定向响应该字段仅在客户端重定向期间填充。看到这儿就放心了不然也太繁杂了。
关于 Context上下文携带截止日期、取消信号和跨 API 边界的其他值。 Context 的方法可以同时被多个 goroutine 调用。
context.Context是 Go 标准库中的一个接口类型用于在 Goroutine 之间传递上下文信息。
context.Context 可以在 Goroutine 之间传递信息例如传递请求 ID、数据库连接、请求超时等信息。context.Context 的具体实现是由各种库和框架提供的Gin 框架中提供了一个 gin.Context 的实现用于在 Gin 框架中使用 context.Context。
type Context interface {// 返回时间Deadline() (deadline time.Time, ok bool)Done() -chan struct{}Err() errorValue(key any) any
}这个 Context 依然是一个 interfaceinterface 的优点很明显能简化结构只需要写清楚使用协议就好。
3、Writer ResponseWriter
这个也是一个接口它提供了一系列方法来写请求内容什么的
type ResponseWriter interface {http.ResponseWriterhttp.Hijackerhttp.Flusherhttp.CloseNotifierStatus() intSize() intWriteString(string) (int, error)Written() boolWriteHeaderNow()Pusher() http.Pusher
}比如
func (w *responseWriter) Write(data []byte) (n int, err error) {w.WriteHeaderNow()n, err w.ResponseWriter.Write(data)w.size nreturn
}func (w *responseWriter) WriteString(s string) (n int, err error) {w.WriteHeaderNow()n, err io.WriteString(w.ResponseWriter, s)w.size nreturn
}func (w *responseWriter) Status() int {return w.status
}
...
4、Params Params
首先
type Param struct {Key stringValue string
}
...type Params []Param可以看到 Params 是Param的 sliceparams 则是字段 Params 的一个指针方便参数传递避免值拷贝。
它有一些方法 func (ps Params) Get(name string) (string, bool) {for _, entry : range ps {if entry.Key name {return entry.Value, true}}return , false
}
func (ps Params) ByName(name string) (va string) {va, _ ps.Get(name)return
}通过 Get() 可以获取参数列表中的某个参数。
二、gin.Context 的功能
它提供的大量的方法。gin.Context 是 Gin 框架中的一个结构体类型用于封装 HTTP 请求和响应的信息以及提供一些方法用于获取请求和响应的信息、设置响应头、设置响应状态码等操作。gin.Context 只在 Gin 框架内部使用用于处理 HTTP 请求和响应。它与 HTTP 请求和响应一一对应每个 HTTP 请求都会创建一个新的 gin.Context 对象并在处理过程中传递。
BindWith(obj any, b binding.Binding) error
reset()
Copy() *gin.Context
HandlerName() string
HandlerNames() []string
Handler() gin.HandlerFunc
FullPath() string
Next()
IsAborted() bool
Abort()
AbortWithStatus(code int)
AbortWithStatusJSON(code int, jsonObj any)
AbortWithError(code int, err error) *gin.Error
Error(err error) *gin.Error
Set(key string, value any)
Get(key string) (value any, exists bool)
MustGet(key string) any
GetString(key string) (s string)
GetBool(key string) (b bool)
GetInt(key string) (i int)
GetInt64(key string) (i64 int64)
GetUint(key string) (ui uint)
GetUint64(key string) (ui64 uint64)
GetFloat64(key string) (f64 float64)
GetTime(key string) (t time.Time)
GetDuration(key string) (d time.Duration)
GetStringSlice(key string) (ss []string)
GetStringMap(key string) (sm map[string]any)
GetStringMapString(key string) (sms map[string]string)
GetStringMapStringSlice(key string) (smss map[string][]string)
Param(key string) string
AddParam(key string, value string)
Query(key string) (value string)
DefaultQuery(key string, defaultValue string) string
GetQuery(key string) (string, bool)
QueryArray(key string) (values []string)
initQueryCache()
GetQueryArray(key string) (values []string, ok bool)
QueryMap(key string) (dicts map[string]string)
GetQueryMap(key string) (map[string]string, bool)
PostForm(key string) (value string)
DefaultPostForm(key string, defaultValue string) string
GetPostForm(key string) (string, bool)
PostFormArray(key string) (values []string)
initFormCache()
GetPostFormArray(key string) (values []string, ok bool)
PostFormMap(key string) (dicts map[string]string)
GetPostFormMap(key string) (map[string]string, bool)
get(m map[string][]string, key string) (map[string]string, bool)
FormFile(name string) (*multipart.FileHeader, error)
MultipartForm() (*multipart.Form, error)
SaveUploadedFile(file *multipart.FileHeader, dst string) error
Bind(obj any) error
BindJSON(obj any) error
BindXML(obj any) error
BindQuery(obj any) error
BindYAML(obj any) error
BindTOML(obj any) error
BindHeader(obj any) error
BindUri(obj any) error
MustBindWith(obj any, b binding.Binding) error
ShouldBind(obj any) error
ShouldBindJSON(obj any) error
ShouldBindXML(obj any) error
ShouldBindQuery(obj any) error
ShouldBindYAML(obj any) error
ShouldBindTOML(obj any) error
ShouldBindHeader(obj any) error
ShouldBindUri(obj any) error
ShouldBindWith(obj any, b binding.Binding) error
ShouldBindBodyWith(obj any, bb binding.BindingBody) (err error)
ClientIP() string
RemoteIP() string
ContentType() string
IsWebsocket() bool
requestHeader(key string) string
Status(code int)
Header(key string, value string)
GetHeader(key string) string
GetRawData() ([]byte, error)
SetSameSite(samesite http.SameSite)
SetCookie(name string, value string, maxAge int, path string, domain string, secure bool, httpOnly bool)
Cookie(name string) (string, error)
Render(code int, r render.Render)
HTML(code int, name string, obj any)
IndentedJSON(code int, obj any)
SecureJSON(code int, obj any)
JSONP(code int, obj any)
JSON(code int, obj any)
AsciiJSON(code int, obj any)
PureJSON(code int, obj any)
XML(code int, obj any)
YAML(code int, obj any)
TOML(code int, obj any)
ProtoBuf(code int, obj any)
String(code int, format string, values ...any)
Redirect(code int, location string)
Data(code int, contentType string, data []byte)
DataFromReader(code int, contentLength int64, contentType string, reader io.Reader, extraHeaders map[string]string)
File(filepath string)
FileFromFS(filepath string, fs http.FileSystem)
FileAttachment(filepath string, filename string)
SSEvent(name string, message any)
Stream(step func(w io.Writer) bool) bool
Negotiate(code int, config gin.Negotiate)
NegotiateFormat(offered ...string) string
SetAccepted(formats ...string)
hasRequestContext() bool
Deadline() (deadline time.Time, ok bool)
Done() -chan struct{}
Err() error
Value(key any) any以上就是 gin.Context的大致结构和功能。
全文完感谢阅读。
