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()
}