handlers

package
v1.11.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 2, 2026 License: MIT Imports: 27 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var OnDatabaseInitialized func(daoManager *repository.RepositoryManager)

OnDatabaseInitialized 当数据库初始化完成时，handlers 包中的回调（由 main 设置）

Functions

func GetMCPManager 

func GetMCPManager() *mcp.MCPManager

GetMCPManager 获取 MCP 管理器

func GetShutdownFunc added in v1.11.0 

func GetShutdownFunc() func()

GetShutdownFunc 获取应用关闭函数

func InitializeNoDB added in v1.7.1 

func InitializeNoDB(manager *config.ConfigManager) gin.HandlerFunc

InitializeNoDB 用于在没有 daoManager 的情况下处理 /setup/initialize 请求 它会：验证请求、使用配置管理器初始化数据库、创建 daoManager、创建管理员用户，最后触发 OnDatabaseInitialized 回调

func SetInjectedAdminHandler added in v1.7.1 

func SetInjectedAdminHandler(h *AdminHandler)

SetInjectedAdminHandler 注入 AdminHandler，供占位路由委派使用

func SetMCPManager 

func SetMCPManager(manager *mcp.MCPManager)

SetMCPManager 设置 MCP 管理器

func SetShutdownFunc added in v1.11.0 

func SetShutdownFunc(fn func())

SetShutdownFunc 注入应用关闭函数

Types

type APIHandler 

type APIHandler struct {
	// contains filtered or unexported fields
}

APIHandler API处理器

func NewAPIHandler 

func NewAPIHandler(manager *config.ConfigManager) *APIHandler

func (*APIHandler) GetConfig 

func (h *APIHandler) GetConfig(c *gin.Context)

GetConfig 获取系统配置 @Summary 获取系统配置 @Description 获取前端所需的系统配置信息 @Tags 系统 @Accept json @Produce json @Success 200 {object} SystemConfig "系统配置信息" @Router /api/config [get]

func (*APIHandler) GetHealth 

func (h *APIHandler) GetHealth(c *gin.Context)

GetHealth 健康检查 @Summary 健康检查 @Description 检查服务器健康状态和构建信息 @Tags 系统 @Accept json @Produce json @Success 200 {object} HealthResponse "健康状态信息和构建信息" @Router /health [get]

type AdminConfig 

type AdminConfig struct {
	Username              string `json:"username"`
	Email                 string `json:"email"`
	Nickname              string `json:"nickname"`
	Confirm               string `json:"confirm"`
	Password              string `json:"password"`
	AllowUserRegistration bool   `json:"allowUserRegistration"`
}

AdminConfig 管理员配置

type AdminHandler 

type AdminHandler struct {
	// contains filtered or unexported fields
}

AdminHandler 管理处理器

func GetInjectedAdminHandler added in v1.7.1 

func GetInjectedAdminHandler() *AdminHandler

GetInjectedAdminHandler 获取注入的 AdminHandler

func NewAdminHandler 

func NewAdminHandler(service *services.AdminService, config *config.ConfigManager) *AdminHandler

func (*AdminHandler) AnalyzeDatabase 

func (h *AdminHandler) AnalyzeDatabase(c *gin.Context)

AnalyzeDatabase 分析数据库

func (*AdminHandler) BackupDatabase 

func (h *AdminHandler) BackupDatabase(c *gin.Context)

BackupDatabase 备份数据库

func (*AdminHandler) BatchDeleteUsers added in v1.7.1 

func (h *AdminHandler) BatchDeleteUsers(c *gin.Context)

BatchDeleteUsers 批量删除用户

func (*AdminHandler) BatchDisableUsers added in v1.7.1 

func (h *AdminHandler) BatchDisableUsers(c *gin.Context)

BatchDisableUsers 批量禁用用户

func (*AdminHandler) BatchEnableUsers added in v1.7.1 

