dotweb——go语言的一个微型web框架(三)路由注册

简介: 上一章我们讲了如何启动一个dotweb程序,本篇文章将介绍如何注册路由。router是dotweb用来管理路由的结构体,它提供了一些关于路由操作函数。app := dotweb.New()router := app.HttpServer.Router()在上一篇文章中我们讲了dotweb.New()的用处,HttpServer负责处理请求,管理路由、session、中间件等等功能。

上一章我们讲了如何启动一个dotweb程序,本篇文章将介绍如何注册路由。

router是dotweb用来管理路由的结构体,它提供了一些关于路由操作函数。

app := dotweb.New()
router := app.HttpServer.Router()

在上一篇文章中我们讲了dotweb.New()的用处,HttpServer负责处理请求,管理路由、session、中间件等等功能。稍后我会介绍server对象。在这里我们获取路由对象也是通过httpserver获取。一般我们会声明一个函数,在该函数里注册路由,避免在main函数里有过多的代码。示例如下:

复制代码
func main(){
      app := dotweb.New()
      InitRouter(app.HttpServer)  
app.StartServer(8080)
} 

func InitRouter(hs *dotweb.HttpServer){
hs.Router().Get("/index", Index)
}

func Index(ctx *dotweb.HttpContext){
ctx.WitreString("Hello Dotweb!")
}
复制代码

 在以上示例中我们声明了一个名为 InitRouter 的函数,它将在main函数被执行,在 InitRouter函数里我们注册不同的路由,而 Index 函数被我们成为 UserHandler 它用来处理请求。上述代码将返回“Hello Dotweb!”字符串。

hs.Router().GET("/index",Index)//HttpGet请求
hs.Router().POST("/post",Post)//HttpPost请求
hs.Router().HEAD("/head",Head)//HttpHead请求
hs.Router().OPTIONS("/pptions",Options)//HttpOptions请求
hs.Router().PUT("/put",Put)//HttpPut请求
hs.Router().DELETE("/delete",Delete)//httpDelete请求

HTTP定义的请求方法一共有八种,除了上述六种还有TRACE和CONNECT两种。大部分场景下我们使用上述六种请求方法就可以满足项目需求,而RESTful Web API定义请求方法也不包含TRACE和CONNECT。虽然dotweb没有提供TEACE和CONNECT请求方法,但是它额外提供了四种。

hs.Router().Any("/any",Any)

Any函数表示你可以用任何请求方法请求该地址,如果是GET函数那么这个地址只能被GET方法的请求访问,但如果是Any函数你可以用GET请求也可以用POST请求、PUT请求等等。

hs.Router().HiJack("/hijack",Hijack)

HiJack使用的是GET方法请求,但是它又和普通的GET请求不同。它一般用于长连接,一般的请求不需要用到它。如果你想要了解更多的HiJack使用方法可以参考dotweb的姊妹项目—longweb。它为web程序提供长连接服务,github地址:https://github.com/devfeel/longweb。该项目实测百万长连接,如果你有需要可以参考或者使用该项目。它是免费、开源的。

hs.Router().ServerFile("/img/xxx.jpg","/webroot/img")//第一个参数表示路由地址,第二个参数表示服务器上文件地址

ServerFile用来访问静态文件。

hs.Router().RegisterRoute("WebSocket","/websocket",Websocket)

RegisterRoute可以注册以上所有类型的路由,方法类型由第一个参数区分,WebSocket需要用这种方法注册路由。

以上就是dotweb提供注册路由的函数,更多的路由注册方式你可以通过阅读源码得知。在此我解释下路由注册函数的两个形参,第一个是string类型的参数,它表示路由地址。假设本机地址是192.168.0.1,端口号为8080.如果参数为“/”则表示根地址,你输入192。168.0.1:8080就可以访问到。如果是“/index”它的地址是192.168.0.1:8080/index。dotweb还有一种叫做参数路由的路由配置,“/news/:id”这里的“:id”表示一个参数,如果你了解restful风格你就会明白这种配置方式的含义,当然这里的参数允许有多个“/news/:uid/:id”。第二个参数是一个形参为*dotweb.HttpContext的函数,它负责处理用户请求,参数表示当前请求的上下文,你可以通过它访问session、cache、request等等对象。

需要注意的是dotweb有个设置,如果你启动它那么所有非head的路由都将会被注册一个head方法的路由,它在需要验证请求是否可用的场景下非常有用,下面是启用方法,默认值为false。

app.HttpServer.SetEnabledAutoHEAD(true)

 

接下来我将介绍UserHandler,如果你有过javaweb或者asp.net mvc的开发经验那么UserHandler非常好理解,它就是控制器中的方法。你可以在这里做简单的CRUD也可以做复杂的业务处理,甚至你也可以在这里使用三层的设计。你可以把UserHandler都写到一个go文件中,也可以按照业务分到不同go文件中,事实上我建议你分开。我将在后续文章中介绍UserHandler的写法,实际上你掌握了dotweb.HttpContext的用法就可以去实现UserHandler。

