5.02 Context-Beego Context设计分析

Last updated 8 months ago

5.02 Context-Beego Context设计分析

PART1. Beego Context设计

1.1 `Context`

在之前的课程中说过,Beego的中,既有Input又有Request;既有Output又有ResponseWriter.很明显功能上是重叠的,道理上来讲,Input和Request留一个即可;Output和ResponseWriter留一个即可;或者将Request放到Input中,将ResponseWriter放到Output中.

type Context struct {
	Input          *BeegoInput
	Output         *BeegoOutput
	Request        *http.Request
	ResponseWriter *Response
	_xsrfToken     string
}

这样的设计,对于使用者而言,很难理解Input和Request、Output和ResponseWriter之间的区别和各自的使用场景.

其中:

Input:对输入的封装
Output:对输出的封装
ResponseWriter:对响应的封装

1.2 `BeegoInput`

type BeegoInput struct {
	Context       *Context
	CruSession    session.Store
	pnames        []string
	pvalues       []string
	data          map[interface{}]interface{}
	dataLock      sync.RWMutex
	RequestBody   []byte
	RunMethod     string
	RunController reflect.Type
}

BeegoInput.Context:反向引用了Context.而Context中也通过Input字段引用了BeegoInput,这种A引用B同时B引用A的场景在GO中是比较常见的设计
BeegoInput.CruSession:耦合了Session
BeegoInput.pnames:记录了参数路径的参数名
BeegoInput.pvalues:记录了参数路径的参数值
BeegoInput.data:记录了输入的数据(具体是啥我也不知道,没用过这个框架)

1.3 `BeegoOutput`

// BeegoOutput does work for sending response header.
type BeegoOutput struct {
	Context    *Context
	Status     int
	EnableGzip bool
}

BeegoOutput.Context:同样反向引用了Context
BeegoOutput.Status:HTTP响应码
BeegoOutput.EnableGzip:在写Response时是否启用Gzip压缩

1.4 `Response`

type Response struct {
	http.ResponseWriter
	Started bool
	Status  int
	Elapsed time.Duration
}

组合了原生的http.ResponseWriter
Response.Started:若该字段为true,则表示当前Response结构体实例已经被写入过了

PART2. Beego 处理输入的方法

2.1 负责处理来自`http.Request.Body`输入的方法

2.1.1 `Context`的Bind族方法

Context中的Bind族方法,用于将不同形式的Body转化为具体的结构体.

2.1.2 `Input`的`Bind()`方法

2.2 负责处理来自其他部位的方法

这些方法负责从http.Request的其他部位(例如Header、查询参数等)上获取输入

这里的GetData()中的data指的是其他Beego内部的其他组件或Middleware向BeegoInput.data中写入的数据

2.3 各种判断的方法

实际上这一类方法完全没必要提供,完全可以让用户自己判断,例如if method == http.MethodGet的方式去判断.

PART3. Beego 处理输出的方法

3.1 将输入序列化之后输出的方法

这一类方法(Resp族的方法)将入参data转化成对应的格式,然后输出到响应中

3.2 渲染模板输出的方法

这一类方法是在web.Controller结构体上的,用于渲染页面并输出

3.3 输出各种格式数据的方法

这一类方法是在context.BeegoOutput结构体上的,实际上3.1小节中的Resp族的方法,最终调用的是BeegoOutput上对应数据格式的方法.

而且,context.BeegoOutput还有一些直接输出Body(Body()方法)和Header(Header()方法)的方法.

也就是说,写响应时,可以使用Context,也可以使用Context.BeegoOutput,看自己喜好即可.当然,这也会导致框架的使用者会有不同的风格来控制输出.

Last updated 8 months ago

PART1. Beego Context设计

1.1 Context

1.2 BeegoInput

1.3 BeegoOutput

1.4 Response

PART2. Beego 处理输入的方法

2.1 负责处理来自http.Request.Body输入的方法

2.1.1 Context的Bind族方法

2.1.2 Input的Bind()方法

2.2 负责处理来自其他部位的方法

2.3 各种判断的方法

PART3. Beego 处理输出的方法

3.1 将输入序列化之后输出的方法

3.2 渲染模板输出的方法

3.3 输出各种格式数据的方法

PART1. Beego Context设计

1.1 Context

1.2 BeegoInput

1.3 BeegoOutput

1.4 Response

PART2. Beego 处理输入的方法

2.1 负责处理来自http.Request.Body输入的方法

2.1.1 Context的Bind族方法

2.1.2 Input的Bind()方法

2.2 负责处理来自其他部位的方法

2.3 各种判断的方法

PART3. Beego 处理输出的方法

3.1 将输入序列化之后输出的方法

3.2 渲染模板输出的方法

3.3 输出各种格式数据的方法

1.1 `Context`

1.2 `BeegoInput`

1.3 `BeegoOutput`

1.4 `Response`

2.1 负责处理来自`http.Request.Body`输入的方法

2.1.1 `Context`的Bind族方法

2.1.2 `Input`的`Bind()`方法

1.1 `Context`

1.2 `BeegoInput`

1.3 `BeegoOutput`

1.4 `Response`

2.1 负责处理来自`http.Request.Body`输入的方法

2.1.1 `Context`的Bind族方法

2.1.2 `Input`的`Bind()`方法