func (h *AdminHandler) BatchEnableUsers(c *gin.Context)

BatchEnableUsers 批量启用用户

func (*AdminHandler) CancelTask 

func (h *AdminHandler) CancelTask(c *gin.Context)

CancelTask 取消任务

func (*AdminHandler) CheckIntegrity 

func (h *AdminHandler) CheckIntegrity(c *gin.Context)

CheckIntegrity 检查完整性

func (*AdminHandler) CheckPermissions 

func (h *AdminHandler) CheckPermissions(c *gin.Context)

CheckPermissions 检查权限

func (*AdminHandler) CleanExpiredFiles 

func (h *AdminHandler) CleanExpiredFiles(c *gin.Context)

CleanExpiredFiles 清理过期文件

func (*AdminHandler) CleanInvalidRecords 

func (h *AdminHandler) CleanInvalidRecords(c *gin.Context)

CleanInvalidRecords 清理无效记录

func (*AdminHandler) CleanTempFiles 

func (h *AdminHandler) CleanTempFiles(c *gin.Context)

CleanTempFiles 清理临时文件

func (*AdminHandler) ClearAccessLogs 

func (h *AdminHandler) ClearAccessLogs(c *gin.Context)

ClearAccessLogs 清理访问日志

func (*AdminHandler) ClearDownloadCache 

func (h *AdminHandler) ClearDownloadCache(c *gin.Context)

ClearDownloadCache 清理下载缓存

func (*AdminHandler) ClearErrorLogs 

func (h *AdminHandler) ClearErrorLogs(c *gin.Context)

ClearErrorLogs 清理错误日志

func (*AdminHandler) ClearSystemCache 

func (h *AdminHandler) ClearSystemCache(c *gin.Context)

ClearSystemCache 清理系统缓存

func (*AdminHandler) ClearSystemLogs 

func (h *AdminHandler) ClearSystemLogs(c *gin.Context)

ClearSystemLogs 清理系统日志

func (*AdminHandler) ClearUploadCache 

func (h *AdminHandler) ClearUploadCache(c *gin.Context)

ClearUploadCache 清理上传缓存

func (*AdminHandler) ControlMCPServer 

func (h *AdminHandler) ControlMCPServer(c *gin.Context)

ControlMCPServer 控制 MCP 服务的启停

func (*AdminHandler) CreateUser 

func (h *AdminHandler) CreateUser(c *gin.Context)

CreateUser 创建用户

func (*AdminHandler) Dashboard 

func (h *AdminHandler) Dashboard(c *gin.Context)

Dashboard 仪表盘

func (*AdminHandler) DeleteFile 

func (h *AdminHandler) DeleteFile(c *gin.Context)

DeleteFile 删除文件

func (*AdminHandler) DeleteUser 

func (h *AdminHandler) DeleteUser(c *gin.Context)

DeleteUser 删除用户

func (*AdminHandler) DownloadFile 

func (h *AdminHandler) DownloadFile(c *gin.Context)

DownloadFile 下载文件（管理员）

func (*AdminHandler) ExportLogs 

func (h *AdminHandler) ExportLogs(c *gin.Context)

ExportLogs 导出日志

func (*AdminHandler) ExportUsers 

func (h *AdminHandler) ExportUsers(c *gin.Context)

ExportUsers 导出用户列表为CSV

func (*AdminHandler) GetConfig 

func (h *AdminHandler) GetConfig(c *gin.Context)

GetConfig 获取配置

func (*AdminHandler) GetConfigExample added in v1.7.1 

func (h *AdminHandler) GetConfigExample(c *gin.Context)

func (*AdminHandler) GetFile 

func (h *AdminHandler) GetFile(c *gin.Context)

GetFile 获取单个文件信息

func (*AdminHandler) GetFiles 

func (h *AdminHandler) GetFiles(c *gin.Context)

GetFiles 获取文件列表

func (*AdminHandler) GetLogStats 

