dqexweb

Overview ¶

Package dqexweb 提供 dqex Web UI + API 向宿主 gin engine 的挂载能力 （docs/library-api-design.md 6.5.1 主形态 B：宿主 Go 程序同进程内嵌，同源 iframe）。

库 API（github.com/fj1981/dqex）与 Web UI 同进程共享同一个 Service 实例： 库调用与页面操作看到同一份状态，连接经 ConnProvider/WithInlineConns 由宿主持有。

基本用法：

r := gin.New()
r.Use(hostAuthMiddleware) // 宿主登录态（鉴权外置，作用于 /dqex 子树即可）
client, _ := dqex.New(dqex.WithConnProvider(...))
dqexweb.Mount(r, client, dqexweb.MountOptions{
    Prefix:         "/dqex",
    FrameAncestors: []string{"https://host.example"}, // 允许宿主页面 iframe 嵌入
})
r.Run(":8080")
// 同源 iframe 嵌入（无 token/CORS/SameSite 问题）：
// <iframe src="/dqex/#/query"></iframe>
// 精简嵌入视图：<iframe src="/dqex/?embed=1#/embed/query"></iframe>