shop/modules/doc/api/v1/admin/doc_file_api.go

package admin

import (
	"ulink-admin/frame"
	"ulink-admin/modules/doc/models/model"
	"ulink-admin/modules/doc/models/req"
	"ulink-admin/modules/doc/service"
	"ulink-admin/pkg/excels"
	"ulink-admin/pkg/file"
	"ulink-admin/pkg/page"
)

type DocFileApi struct {
	docFileService service.DocFileService
}

// List 查询文档管理分页数据
// @Summary 分页查询文档管理数据接口
// @Description 分页查询文档管理数据接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param object query req.DocFileQuery false "查询参数"
// @Security ApiKeyAuth
// @Success 200 {object} resp.Response{data=page.Page{list=model.DocFile},msg=string} "分页获取文档管理列表,返回包括列表,总数,页码,每页数量"
// @Router /docfile/page [get]
func (this DocFileApi) Page(c *frame.Context) {
	query := &req.DocFileQuery{}
	c.ValidteError(c.ShouldBind(query), query)
	find, i := this.docFileService.Page(query)
	c.Ok(page.Page{List: find, Total: i, Size: query.PageSize})
}

// List 查询文档管理所有数据
// @Summary 查询全部数据文档管理数据接口
// @Description 查询全部数据文档管理数据接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param object query req.DocFileQuery false "查询参数"
// @Security ApiKeyAuth
// @Success 200 {object} resp.Response{data=model.DocFile,msg=string} "分页获取文档管理列表,返回包括列表,总数,页码,每页数量"
// @Router /docfile/list [get]
func (this DocFileApi) List(c *frame.Context) {
	query := &req.DocFileQuery{}
	list := make([]model.DocFile, 0)
	c.ValidteError(c.ShouldBind(query), query)
	this.docFileService.List(query, &list)
	c.Ok(list)
}

// Get 根据文档管理Id获取详细信息
// @Summary 文档管理详情查询接口
// @Description 文档管理详情查询接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param id query   int true "id" id
// @Security ApiKeyAuth
// @Success 200 {object} resp.Response{data=model.DocFile,msg=string} "返回文档管理详情查询"
// @Router /docfile [get]
func (this DocFileApi) Get(c *frame.Context) {
	var req struct {
		Id int64 `form:"id" binding:"required"  msg:"id不存在" ` //id
	}
	c.ValidteError(c.ShouldBind(&req), &req)
	c.Ok(this.docFileService.Get(req.Id))
}

// Add 新增文档管理
// @Summary 新增文档管理接口
// @Description 新增文档管理接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param  data body model.DocFile true "文档管理实体对象"
// @Success 200 {object} resp.Response{msg=string} "操作状态"
// @Router /docfile/add [post]
func (this DocFileApi) Add(c *frame.Context) {
	docFile := &model.DocFile{}
	c.ValidteError(c.ShouldBind(docFile), docFile)
	this.docFileService.Insert(docFile)
}

// Edit 修改文档管理数据接口
// @Summary 修改文档管理接口
// @Description 新增文档管理接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param  data body model.DocFile true "文档管理实体对象"
// @Success 200 {object} resp.Response{msg=string} "操作状态"
// @Router /docfile/edit [put]
func (this DocFileApi) Edit(c *frame.Context) {
	docFile := &model.DocFile{}
	c.ValidteError(c.ShouldBind(docFile), docFile)
	this.docFileService.Edit(docFile, c.Cols())
}

// Delete 删除文档管理数据
// @Summary 删除文档管理接口
// @Description 删除文档管理接口
// @Tags 文档管理相关接口
// @Accept application/json
// @Produce application/json
// @Param Authorization header string false "Bearer 令牌"
// @Param id path   int true "id" id
// @Success 200 {object} resp.Response{msg=string} "操作状态"
// @Router /docfile [delete]
func (a DocFileApi) Delete(c *frame.Context) {
	var req struct {
		Ids []int64 `form:"ids" binding:"required"  msg:"ids不存在"` //ids
	}
	c.ValidteError(c.ShouldBind(&req), &req)
	a.docFileService.Delete(req.Ids)
}

// Export 导出excel
func (this DocFileApi) Export(c *frame.Context) {
	query := &req.DocFileQuery{}
	list := make([]model.DocFile, 0)
	c.ValidteError(c.ShouldBind(query), query)
	this.docFileService.List(query, list)
	excelList := make([]interface{}, 0)
	for _, docFile := range list {
		excelList = append(excelList, docFile)
	}
	_, files := excels.ExportExcel(excelList, "文档管理数据表")
	file.DownloadExcel(c, files)
}