func (h *AdminHandler) GetLogStats(c *gin.Context)

GetLogStats 获取日志统计

func (*AdminHandler) GetMCPConfig 

func (h *AdminHandler) GetMCPConfig(c *gin.Context)

GetMCPConfig 获取 MCP 配置

func (*AdminHandler) GetMCPStatus 

func (h *AdminHandler) GetMCPStatus(c *gin.Context)

GetMCPStatus 获取 MCP 服务器状态

func (*AdminHandler) GetOperationLogs added in v1.9.5 

func (h *AdminHandler) GetOperationLogs(c *gin.Context)

func (*AdminHandler) GetPerformanceMetrics 

func (h *AdminHandler) GetPerformanceMetrics(c *gin.Context)

GetPerformanceMetrics 获取性能指标

func (*AdminHandler) GetRunningTasks 

func (h *AdminHandler) GetRunningTasks(c *gin.Context)

GetRunningTasks 获取运行中的任务

func (*AdminHandler) GetStats 

func (h *AdminHandler) GetStats(c *gin.Context)

GetStats 获取统计信息

func (*AdminHandler) GetStorageStatus 

func (h *AdminHandler) GetStorageStatus(c *gin.Context)

GetStorageStatus 获取存储状态

func (*AdminHandler) GetSystemInfo 

func (h *AdminHandler) GetSystemInfo(c *gin.Context)

GetSystemInfo 获取系统信息

func (*AdminHandler) GetSystemLogs 

func (h *AdminHandler) GetSystemLogs(c *gin.Context)

GetSystemLogs 获取系统日志

func (*AdminHandler) GetTransferLogs added in v1.9.5 

func (h *AdminHandler) GetTransferLogs(c *gin.Context)

GetTransferLogs 获取上传/下载审计日志

func (*AdminHandler) GetUser 

func (h *AdminHandler) GetUser(c *gin.Context)

GetUser 获取单个用户

func (*AdminHandler) GetUserFiles 

func (h *AdminHandler) GetUserFiles(c *gin.Context)

GetUserFiles 获取用户文件

func (*AdminHandler) GetUsers 

func (h *AdminHandler) GetUsers(c *gin.Context)

GetUsers 获取用户列表

func (*AdminHandler) Login 

func (h *AdminHandler) Login(c *gin.Context)

Login 管理员登录

func (*AdminHandler) OptimizeDatabase 

func (h *AdminHandler) OptimizeDatabase(c *gin.Context)

OptimizeDatabase 优化数据库

func (*AdminHandler) RestartMCPServer 

func (h *AdminHandler) RestartMCPServer(c *gin.Context)

RestartMCPServer 重启 MCP 服务

func (*AdminHandler) RestartSystem 

func (h *AdminHandler) RestartSystem(c *gin.Context)

RestartSystem 重启系统

func (*AdminHandler) RetryTask 

func (h *AdminHandler) RetryTask(c *gin.Context)

RetryTask 重试任务

func (*AdminHandler) ScanSecurity 

func (h *AdminHandler) ScanSecurity(c *gin.Context)

ScanSecurity 安全扫描

func (*AdminHandler) ShutdownSystem added in v1.11.0 

func (h *AdminHandler) ShutdownSystem(c *gin.Context)

ShutdownSystem 关闭系统

func (*AdminHandler) TestMCPConnection 

func (h *AdminHandler) TestMCPConnection(c *gin.Context)

TestMCPConnection 测试 MCP 服务连接

func (*AdminHandler) UpdateConfig 

func (h *AdminHandler) UpdateConfig(c *gin.Context)

UpdateConfig 更新配置

func (*AdminHandler) UpdateFile 

func (h *AdminHandler) UpdateFile(c *gin.Context)

UpdateFile 更新文件信息

func (*AdminHandler) UpdateMCPConfig 

func (h *AdminHandler) UpdateMCPConfig(c *gin.Context)

