分析 web 框架
框架的设计原则:
- 高内聚,低耦合,便于维护和拓展
- 封装底层实现,使用更为便捷
- 封装重复性代码,减少代码编写量
- 提供常用工具类
框架的作用:
- 协调资源,比如数据库,文件,缓存等
- 资源抽象,用于表示资源,程序通过一个抽象的概念与资源进行交互
- 通信,资源之间需要进行沟通交流
- 约定,大家遵照框架的约定,有助于简化框架的实现
- 环境,框架需要支持不同的应用环境
- 最主要的目的,让开发人员专注于编写业务逻辑,而不用关心别的事情
1. 路由
当我们需要访问服务提供的资源的时候,我们需要使用类似这样的请求方式:
bash
GET http://localhost:8080/api/user/1- HTTP 是固定的,依据协议支持,用户可以自行访问 http 或者 https
- localhost 代表本机,实际上 ip 是 127.0.0.1,需要注意域名实际上也是 ip 地址
- 8080 是端口,ip 和端口才能定位一个服务,域名的默认端口是 80,可以不写
- GET 和 POST 是 http 的请求方式,类似的还有 PUT,DELETE,这些是我们程序需要支持的,同时是开发人员需要定义的
框架需要处理上方类似
/api/user/1这样的路径请求,并根据请求的方式将其转发到具体的业务逻辑代码,也就是说在请求的URL和处理的函数之间,搭建一个桥梁,将它们准确的关联起来,这就是路由
1.1 请求参数
在进行路由匹配的时候,往往我们需要将请求携带的参数进行对应的解析,以便于后续的程序的需要。
- 比如
?id=1代表get传参 /get/user/:id代表路径传参post传参中的json传参,以及文件传输等
正常框架还应该支持参数校验等功能
1.2 表单
请求参数的提交表单方式引用广泛,所以需要支持表单,通用需要支持表单参数校验
2. 处理器
路由的功能就是将请求路由到具体的Handler处理器中,在处理器中,我们需要处理请求request,并且处理响应response
应该提供完善的请求处理方式和响应方式
比如响应需要支持页面渲染,也需要支持json、xml和html等方式
3. 中间件
执行业务处理器的时候,往往需要再其前后进行一些功能的处理,但是并不希望入侵代码,这就是中间件的作用。
典型的有:
- 日志
- 错误处理
- 认证权限
- session
- 解析请求体等
4. ORM 支持
应该支持流行的ORM,比如gorm,xorm或者自己实现的orm
5. 工具
比如常用的工具类,或者命令行工具,可以便捷生成代码。
6. 配置项
将用到的第三方的工具或者框架,做成可配置的,便于使用者进行替换。
7. 插件
提供丰富的插件,可以便捷集成服务,比如sentinel go集成
8. http 协议支持
支持http https http2等
9. 内置模版
使用内置模版引擎提供模版渲染机制
