在 bookmark.yaml 配置文件中,为多个接口路径添加了 '401' 和 '403' 状态码的响应引用, 分别指向 components 中定义的 Unauthorized 和 Forbidden 响应。同时在 components 部分补充了 Forbidden 响应的定义,增强了 API 文档的完整性与规范性。 feat(user_np): 新增用户信息接口与基础错误结构定义 在 user_np.yaml 中新增了 /auth/info 路径下的 GET 和 PUT 接口,用于获取和保存用户信息。 同时,在 components 中定义了 ServerInternalError 响应和 Error 结构体,统一错误返回格式, 提升接口一致性与可维护性。 feat(vfs): 调整内容类型为 text/plain 并增强节点名称校验逻辑 将 vfs.yaml 中涉及二进制流传输的内容类型由 application/octet-stream 修改为 text/plain, 简化数据处理方式。同时在 vfs.go 模型中新增 CheckNameValid 方法,用于校验节点名称合法性, 防止非法字符(如斜杠)造成路径问题。 refactor(bookmark): 优化 API Key 验证逻辑并暴露更新时间字段 重构 BookMarksImpl 的 validateApiKey 函数,简化认证判断流程,并将 adminToken 从指针改为字符串常量。 此外,在 bookmarkModel2Res 函数中新增 UpdatedAt 字段,使书签响应包含更新时间信息。 feat(user_np): 实现用户信息相关接口占位函数 在 UserNPImpl 中新增 GetUserInfo 和 SaveUserInfo 两个方法的占位实现,为后续业务逻辑开发做好准备。 refactor(vfs): 使用文本请求体并加强服务节点操作校验 修改 vfs_impl.go 中读取请求体的方式,由 io.Reader 改为直接解引用文本内容,提升处理效率。 更新 CreateVFSNode、GetVFSNode 和 UpdateVFSNode 方法中对请求体和响应体的处理逻辑, 统一使用文本格式,增强代码一致性与健壮性。 feat(vfs): 为书签代理服务添加认证 Token 支持 在 vfs_bookmark.go 中为 VfsBookMarkService 结构体增加 token 字段,并在调用 bookmark 服务各接口时, 通过 HTTP 请求头设置 X-BookMark-Token,确保服务间通信的安全性与权限控制。
184 lines
4.3 KiB
Go
184 lines
4.3 KiB
Go
// internal/handlers/vfs_driver/vfs_bookmark.go
|
|
|
|
package vfsdriver
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"net/http"
|
|
|
|
api "git.zzyxyz.com/zzy/zzyxyz_go_api/gen/bookmarks_client"
|
|
"git.zzyxyz.com/zzy/zzyxyz_go_api/internal/vfs"
|
|
"git.zzyxyz.com/zzy/zzyxyz_go_api/internal/vfs/models"
|
|
)
|
|
|
|
type VfsBookMarkService struct {
|
|
client *api.ClientWithResponses
|
|
token string
|
|
}
|
|
|
|
func NewVfsBookMarkService(serverURL string) (*vfs.ProxyEntry, error) {
|
|
client, err := api.NewClientWithResponses(serverURL)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
ret := vfs.ProxyEntry{
|
|
Name: "bookmark",
|
|
MatchExt: "bk",
|
|
Proxy: &VfsBookMarkService{
|
|
client: client,
|
|
token: "random_token",
|
|
},
|
|
}
|
|
return &ret, nil
|
|
}
|
|
|
|
// Create implements ServiceProxy.
|
|
func (v *VfsBookMarkService) Create(servicePath string, node *models.VfsNode, data []byte) ([]byte, error) {
|
|
ctx := context.Background()
|
|
|
|
// 解析传入的数据为 BookmarkRequest
|
|
var req api.BookmarkRequest
|
|
if err := json.Unmarshal(data, &req); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// 调用 bookmark 服务创建书签
|
|
resp, err := v.client.CreateBookmarkWithResponse(ctx, int64(node.ID), req, func(ctx context.Context, req *http.Request) error {
|
|
req.Header.Set("X-BookMark-Token", v.token)
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// 处理响应
|
|
if resp.JSON201 != nil {
|
|
data, err := json.Marshal(resp.JSON201)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("marshal response error: %w", err)
|
|
}
|
|
return data, nil
|
|
}
|
|
|
|
// 处理错误情况
|
|
if resp.JSON400 != nil {
|
|
return nil, fmt.Errorf("bad request: %s", resp.JSON400.Message)
|
|
}
|
|
|
|
if resp.JSON500 != nil {
|
|
return nil, fmt.Errorf("server error: %s", resp.JSON500.Message)
|
|
}
|
|
|
|
return nil, fmt.Errorf("unknown error: %s %s", resp.HTTPResponse.Status, resp.Body)
|
|
}
|
|
|
|
// Delete implements ServiceProxy.
|
|
func (v *VfsBookMarkService) Delete(servicePath string, node *models.VfsNode) error {
|
|
ctx := context.Background()
|
|
|
|
// 调用 bookmark 服务删除书签
|
|
resp, err := v.client.DeleteBookmarkWithResponse(ctx, int64(node.ID), func(ctx context.Context, req *http.Request) error {
|
|
req.Header.Set("X-BookMark-Token", v.token)
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
// 处理响应
|
|
if resp.StatusCode() == 204 {
|
|
return nil
|
|
}
|
|
|
|
// 处理错误情况
|
|
if resp.JSON404 != nil {
|
|
return fmt.Errorf("not found: %s", resp.JSON404.Message)
|
|
}
|
|
|
|
if resp.JSON500 != nil {
|
|
return fmt.Errorf("server error: %s", resp.JSON500.Message)
|
|
}
|
|
|
|
return fmt.Errorf("unknown error")
|
|
}
|
|
|
|
// Get implements ServiceProxy.
|
|
func (v *VfsBookMarkService) Get(servicePath string, node *models.VfsNode) ([]byte, error) {
|
|
ctx := context.Background()
|
|
|
|
// 调用 bookmark 服务获取书签
|
|
resp, err := v.client.GetBookmarkWithResponse(ctx, int64(node.ID), func(ctx context.Context, req *http.Request) error {
|
|
req.Header.Set("X-BookMark-Token", v.token)
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
// 处理响应
|
|
if resp.JSON200 != nil {
|
|
data, err := json.Marshal(resp.JSON200)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("marshal response error: %w", err)
|
|
}
|
|
return data, nil
|
|
}
|
|
|
|
// 处理错误情况
|
|
if resp.JSON404 != nil {
|
|
return nil, fmt.Errorf("not found: %s", resp.JSON404.Message)
|
|
}
|
|
|
|
return nil, fmt.Errorf("unknown error")
|
|
}
|
|
|
|
// Update implements ServiceProxy.
|
|
func (v *VfsBookMarkService) Update(servicePath string, node *models.VfsNode, data []byte) error {
|
|
ctx := context.Background()
|
|
|
|
// 解析传入的数据为 BookmarkRequest
|
|
var req api.BookmarkRequest
|
|
if err := json.Unmarshal(data, &req); err != nil {
|
|
return err
|
|
}
|
|
|
|
// 调用 bookmark 服务更新书签
|
|
resp, err := v.client.UpdateBookmarkWithResponse(ctx, int64(node.ID), req, func(ctx context.Context, req *http.Request) error {
|
|
req.Header.Set("X-BookMark-Token", v.token)
|
|
return nil
|
|
})
|
|
if err != nil {
|
|
return err
|
|
}
|
|
|
|
// 处理响应
|
|
if resp.JSON200 != nil {
|
|
return nil
|
|
}
|
|
|
|
// 处理错误情况
|
|
if resp.JSON400 != nil {
|
|
return fmt.Errorf("bad request: %s", resp.JSON400.Message)
|
|
}
|
|
|
|
if resp.JSON404 != nil {
|
|
return fmt.Errorf("not found: %s", resp.JSON404.Message)
|
|
}
|
|
|
|
if resp.JSON500 != nil {
|
|
return fmt.Errorf("server error: %s", resp.JSON500.Message)
|
|
}
|
|
|
|
return fmt.Errorf("unknown error")
|
|
}
|
|
|
|
// GetName implements ServiceProxy.
|
|
func (v *VfsBookMarkService) GetName() string {
|
|
return "bookmark"
|
|
}
|
|
|
|
var _ vfs.ServiceProxy = (*VfsBookMarkService)(nil)
|