web 是一个比较完整的 API 开发框架，相对于简单的路由，提供了更多的便利功能。 如果你只是需要一个简单的路由工具，那么你可以移步到 mux。
package main import "github.com/issue9/web" import "github.com/issue9/web/server" // main.go func main() { srv, err := server.New("web", "1.0.0", &server.Options{}) router := srv.Routers().New() router.Get("/admins", getAdmins). Get("/groups", getGroups) srv.Serve() } func getAdmins(ctx* web.Context) web.Responser { return ctx.NotImplemented() } func getGroups(ctx* web.Context) web.Responser { return ctx.NotImplemented() }
https://www.iana.org/assignments/character-sets/character-sets.xhtml 中列出的字符集都能自动转换。
文档类型由 Server.Mimetypes 指定。
package main import ( "github.com/issue9/web" "github.com/issue9/web/server" "github.com/issue9/web/mimetype/json" "github.com/issue9/web/mimetype/xml" ) srv := server.New("app", "1.0.0", &server.Options{ Codec: web.NewCodec(). AddMimetype(xml.Mimetype, json.Marshal, json.Unmarshal, xml.ProblemMimetype, true, true). AddMimetype(xml.Mimetype, xml.Marshal, xml.Unmarshal, xml.ProblemMimetype, true, true) } }) srv.Serve()
客户端只要在请求时设置 Accept 报头就可返回相应类型的数据，而 Accept-Charset 报头可设置接收的字符集。 Content-Type 则可以有向服务器指定提交内容的文档类型和字符集。
框架根据 RFC7807 提供了一种输出错误信息内容的机制。
在处理出错时，调用 Context.Problem 即可：
func getAdmins(ctx* web.Context) web.Responser { return ctx.Problem(web.ProblemBadRequest).WithParam("param", "invalid format") }
可直接在添加 API 的中间件上指定文档内容：
srv := server.New("app", "1.0.0", ...) router := s.Routers().New(...) doc := openapi.New(srv, web.Phrase("title")) // 声明文档对象 router.Get("/admins", getAdmins, doc.API(func(o* openapi.Operation){ o.Desc(web.Phrase("desc of api")). // 接口的描述 Body(). // 请求内容 Response() // 指定返回内容 })) router.Get("/openapi", doc.Handler()) // 将文档以接口的形式输出
- https://github.com/issue9/webuse 提供了中间件、插件、过滤器等常用的功能。