UpdateMCPConfig 更新 MCP 配置

func (*AdminHandler) UpdateUser 

func (h *AdminHandler) UpdateUser(c *gin.Context)

UpdateUser 更新用户

func (*AdminHandler) UpdateUserStatus 

func (h *AdminHandler) UpdateUserStatus(c *gin.Context)

UpdateUserStatus 更新用户状态

type AppState 

type AppState struct {
	// contains filtered or unexported fields
}

AppState 应用状态管理器

type ChunkHandler 

type ChunkHandler struct {
	// contains filtered or unexported fields
}

ChunkHandler 分片处理器

func NewChunkHandler 

func NewChunkHandler(service *services.ChunkService) *ChunkHandler

func (*ChunkHandler) CancelUpload 

func (h *ChunkHandler) CancelUpload(c *gin.Context)

CancelUpload 取消上传

func (*ChunkHandler) CancelUploadAPI added in v1.9.9 

func (h *ChunkHandler) CancelUploadAPI(c *gin.Context)

CancelUploadAPI 取消分片上传（API 模式） @Summary 取消分片上传（API 模式） @Description 取消上传流程并清理已有分片 @Tags API @Produce json @Param upload_id path string true "上传ID" @Success 200 {object} map[string]interface{} "取消成功" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Router /api/v1/chunks/upload/cancel/{upload_id} [delete] @Security ApiKeyAuth

func (*ChunkHandler) CompleteUpload 

func (h *ChunkHandler) CompleteUpload(c *gin.Context)

CompleteUpload 完成上传 @Summary 完成分片上传 @Description 完成所有分片上传，合并文件并生成分享代码 @Tags 分片上传 @Accept json @Produce json @Param upload_id path string true "上传ID" @Param request body object true "完成上传参数" example({"expire_value":1,"expire_style":"day","require_auth":false}) @Success 200 {object} map[string]interface{} "上传完成，返回分享代码" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /chunk/upload/complete/{upload_id} [post]

func (*ChunkHandler) CompleteUploadAPI added in v1.9.9 

func (h *ChunkHandler) CompleteUploadAPI(c *gin.Context)

CompleteUploadAPI 完成分片上传（API 模式） @Summary 完成分片上传（API 模式） @Description 合并所有分片并生成分享代码 @Tags API @Accept json @Produce json @Param upload_id path string true "上传ID" @Param request body object true "完成上传参数" @Success 200 {object} map[string]interface{} "上传完成，返回分享代码" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/v1/chunks/upload/complete/{upload_id} [post] @Security ApiKeyAuth

func (*ChunkHandler) GetUploadStatus 

func (h *ChunkHandler) GetUploadStatus(c *gin.Context)

GetUploadStatus 获取上传状态（断点续传支持）

func (*ChunkHandler) GetUploadStatusAPI added in v1.9.9 

func (h *ChunkHandler) GetUploadStatusAPI(c *gin.Context)

GetUploadStatusAPI 查询上传状态（API 模式） @Summary 查询上传状态（API 模式） @Description 查询分片上传的进度和状态 @Tags API @Produce json @Param upload_id path string true "上传ID" @Success 200 {object} map[string]interface{} "上传状态" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 404 {object} map[string]interface{} "上传ID不存在" @Router /api/v1/chunks/upload/status/{upload_id} [get] @Security ApiKeyAuth

func (*ChunkHandler) InitChunkUpload 

func (h *ChunkHandler) InitChunkUpload(c *gin.Context)

InitChunkUpload 初始化分片上传 @Summary 初始化分片上传 @Description 初始化文件分片上传，返回上传ID和分片信息 @Tags 分片上传 @Accept json @Produce json @Param request body object true "上传初始化参数" example({"file_name":"test.zip","file_size":1024000,"chunk_size":1024,"file_hash":"abc123"}) @Success 200 {object} map[string]interface{} "初始化成功，返回上传ID和分片信息" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /chunk/upload/init/ [post]

