Golang Go语言-Spring v1.2.0 发布，新增 Web 开发支持

Go-Spring v1.2.0 新增 web 服务器支持，底层路由器基于mux实现，旨在提供更加简单易用的开发体验。

特性：

• 自动根据 ContentType 绑定模型（类似 gin 框架手动 ctx.BindJSON 类操作）
• 自动根据函数输出类型输出 （类似 gin 框架手动调用 ctx.JSON 类接口）
• 支持从 path/header/cookie/from/body绑定输入参数
• 支持绑定文件，上传文件处理更简单（见下面例子）
• 支持全局输出格式自定义与路由级别的自定义输出（默认以 json 输出）
• 支持自定义参数校验器（内置 expr 表达式校验器）
• 开放内部 Bind 接口，一行代码为所有基于标准库方案的 http 服务器添加上述能力

支持绑定的函数形式 （将下列函数转换为 http.HandlerFunc ）：

• func(ctx context.Context)
• func(ctx context.Context) R
• func(ctx context.Context) error
• func(ctx context.Context, req T) R
• func(ctx context.Context, req T) error
• func(ctx context.Context, req T) (R, error)

友情提示：web 包不依赖 go-spring 容器，可以单独使用 (下方有例子) 😀

Demo 代码：

package main
import (
“context”
“log/slog”
“math/rand”
“mime/multipart”
“net/http”
“time”
"github.com/go-spring-projects/go-spring/gs"
"github.com/go-spring-projects/go-spring/web"
_ "github.com/go-spring-projects/go-spring/web/starter"
)
type Greeting struct {
Logger *slog.Logger logger:""
Server *web.Server  autowire:""
}
func (g *Greeting) OnInit(ctx context.Context) error {
g.Server.Get("/greeting", g.Greeting)
g.Server.Get("/health", g.Health)
g.Server.Post("/user/register/{username}/{password}", g.Register)
g.Server.Post("/user/password", g.UpdatePassword)
return nil
}
func (g *Greeting) Greeting(ctx context.Context) string {
web.FromContext(ctx).
SetCookie(“token”, “1234567890”, 500, “”, “”, false, false)
return “greeting!!!”
}
func (g *Greeting) Health(ctx context.Context) error {
if 0 == rand.Int()%2 {
return web.Error(400, “health check failed”)
}
return nil
}
func (g *Greeting) Register(
ctx context.Context,
req struct {
Username  string                path:"username" expr:"len($)>6 && len($)<20"
Password  string                path:"password" expr:"len($)>6 && len($)<20"
HeadImg   *multipart.FileHeader form:"headImg"

Captcha   string                form:"captcha" expr:"len($)==4"

UserAgent string                header:"User-Agent"

Ad        string                query:"ad"

Token     string                cookie:"token"

},
) string {
g.Logger.Info(“register user”,
slog.String(“username”, req.Username),
slog.String(“password”, req.Password),
slog.String(“userAgent”, req.UserAgent),
slog.String(“headImg”, req.HeadImg.Filename),
slog.String(“captcha”, req.Captcha),
slog.String(“userAgent”, req.UserAgent),
slog.String(“ad”, req.Ad),
slog.String(“token”, req.Token),
)
return “ok”
}
func (g *Greeting) UpdatePassword(
ctx context.Context,
req struct {
Password string json:"password" expr:"len($) > 6 && len($) < 20" // password
Token    string cookie:"token"                                   // token
},
) string {
g.Logger.Info(“change password”, slog.String(“password”, req.Password))
return “ok”
}
func main() {
gs.Object(new(Greeting))
if err := gs.Run(); nil != err {
	panic(err)
}
}

单独使用 web 服务例子:

package main
import (
“context”
“log/slog”
“mime/multipart”
"github.com/go-spring-projects/go-spring/web"
)
func Greeting(ctx context.Context) string {
return “Greeting!!!”
}
func Feedback(
ctx context.Context,
req struct {
Title       string                  form:"title"        // 反馈标题
Message     string                  form:"message"      // 反馈说明
Attachments []*multipart.FileHeader form:"files"        // 上传附件文件列表
EMail       string                  form:"email"        // 联系邮箱
UserAgent   string                  header:"User-Agent" // 浏览器用户代理
},
) string {
slog.Info(“received user feedback”,
slog.String(“title”, req.Title),
slog.String(“message”, req.Message),
slog.String(“email”, req.EMail),
slog.String(“user-Agent”, req.UserAgent),
)
//TODO: save feedback to database.
//
return “Thanks for your feedback!!!”
}
func main() {
webSvr := web.NewServer(web.NewRouter(), web.Options{Addr: “:8080”})
webSvr.Get("/greeting", Greeting)
webSvr.Post("/feedback", Feedback)
webSvr.Run()
}