dcfd24b624
v1.0.3 定位为 bug fix release,收口 v1.0.2 引入的破坏性清理并修复 4 个轻量 bug + 依赖复查 + 版本号治理 + 文档对齐。同时包含此前未提交 的 v1.0.2 全部工作。 v1.0.3 变更: Fixed: - generateJTI 忽略 rand.Read 错误(jwt)— 改为 (string, error) 并传播 - QueryBuilder.Page Count 受残留 Limit 截断(repository)— countDB 加 Limit(-1).Offset(-1) - OSS/本地存储文件名冲突(storage)— 新增 uniqueFilename 加 8 字节随机后缀 - 数据库重试策略对不可恢复错误无效(database)— 新增 isTransientDBError Dependencies: - go mod tidy 补全 postgres 方言传递依赖;安全补丁升级 x/crypto v0.49→v0.53、golang-jwt/jwt/v5 v5.2.1→v5.3.1、gorilla/websocket v1.5.1→v1.5.3 Removed: - Breaking: 清理 v1.0.2 兼容别名(InitMySQL* / driverName) - 死代码 database.DBResolver - 代码中 292 行"评分/理由"自夸注释(#26,23 个文件) Changed: - Breaking: 错误码体系重构 CodeSuccess 1→0、CodeFail 0→1,删除 CodeInvalidParams,加编译期防撞码 - database/mysql.go → manager.go;Logger 拆分三独立 core 修复 Tee 重复写入 - 版本号常量化:app.go 新增 const Version 作为唯一来源,CLI/脚手架模板引用之,不再散落字面量 Security: - CORS 中间件按 W3C 规范修复 Allow-Credentials / Vary: Origin / 非白名单不回显 Added: - console 包显式 level 控制(SetLevel/WithLevel/LevelSilent,atomic.Int32 并发安全) - 新增测试 jwt/repository/storage/database/router/middleware/app - 文档:新增 CHANGELOG.md、Version_v1.0.2_report.md;更新 README/GUIDE 顶部更新日志 - 文档对齐:删除对不存在的 config.DefaultManager() getter 的描述(保持 API 与文档一致) 详见 CHANGELOG.md 与 README.md 更新日志。 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
83 lines
1.5 KiB
Go
83 lines
1.5 KiB
Go
package utils
|
||
|
||
import (
|
||
"net/url"
|
||
)
|
||
|
||
// URLBuilder URL 构建器
|
||
type URLBuilder struct {
|
||
u *url.URL
|
||
query url.Values
|
||
}
|
||
|
||
// ParseURL 解析 URL 字符串
|
||
func ParseURL(rawURL string) (*URLBuilder, error) {
|
||
u, err := url.Parse(rawURL)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
return &URLBuilder{
|
||
u: u,
|
||
query: u.Query(),
|
||
}, nil
|
||
}
|
||
|
||
// AddQuery 添加单个查询参数
|
||
func (b *URLBuilder) AddQuery(key, value string) *URLBuilder {
|
||
b.query.Add(key, value)
|
||
return b
|
||
}
|
||
|
||
// AddQueries 批量添加查询参数
|
||
func (b *URLBuilder) AddQueries(params map[string]string) *URLBuilder {
|
||
for k, v := range params {
|
||
b.query.Set(k, v)
|
||
}
|
||
return b
|
||
}
|
||
|
||
// SetQuery 设置查询参数(覆盖同名参数)
|
||
func (b *URLBuilder) SetQuery(key, value string) *URLBuilder {
|
||
b.query.Set(key, value)
|
||
return b
|
||
}
|
||
|
||
// SetPath 设置路径
|
||
func (b *URLBuilder) SetPath(path string) *URLBuilder {
|
||
b.u.Path = path
|
||
return b
|
||
}
|
||
|
||
// SetScheme 设置协议(http/https)
|
||
func (b *URLBuilder) SetScheme(scheme string) *URLBuilder {
|
||
b.u.Scheme = scheme
|
||
return b
|
||
}
|
||
|
||
// SetHost 设置主机
|
||
func (b *URLBuilder) SetHost(host string) *URLBuilder {
|
||
b.u.Host = host
|
||
return b
|
||
}
|
||
|
||
// Build 构建最终的 URL
|
||
func (b *URLBuilder) Build() *url.URL {
|
||
b.u.RawQuery = b.query.Encode()
|
||
return b.u
|
||
}
|
||
|
||
// String 返回 URL 字符串
|
||
func (b *URLBuilder) String() string {
|
||
return b.Build().String()
|
||
}
|
||
|
||
// URLEncode URL 编码
|
||
func URLEncode(s string) string {
|
||
return url.QueryEscape(s)
|
||
}
|
||
|
||
// URLDecode URL 解码
|
||
func URLDecode(s string) (string, error) {
|
||
return url.QueryUnescape(s)
|
||
}
|