func (*ChunkHandler) InitChunkUploadAPI added in v1.9.9 

func (h *ChunkHandler) InitChunkUploadAPI(c *gin.Context)

InitChunkUploadAPI 初始化分片上传（API 模式） @Summary 初始化分片上传（API 模式） @Description 使用 API Key 初始化分片上传，返回上传ID @Tags API @Accept json @Produce json @Param request body object true "上传初始化参数" @Success 200 {object} map[string]interface{} "初始化成功" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/v1/chunks/upload/init [post] @Security ApiKeyAuth

func (*ChunkHandler) UploadChunk 

func (h *ChunkHandler) UploadChunk(c *gin.Context)

UploadChunk 上传分片 @Summary 上传文件分片 @Description 上传指定索引的文件分片 @Tags 分片上传 @Accept multipart/form-data @Produce json @Param upload_id path string true "上传ID" @Param chunk_index path int true "分片索引" @Param chunk formData file true "分片文件" @Success 200 {object} map[string]interface{} "上传成功，返回分片哈希" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /chunk/upload/chunk/{upload_id}/{chunk_index} [post]

func (*ChunkHandler) UploadChunkAPI added in v1.9.9 

func (h *ChunkHandler) UploadChunkAPI(c *gin.Context)

UploadChunkAPI 上传文件分片（API 模式） @Summary 上传文件分片（API 模式） @Description 上传指定索引的文件分片 @Tags API @Accept multipart/form-data @Produce json @Param upload_id path string true "上传ID" @Param chunk_index path int true "分片索引" @Param chunk formData file true "分片文件" @Success 200 {object} map[string]interface{} "上传成功" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/v1/chunks/upload/chunk/{upload_id}/{chunk_index} [post] @Security ApiKeyAuth

func (*ChunkHandler) VerifyChunk 

func (h *ChunkHandler) VerifyChunk(c *gin.Context)

VerifyChunk 验证分片完整性

func (*ChunkHandler) VerifyChunkAPI added in v1.9.9 

func (h *ChunkHandler) VerifyChunkAPI(c *gin.Context)

VerifyChunkAPI 校验分片（API 模式） @Summary 校验分片（API 模式） @Description 校验指定分片是否已上传 @Tags API @Accept json @Produce json @Param upload_id path string true "上传ID" @Param chunk_index path int true "分片索引" @Param request body object true "分片校验参数" @Success 200 {object} map[string]interface{} "校验结果" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Router /api/v1/chunks/upload/verify/{upload_id}/{chunk_index} [post] @Security ApiKeyAuth

type DatabaseConfig 

type DatabaseConfig struct {
	Type     string `json:"type"`     // sqlite, mysql, postgres
	File     string `json:"file"`     // SQLite 文件路径
	Host     string `json:"host"`     // MySQL/PostgreSQL 主机
	Port     int    `json:"port"`     // MySQL/PostgreSQL 端口
	User     string `json:"user"`     // MySQL/PostgreSQL 用户名
	Password string `json:"password"` // MySQL/PostgreSQL 密码
	Database string `json:"database"` // MySQL/PostgreSQL 数据库名
}

DatabaseConfig 数据库配置

type HealthResponse 

type HealthResponse struct {
	Status    string `json:"status" example:"ok"`
	Timestamp string `json:"timestamp" example:"2025-09-11T10:00:00Z"`
	Version   string `json:"version" example:"1.10.7"`
	Uptime    string `json:"uptime" example:"2h30m15s"`
}

HealthResponse 健康检查响应结构

type QRCodeHandler added in v1.11.1 

type QRCodeHandler struct {
	// contains filtered or unexported fields
}

QRCodeHandler 二维码处理器

func NewQRCodeHandler added in v1.11.1 

func NewQRCodeHandler() *QRCodeHandler

NewQRCodeHandler 创建二维码处理器实例