当然在dotweb中也支持配置文件装载路由,我会在后续文章中专门写一篇介绍如何使用配置文件,在那里我会把dotweb的配置相关的介绍一遍。随着dotweb受到的关注越来越多更多的人参与到dotweb这个项目中来,我们一起努力完善增强dotweb,在此我希望你也能参与到dotweb中来,因为我们需要你的力量。项目地址:https://github.com/devfeel/dotweb,你可以在github项目地址中找到我们的官方QQ群,我们欢迎你加入dotweb大家庭。

目录
相关文章
|
8月前
|
编译器 Go
揭秘 Go 语言中空结构体的强大用法
Go 语言中的空结构体 `struct{}` 不包含任何字段,不占用内存空间。它在实际编程中有多种典型用法:1) 结合 map 实现集合(set)类型;2) 与 channel 搭配用于信号通知;3) 申请超大容量的 Slice 和 Array 以节省内存;4) 作为接口实现时明确表示不关注值。此外,需要注意的是,空结构体作为字段时可能会因内存对齐原因占用额外空间。建议将空结构体放在外层结构体的第一个字段以优化内存使用。
|
8月前
|
运维 监控 算法
监控局域网其他电脑:Go 语言迪杰斯特拉算法的高效应用
在信息化时代,监控局域网成为网络管理与安全防护的关键需求。本文探讨了迪杰斯特拉(Dijkstra)算法在监控局域网中的应用,通过计算最短路径优化数据传输和故障检测。文中提供了使用Go语言实现的代码例程,展示了如何高效地进行网络监控,确保局域网的稳定运行和数据安全。迪杰斯特拉算法能减少传输延迟和带宽消耗,及时发现并处理网络故障,适用于复杂网络环境下的管理和维护。
|
2月前
|
数据采集 Go API
Go语言实战案例:多协程并发下载网页内容
本文是《Go语言100个实战案例 · 网络与并发篇》第6篇,讲解如何使用 Goroutine 和 Channel 实现多协程并发抓取网页内容,提升网络请求效率。通过实战掌握高并发编程技巧,构建爬虫、内容聚合器等工具,涵盖 WaitGroup、超时控制、错误处理等核心知识点。
|
2月前
|
数据采集 JSON Go
Go语言实战案例:实现HTTP客户端请求并解析响应
本文是 Go 网络与并发实战系列的第 2 篇,详细介绍如何使用 Go 构建 HTTP 客户端,涵盖请求发送、响应解析、错误处理、Header 与 Body 提取等流程,并通过实战代码演示如何并发请求多个 URL,适合希望掌握 Go 网络编程基础的开发者。
|
3月前
|
JSON 前端开发 Go
Go语言实战:创建一个简单的 HTTP 服务器
本篇是《Go语言101实战》系列之一,讲解如何使用Go构建基础HTTP服务器。涵盖Go语言并发优势、HTTP服务搭建、路由处理、日志记录及测试方法,助你掌握高性能Web服务开发核心技能。
|
3月前
|
Go
如何在Go语言的HTTP请求中设置使用代理服务器
当使用特定的代理时,在某些情况下可能需要认证信息,认证信息可以在代理URL中提供,格式通常是:
261 0
|
4月前
|
开发框架 JSON 中间件
Go语言Web开发框架实践:路由、中间件、参数校验
Gin框架以其极简风格、强大路由管理、灵活中间件机制及参数绑定校验系统著称。本文详解其核心功能:1) 路由管理,支持分组与路径参数;2) 中间件机制,实现全局与局部控制;3) 参数绑定,涵盖多种来源;4) 结构体绑定与字段校验,确保数据合法性;5) 自定义校验器扩展功能;6) 统一错误处理提升用户体验。Gin以清晰模块化、流程可控及自动化校验等优势,成为开发者的优选工具。
|
4月前
|
JSON 编解码 API
Go语言网络编程:使用 net/http 构建 RESTful API
本章介绍如何使用 Go 语言的 `net/http` 标准库构建 RESTful API。内容涵盖 RESTful API 的基本概念及规范,包括 GET、POST、PUT 和 DELETE 方法的实现。通过定义用户数据结构和模拟数据库,逐步实现获取用户列表、创建用户、更新用户、删除用户的 HTTP 路由处理函数。同时提供辅助函数用于路径参数解析,并展示如何设置路由器启动服务。最后通过 curl 或 Postman 测试接口功能。章节总结了路由分发、JSON 编解码、方法区分、并发安全管理和路径参数解析等关键点,为更复杂需求推荐第三方框架如 Gin、Echo 和 Chi。
|
4月前
|
开发框架 JSON 中间件
Go语言Web开发框架实践:使用 Gin 快速构建 Web 服务
Gin 是一个高效、轻量级的 Go 语言 Web 框架,支持中间件机制,非常适合开发 RESTful API。本文从安装到进阶技巧全面解析 Gin 的使用:快速入门示例(Hello Gin)、定义 RESTful 用户服务(增删改查接口实现),以及推荐实践如参数校验、中间件和路由分组等。通过对比标准库 `net/http`,Gin 提供更简洁灵活的开发体验。此外,还推荐了 GORM、Viper、Zap 等配合使用的工具库,助力高效开发。