欢迎光临
我们一直在努力

Goweb精讲

以下是 goweb 模块的重点介绍:

—

 goweb 模块全景
goweb 是 leijmdas Go 全家桶中对标 Spring Boot Web / Spring MVC 的核心 Web 框架模块,基于 Gin 进行企业级封装,提供路由、中间件、权限控制、DB/ES 操作、分页查询等完整能力。

—

 一、模块结构总览
goweb/
├── base/           # 常量定义
├── dto/            # 查询与排序对象
├── generaldb/      # 通用 DB 操作泛型实现
│   ├── generaldao/    # DAO 操作
│   └── generaliface/  # 接口定义
├── iface/          # goweb 接口
├── meta/           # 元数据操作(DB表、ES索引)
├── model/          # 模型示例
├── page/           # 分页查询请求与响应
├── pagedb/         # 表分页相关操作
├── pagees/         # ES 分页相关操作
├── pagemodel/      # 分页泛型定义
├── pagereq/        # 统一 ES 服务请求/响应
├── pagesimple/     # 简单分页对象封装
├── pageui/         # 返回前端分页显示格式
├── pageuimodel/    # 返回前端分页显示格式-泛型
├── ruleengine/     # 规则引擎数据结构
├── webclient/      # WEB 客户端
│   ├── eswebclient/   # ES 客户端
│   ├── webclient/     # 通用 Web 客户端
│   └── rulewebclient/ # 规则引擎客户端
├── webright/       # 权限控制
│   ├── webcheck/      # 权限检查主控入口
│   ├── webcustome/    # 权限自定义实现
│   └── webconsts/     # WEB 常量与配置
├── webdto/         # 权限 DTO 对象
├── webiface/       # 权限接口定义
├── webserver/      # WEB 路由、服务端
└── wso2agent/      # 对接 WSO2 接口

—

 二、核心能力详解
 1. WebServer — 路由与服务端
webserver 是 Web 服务的核心入口,基于 Gin 封装,提供类似 Spring Boot 的启动方式。
启动流程示例:
func StartWeb() {
    InjectMiddleware()                    // 注入中间件
    service.Init()                         // 初始化服务
    var config = ichubconfig.FindBeanIchubConfig()
    serverDto := config.ReadWebServer()    // 读取 Web 配置
    var server = webserver.New(serverDto)  // 创建服务端
    server.StartWebSwagger(router.Swagger, router.Register)  // 启动 + Swagger
}

中间件链(对标 Spring HandlerInterceptor):
func (this *WebRouters) InstallMiddleWare(router *gin.Engine) *gin.Engine {
    // 鉴权中间件(preHandle)
    router.Use(webmiddlewares.CheckSessionToken(), webmiddlewares.CheckAllowed())
    // 业务中间件
    router.Use(webmiddlewares.WebMiddleware()…)
    // 基础中间件
    router.Use(middleware.RequestID(), middleware.Context(), gin.Recovery(), middleware.Cors())
    // Gzip 压缩
    router.Use(gzip.Gzip(gzip.DefaultCompression))
    this.AddRouter(router)
    return router
}

权限注入(对标 Spring Security):
func InjectMiddleware() {
    // 注册鉴权 RPC 代理
    webcheck.FindBeanWebCheckRight().RegisterIrpc(authproxy.FindBeanAuthProxy())
    // 注册业务中间件
    webcheck.FindBeanWebCheckRight().RegisterMiddlewares(handlerfunc.WebExampleMiddleware())
}

—

 2. GeneralDB — 泛型 DAO 层
generaldb 是 goweb 的核心亮点,基于 Go 泛型实现了通用的 CRUD 操作,对标 Spring Data JPA。
查询接口:
方法    说明
FindById(pkey P) (entity E, found bool, err error)    根据主键查询
FindByIds(pks string) (*[]E, error)    批量主键查询
Query() *page.PageResult    分页查询
QueryModel() *pagemodel.PageResult[E]    泛型分页查询
QueryPageui() *pageui.PageuiResult    UI 格式分页
Count() (int, error)    计数
更新接口:
方法    说明
Insert(entity E) (P, error)    插入
DeleteById(pkey P) error    按主键删除
Save(entity E) (P, error)    保存(插入或更新)
Update(entity E) (P, error)    更新
UpdateNotNull(pkey P, maps map[string]any) (P, error)    非空字段更新
UpdateMap(pkey P, maps map[string]interface{}) (P, error)    Map 更新
泛型定义:
type GeneralDaoQueryIface[P GoPkey, E IBaseModel[P]]