func (*QRCodeHandler) GenerateQRCode added in v1.11.1 

func (h *QRCodeHandler) GenerateQRCode(c *gin.Context)

GenerateQRCode 生成二维码 @Summary 生成二维码 @Description 根据提供的数据生成二维码图片 @Tags 二维码 @Accept json @Produce png @Param data query string true "二维码数据内容" @Param size query int false "二维码尺寸(像素)" default(256) @Success 200 {file} binary "PNG格式的二维码图片" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/qrcode/generate [get]

func (*QRCodeHandler) GenerateQRCodeBase64 added in v1.11.1 

func (h *QRCodeHandler) GenerateQRCodeBase64(c *gin.Context)

GenerateQRCodeBase64 生成Base64编码的二维码 @Summary 生成Base64二维码 @Description 根据提供的数据生成Base64编码的二维码图片 @Tags 二维码 @Accept json @Produce json @Param data query string true "二维码数据内容" @Param size query int false "二维码尺寸(像素)" default(256) @Success 200 {object} map[string]interface{} "Base64编码的二维码图片" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/qrcode/base64 [get]

type SetupHandler 

type SetupHandler struct {
	// contains filtered or unexported fields
}

func NewSetupHandler 

func NewSetupHandler(daoManager *repository.RepositoryManager, manager *config.ConfigManager) *SetupHandler

NewSetupHandler 创建系统初始化处理器

func (*SetupHandler) Initialize 

func (h *SetupHandler) Initialize(c *gin.Context)

Initialize 在数据库已经可用的情况下处理 /setup/initialize 请求 该方法用于通过已存在的 daoManager 来完成系统初始化（保存配置、创建管理员等）

type SetupRequest 

type SetupRequest struct {
	Database DatabaseConfig `json:"database"`
	Admin    AdminConfig    `json:"admin"`
}

SetupRequest 初始化请求结构

type ShareHandler 

type ShareHandler struct {
	// contains filtered or unexported fields
}

ShareHandler 分享处理器

func NewShareHandler 

func NewShareHandler(service *share.Service) *ShareHandler

func (*ShareHandler) DownloadFile 

func (h *ShareHandler) DownloadFile(c *gin.Context)

DownloadFile 下载文件 @Summary 下载分享文件 @Description 根据分享代码下载文件或获取文本内容 @Tags 分享 @Accept json @Produce application/octet-stream @Produce application/json @Param code query string true "分享代码" @Success 200 {file} binary "文件内容" @Success 200 {object} map[string]interface{} "文本内容" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 404 {object} map[string]interface{} "分享代码不存在" @Router /share/download [get]

func (*ShareHandler) DownloadFileAPI added in v1.9.9 

func (h *ShareHandler) DownloadFileAPI(c *gin.Context)

DownloadFileAPI REST 风格下载接口（API 模式） @Summary 下载分享内容（API 模式） @Description 根据分享代码下载文件或获取文本内容 @Tags API @Produce application/octet-stream @Produce application/json @Param code path string true "分享代码" @Success 200 {file} binary "文件内容" @Success 200 {object} map[string]interface{} "文本内容" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 404 {object} map[string]interface{} "分享不存在" @Router /api/v1/share/{code}/download [get] @Security ApiKeyAuth

func (*ShareHandler) GetFile 

func (h *ShareHandler) GetFile(c *gin.Context)

GetFile 获取文件信息 @Summary 获取分享文件信息 @Description 根据分享代码获取文件或文本的详细信息 @Tags 分享 @Accept json @Produce json @Param code query string false "分享代码(GET方式)" @Param code formData string false "分享代码(POST方式)" @Success 200 {object} map[string]interface{} "文件信息" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 404 {object} map[string]interface{} "分享代码不存在" @Router /share/select/ [get] @Router /share/select/ [post]

func (*ShareHandler) GetFileAPI added in v1.9.9 

