73 lines
3.0 KiB
Plaintext
73 lines
3.0 KiB
Plaintext
// 课程文件创建请求（无需id、create_time、update_time，由数据库自动生成）
|
||
type CreateCourseFileReq {
|
||
ContentId int `json:"content_id" form:"content_id" validate:"required"` // 关联的内容ID（必填）
|
||
Title string `json:"title" form:"title" validate:"required,max=255"` // 文件标题（必填，最长255字符）
|
||
FileType string `json:"file_type" form:"file_type" validate:"required,max=30"` // 文件类型（必填，最长30字符）
|
||
FileUrl string `json:"file_url" form:"file_url" validate:"required,max=255"` // 文件URL（必填，最长255字符）
|
||
}
|
||
|
||
// 课程文件创建响应
|
||
type CreateCourseFileResp {
|
||
Id int `json:"id"` // 新增文件的ID
|
||
Message string `json:"message"` // 操作结果信息
|
||
}
|
||
|
||
// 课程文件查询请求（根据ID查询）
|
||
type GetCourseFileReq {
|
||
Id int `json:"id" form:"id" param:"id" validate:"required"` // 文件ID（必填，从路径参数获取）
|
||
}
|
||
|
||
// 课程文件查询响应（返回完整文件信息）
|
||
type GetCourseFileResp {
|
||
Id int `json:"id"` // 文件ID
|
||
ContentId int `json:"content_id"` // 关联的内容ID
|
||
Title string `json:"title"` // 文件标题
|
||
FileType string `json:"file_type"` // 文件类型
|
||
FileUrl string `json:"file_url"` // 文件URL
|
||
CreateTime string `json:"create_time"` // 创建时间（格式化字符串）
|
||
UpdateTime string `json:"update_time"` // 更新时间（格式化字符串）
|
||
}
|
||
|
||
// 课程文件更新请求（部分字段更新）
|
||
type UpdateCourseFileReq {
|
||
Id int `json:"id" form:"id" validate:"required"` // 文件ID（必填）
|
||
ContentId int `json:"content_id" form:"content_id"` // 可选：更新关联的内容ID
|
||
Title string `json:"title" form:"title" validate:"omitempty,max=255"` // 可选：更新标题
|
||
FileType string `json:"file_type" form:"file_type" validate:"omitempty,max=30"` // 可选：更新文件类型
|
||
FileUrl string `json:"file_url" form:"file_url" validate:"omitempty,max=255"` // 可选：更新文件URL
|
||
}
|
||
|
||
// 课程文件更新响应
|
||
type UpdateCourseFileResp {
|
||
Message string `json:"message"` // 操作结果信息
|
||
}
|
||
|
||
// 课程文件删除请求
|
||
type DeleteCourseFileReq {
|
||
Id int `json:"id" form:"id" param:"id" validate:"required"` // 文件ID（必填，从路径参数获取）
|
||
}
|
||
|
||
// 课程文件删除响应
|
||
type DeleteCourseFileResp {
|
||
Message string `json:"message"` // 操作结果信息
|
||
}
|
||
|
||
@server (
|
||
group: course_file // 接口分组改为课程文件相关
|
||
prefix: /api/course-file
|
||
)
|
||
service course_file_api { // 服务名称修改为课程文件API
|
||
@handler CreateCourseFileHandler // 创建课程文件
|
||
post /course-file (CreateCourseFileReq) returns (CreateCourseFileResp)
|
||
|
||
@handler GetCourseFileHandler // 查询单个课程文件
|
||
get /course-file/:id (GetCourseFileReq) returns (GetCourseFileResp)
|
||
|
||
@handler UpdateCourseFileHandler // 更新课程文件
|
||
put /course-file (UpdateCourseFileReq) returns (UpdateCourseFileResp)
|
||
|
||
@handler DeleteCourseFileHandler // 删除课程文件
|
||
delete /course-file/:id (DeleteCourseFileReq) returns (DeleteCourseFileResp)
|
||
}
|
||
|