—

 3. DbWebReq — 基于泛型的通用 DB 客户端
dbwebreq 是对 generaldb 的进一步封装,提供链式调用风格的 DB 操作客户端。
使用示例:
// 创建请求对象(泛型指定实体类型)
var req = dbwebreq.Default[*model.ServiceApiList]()
req.SetPageSize(2)
req.Eq("id", 1014952995308011523)

// 通用查询
var result = req.GeneralQuery()

// 分页查询
var result = req.Query()

// 按主键查找
var result = req.Find(1012572619744575491)

// 插入
var record = &model.ServiceApiList{Name: "song"}
var result = req.Save(record)

// 更新(按主键)
var result = req.Update(&model.ServiceApiList{Name: "leijmdas"}, 1014848431407104003)

// 非空更新
var result = req.UpdateNotNull(&model.ServiceApiList{Name: "leijmdas11111"}, 1014848431407104003)

// Map 更新
var result = req.UpdateMap(map[string]any{"name": "leijmdas", "http_method": "get"}, 1014854303687802883)

// 删除
var result = req.Delete(1014847422142676995)

// 条件删除
req.Eq("id", 1014854303687802883)
var result = req.DeleteWhere()

// 自动迁移表结构
var result = req.Automigrate()

// 元数据查询
var result = req.MetaQuery()

// 分组统计
var result = req.GroupStat("id", "id")

// 统计
var result = req.Stat("id")

核心结构:
type DbWebReq[T schema.Tabler] struct {
    basedto.BaseEntity
    *pagedb.PageDbWebRequest
    DbWebClient *dbwebclient.DbWebClient
}

—

 4. WebClient — 远程调用客户端
webclient 提供对远程 Web 服务的调用能力,支持:
– 通用 Web 客户端调用
– ES 专用客户端 (eswebclient)
– 规则引擎客户端 (rulewebclient)

—

 5. 分页体系
goweb 提供了多层分页封装,适配不同场景:
包    用途
page    基础分页请求/响应
pagedb    DB 表分页操作
pagees    ES 分页操作
pagemodel    泛型分页对象
pagesimple    简单分页封装
pageui    前端 UI 显示格式
pageuimodel    前端 UI 泛型格式
pagereq    统一 ES 服务请求/响应

—

 6. 权限控制 (webright)
组件    功能
webcheck    权限检查主控入口
webcustome    自定义权限实现
webconsts    WEB 常量与配置
webdto    权限 DTO(WebCheckRequest, WebCheckResult, WebUserId 等)
webiface    权限接口(IrpcCheckAllowed 生产端, IwebCheckAllowed 消费端)

—

 三、与 Spring 生态对标
goweb 组件    Spring 对应    说明
webserver    Spring Boot Web / Spring MVC    Web 服务端
generaldb    Spring Data JPA    泛型 DAO
webright    Spring Security    权限控制
webclient    RestTemplate / WebClient    远程调用
middleware    HandlerInterceptor    中间件链
pagereq    Spring Data Elasticsearch    ES 统一查询

—

 四、快速使用
import "gitee.com/gowebframe3/webframe/goweb"

// 1. 启动 Web 服务
server := webserver.New(serverDto)
server.StartWebSwagger(router.Swagger, router.Register)

// 2. 泛型 DB 操作
req := dbwebreq.Default[*MyModel]()
req.SetPageSize(10).Eq("status", 1)
result := req.Query()

// 3. 权限检查
webcheck.FindBeanWebCheckRight().CheckAllowed(ctx, request)

—

如果你需要深入了解某个具体子模块(比如 generaldb 的泛型实现原理、webserver 的路由注册细节、或者 dbwebreq 的链式 API 设计),可以继续问我。
 

赞(0)
未经允许不得转载:171主机测评 » Goweb精讲
分享到: 更多 (0)

评论 抢沙发

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址