func (h *ShareHandler) GetFileAPI(c *gin.Context)

GetFileAPI 通过 REST 模式查询分享信息（API 模式） @Summary 查询分享详情（API 模式） @Description 根据分享代码返回分享的文件或文本信息 @Tags API @Produce json @Param code path string true "分享代码" @Success 200 {object} map[string]interface{} "分享详情" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 404 {object} map[string]interface{} "分享不存在" @Router /api/v1/share/{code} [get] @Security ApiKeyAuth

func (*ShareHandler) ShareFile 

func (h *ShareHandler) ShareFile(c *gin.Context)

ShareFile 分享文件 @Summary 分享文件 @Description 上传并分享文件，生成分享代码 @Tags 分享 @Accept multipart/form-data @Produce json @Param file formData file true "要分享的文件" @Param expire_value formData int false "过期值" default(1) @Param expire_style formData string false "过期样式" default(day) Enums(minute, hour, day, week, month, year, forever) @Param require_auth formData boolean false "是否需要认证" default(false) @Success 200 {object} map[string]interface{} "分享成功，返回分享代码和文件信息" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /share/file/ [post]

func (*ShareHandler) ShareFileAPI added in v1.9.9 

func (h *ShareHandler) ShareFileAPI(c *gin.Context)

ShareFileAPI 面向 API Key 用户的文件分享入口 @Summary 分享文件（API 模式） @Description 通过 API Key 上传并分享文件 @Tags API @Accept multipart/form-data @Produce json @Param file formData file true "要分享的文件" @Param expire_value formData int false "过期值" default(1) @Param expire_style formData string false "过期样式" default(day) Enums(minute, hour, day, week, month, year, forever) @Param require_auth formData boolean false "是否需要认证" default(false) @Success 200 {object} map[string]interface{} "分享成功，返回分享代码和文件信息" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/v1/share/file [post] @Security ApiKeyAuth

func (*ShareHandler) ShareText 

func (h *ShareHandler) ShareText(c *gin.Context)

ShareText 分享文本 @Summary 分享文本内容 @Description 分享文本内容并生成分享代码 @Tags 分享 @Accept multipart/form-data @Produce json @Param text formData string true "文本内容" @Param expire_value formData int false "过期值" default(1) @Param expire_style formData string false "过期样式" default(day) Enums(minute, hour, day, week, month, year, forever) @Param require_auth formData boolean false "是否需要认证" default(false) @Success 200 {object} map[string]interface{} "分享成功，返回分享代码" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /share/text/ [post]

func (*ShareHandler) ShareTextAPI added in v1.9.9 

func (h *ShareHandler) ShareTextAPI(c *gin.Context)

ShareTextAPI 面向 API Key 用户的文本分享入口 @Summary 分享文本（API 模式） @Description 通过 API Key 分享文本内容 @Tags API @Accept multipart/form-data @Produce json @Param text formData string true "文本内容" @Param expire_value formData int false "过期值" default(1) @Param expire_style formData string false "过期样式" default(day) Enums(minute, hour, day, week, month, year, forever) @Param require_auth formData boolean false "是否需要认证" default(false) @Success 200 {object} map[string]interface{} "分享成功，返回分享代码" @Failure 400 {object} map[string]interface{} "请求参数错误" @Failure 401 {object} map[string]interface{} "API Key 校验失败" @Failure 500 {object} map[string]interface{} "服务器内部错误" @Router /api/v1/share/text [post] @Security ApiKeyAuth

type StorageHandler 

type StorageHandler struct {
	// contains filtered or unexported fields
}

StorageHandler 存储管理处理器

func NewStorageHandler 

func NewStorageHandler(sm *storage.StorageManager, storageConfig *config.StorageConfig, configManager *config.ConfigManager) *StorageHandler

NewStorageHandler 创建存储处理器

func (*StorageHandler) GetStorageInfo 

