在现代 Web 开发中,实时通信需求日益增长,WebSocket 成为构建实时应用的核心技术。然而,Go 语言原生的 WebSocket 开发方式往往繁琐且容易出错。为了解决这一痛点,我们推出了 fun 框架------一个专为 Go 语言设计的现代化 WebSocket 框架,让实时应用开发变得简单、高效且优雅。
什么是 fun 框架?
fun 是一个基于 Gorilla WebSocket 构建的 Go 语言框架,它提供了服务绑定、依赖注入、参数验证、日志记录等丰富功能。fun 框架专注于简化 WebSocket 应用开发,通过自动生成 TypeScript 客户端代码,实现前后端开发的无缝协作。
fun 框架的核心优势
1. 极简的开发体验
通过结构化的服务定义和方法绑定,fun 让开发者能够以最自然的方式编写业务逻辑,无需关心底层 WebSocket 的复杂细节。
go
// 定义服务结构体
type HelloService struct {
fun.Ctx // 必须嵌入 Ctx
}
// 定义 DTO
type HelloDto struct {
Name string
}
// 定义方法
func (s *HelloService) Hello(dto HelloDto) string {
return "Hello, " + dto.Name
}
func main() {
// 绑定服务
fun.BindService(HelloService{})
// 启动服务
fun.Start(3000)
}
2. 强大的依赖注入系统
fun 内置自动依赖注入功能,通过简单的标签即可实现服务间的依赖管理,大大降低了代码耦合度。
go
type UserService struct {
fun.Ctx
Repo *Repository `fun:"auto"` // 自动注入
}
3. 完善的参数验证机制
集成 validator.v10,支持丰富的验证规则,确保数据的安全性和有效性。
go
type UserDto struct {
Name string `validate:"required"`
Email string `validate:"required,email"`
Age int `validate:"min=0,max=150"`
}
4. 自动生成 TypeScript 客户端
fun 框架能够自动生成类型安全的 TypeScript 客户端代码,实现前后端类型一致性,提升开发效率。
typescript
import fun from "./gen/ts/fun";
// 创建客户端实例
const client = fun.create("ws://localhost:3000");
// 调用服务方法
const result = await client.helloService.hello({ name: "World" });
console.log(result); // "Hello, World"
5. 灵活的守卫机制
类似中间件的守卫机制,可用于实现鉴权、日志记录等横切关注点。
go
type AuthGuard struct {
// 依赖...
}
func (g *AuthGuard) Guard(ctx fun.Ctx) {
// 鉴权逻辑
// 失败时可以 panic 错误
}
// 绑定全局守卫
fun.BindGuard(AuthGuard{})
6. 支持长连接和主动推送
通过代理模式,服务端可以主动向客户端推送数据,满足实时通信场景的需求。
go
func (s *UserService) Subscribe(dto SubscribeDto, close fun.ProxyClose) *chan string {
ch := make(chan string)
// 处理关闭回调
close(func() {
close(ch)
})
go func() {
for {
select {
case msg := <-ch:
s.Push(s.Id, s.RequestId, msg) // 推送数据
}
}
}()
return &ch
}
为什么选择 fun 框架?
- 高效开发:通过自动生成代码和结构化设计,显著提升开发效率
- 类型安全:Go 和 TypeScript 的强类型系统确保运行时安全
- 易于维护:清晰的架构和自动化的代码生成降低维护成本
- 生态完善:基于成熟的技术栈,拥有丰富的社区支持
- 零学习成本:对于熟悉 Go 语言的开发者来说,几乎无需额外学习
快速开始
只需几个简单步骤,即可开始使用 fun 框架:
bash
# 安装
go get github.com/chiyikj/fun
# 创建 main.go
# (参考上面的示例代码)
# 运行服务
go run main.go
# 生成客户端代码
fun.Gen()
结语
fun 框架致力于让 Go 语言的 WebSocket 开发变得更加简单和高效。无论你是构建实时聊天应用、在线游戏还是实时数据监控系统,fun 都能为你提供强大的支持。立即体验 fun 框架,开启你的现代化 WebSocket 开发之旅!