func (sh *StorageHandler) GetStorageInfo(c *gin.Context)

GetStorageInfo 获取存储信息

func (*StorageHandler) SwitchStorage 

func (sh *StorageHandler) SwitchStorage(c *gin.Context)

SwitchStorage 切换存储类型

func (*StorageHandler) TestStorageConnection 

func (sh *StorageHandler) TestStorageConnection(c *gin.Context)

TestStorageConnection 测试存储连接

func (*StorageHandler) UpdateStorageConfig 

func (sh *StorageHandler) UpdateStorageConfig(c *gin.Context)

UpdateStorageConfig 更新存储配置

type SystemConfig 

type SystemConfig struct {
	Name        string   `json:"name" example:"FileCodeBox"`
	Description string   `json:"description" example:"文件分享系统"`
	UploadSize  int64    `json:"uploadSize" example:"100"`
	EnableChunk int      `json:"enableChunk" example:"1"`
	OpenUpload  int      `json:"openUpload" example:"1"`
	ExpireStyle []string `json:"expireStyle" example:"minute,hour,day,week,month,year,forever"`
}

SystemConfig 系统配置结构

type UserHandler 

type UserHandler struct {
	// contains filtered or unexported fields
}

UserHandler 用户处理器

func NewUserHandler 

func NewUserHandler(userService *services.UserService) *UserHandler

NewUserHandler 创建用户处理器

func (*UserHandler) ChangePassword 

func (h *UserHandler) ChangePassword(c *gin.Context)

ChangePassword 修改密码

func (*UserHandler) CheckAuth 

func (h *UserHandler) CheckAuth(c *gin.Context)

CheckAuth 检查用户认证状态

func (*UserHandler) CheckSystemInitialization 

func (h *UserHandler) CheckSystemInitialization(c *gin.Context)

CheckSystemInitialization 检查系统初始化状态（公开接口）

func (*UserHandler) CreateAPIKey added in v1.9.9 

func (h *UserHandler) CreateAPIKey(c *gin.Context)

CreateAPIKey 为当前用户生成新的 API Key

func (*UserHandler) DeleteAPIKey added in v1.9.9 

func (h *UserHandler) DeleteAPIKey(c *gin.Context)

DeleteAPIKey 撤销指定的 API Key

func (*UserHandler) DeleteFile 

func (h *UserHandler) DeleteFile(c *gin.Context)

DeleteFile 删除用户文件

func (*UserHandler) GetProfile 

func (h *UserHandler) GetProfile(c *gin.Context)

GetProfile 获取用户资料

func (*UserHandler) GetSystemInfo 

func (h *UserHandler) GetSystemInfo(c *gin.Context)

GetSystemInfo 获取系统信息（公开接口）

func (*UserHandler) GetUserFiles 

func (h *UserHandler) GetUserFiles(c *gin.Context)

GetUserFiles 获取用户文件列表

func (*UserHandler) GetUserStats 

func (h *UserHandler) GetUserStats(c *gin.Context)

GetUserStats 获取用户统计信息

func (*UserHandler) IsSystemInitialized 

func (h *UserHandler) IsSystemInitialized() (bool, error)

IsSystemInitialized 内部方法，直接返回初始化状态

func (*UserHandler) ListAPIKeys added in v1.9.9 

func (h *UserHandler) ListAPIKeys(c *gin.Context)

ListAPIKeys 获取当前用户的全部 API Key 列表

func (*UserHandler) Login 

func (h *UserHandler) Login(c *gin.Context)

Login 用户登录

func (*UserHandler) Logout 

func (h *UserHandler) Logout(c *gin.Context)

Logout 用户登出

func (*UserHandler) Register 

func (h *UserHandler) Register(c *gin.Context)

Register 用户注册

func (*UserHandler) UpdateProfile 

func (h *UserHandler) UpdateProfile(c *gin.Context)

UpdateProfile 更新用户资料

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.