From 8c19fc0cb28c92e95aff23be5e31b3e0c5368fe2 Mon Sep 17 00:00:00 2001 From: TinyAnts Date: Wed, 15 Mar 2023 14:26:03 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BC=98=E5=8C=96:=20=E5=90=8E=E5=8F=B0?= =?UTF-8?q?=E5=A2=9E=E5=8A=A0Swagger=E5=AE=9E=E4=BD=93=E7=B1=BB=E7=9A=84?= =?UTF-8?q?=E6=B3=A8=E8=A7=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../admin/controller/AlbumsController.java | 63 +++-------------- .../admin/controller/ArtCateController.java | 62 +++-------------- .../admin/controller/ArticleController.java | 55 +++------------ .../admin/controller/CrontabController.java | 43 +++--------- .../mdd/admin/controller/IndexController.java | 20 ++---- .../admin/controller/UploadController.java | 22 ++---- .../mdd/admin/controller/UsersController.java | 31 ++------- .../channel/ChannelH5Controller.java | 21 ++---- .../channel/ChannelMpController.java | 21 ++---- .../channel/ChannelOaController.java | 21 ++---- .../channel/ChannelOaMenuController.java | 29 ++------ .../ChannelOaReplyDefaultController.java | 54 +++------------ .../ChannelOaReplyFollowController.java | 54 +++------------ .../ChannelOaReplyKeywordController.java | 54 +++------------ .../channel/ChannelOpController.java | 21 ++---- .../decorate/DecorateDataController.java | 14 ++-- .../decorate/DecoratePagesController.java | 8 ++- .../decorate/DecorateTabbarController.java | 8 ++- .../monitor/MonitorCacheController.java | 7 +- .../monitor/MonitorServerController.java | 7 +- .../setting/SettingCopyrightController.java | 21 ++---- .../setting/SettingDictDataController.java | 55 +++------------ .../setting/SettingDictTypeController.java | 54 +++------------ .../setting/SettingLoginController.java | 18 ++--- .../setting/SettingNoticeController.java | 27 ++------ .../setting/SettingProtocolController.java | 21 ++---- .../setting/SettingSearchController.java | 21 ++---- .../setting/SettingSmsController.java | 26 ++----- .../setting/SettingStorageController.java | 36 ++-------- .../setting/SettingUserController.java | 21 ++---- .../setting/SettingWebsiteController.java | 21 ++---- .../system/SystemAuthAdminController.java | 67 +++--------------- .../system/SystemAuthDeptController.java | 53 +++----------- .../system/SystemAuthMenuController.java | 52 +++----------- .../system/SystemAuthPostController.java | 52 +++----------- .../system/SystemAuthRoleController.java | 53 +++----------- .../system/SystemLoginController.java | 29 ++------ .../system/SystemLogsController.java | 22 ++---- .../mdd/admin/validate/AlbumCateValidate.java | 9 ++- .../mdd/admin/validate/AlbumMoveValidate.java | 8 ++- .../admin/validate/AlbumRenameValidate.java | 8 ++- .../admin/validate/AlbumSearchValidate.java | 9 ++- .../admin/validate/ArtCateCreateValidate.java | 9 ++- .../admin/validate/ArtCateSearchValidate.java | 8 ++- .../admin/validate/ArtCateUpdateValidate.java | 10 ++- .../admin/validate/ArticleCreateValidate.java | 16 ++++- .../admin/validate/ArticleSearchValidate.java | 11 ++- .../admin/validate/ArticleUpdateValidate.java | 17 ++++- .../admin/validate/CrontabCreateValidate.java | 11 +++ .../admin/validate/CrontabUpdateValidate.java | 12 ++++ .../admin/validate/DecoratePageValidate.java | 9 +-- .../admin/validate/DecorateTabsValidate.java | 6 +- .../admin/validate/UsersSearchValidate.java | 10 ++- .../admin/validate/UsersUpdateValidate.java | 9 ++- .../validate/channel/ChannelH5Validate.java | 9 ++- .../validate/channel/ChannelMpValidate.java | 5 +- .../validate/channel/ChannelOaValidate.java | 5 +- .../validate/channel/ChannelOpValidate.java | 8 ++- .../channel/ChannelRpDefaultValidate.java | 11 ++- .../channel/ChannelRpFollowsValidate.java | 11 ++- .../channel/ChannelRpKeywordValidate.java | 13 +++- .../admin/validate/commons/IdValidate.java | 7 +- .../admin/validate/commons/IdsValidate.java | 7 +- .../admin/validate/commons/PageValidate.java | 5 +- .../setting/DictDataCreateValidate.java | 12 +++- .../setting/DictDataUpdateValidate.java | 13 +++- .../setting/DictTypeCreateValidate.java | 10 ++- .../setting/DictTypeUpdateValidate.java | 11 ++- .../setting/SettingCopyrightValidate.java | 7 +- .../setting/SettingLoginValidate.java | 6 +- .../setting/SettingProtocolValidate.java | 8 ++- .../setting/SettingSearchValidate.java | 8 ++- .../validate/setting/SettingUserValidate.java | 5 +- .../setting/SettingWebsiteValidate.java | 5 +- .../system/SystemAdminCreateValidate.java | 16 ++++- .../system/SystemAdminLoginsValidate.java | 10 ++- .../system/SystemAdminSearchValidate.java | 9 ++- .../system/SystemAdminUpInfoValidate.java | 7 +- .../system/SystemAdminUpdateValidate.java | 19 +++-- .../system/SystemDeptCreateValidate.java | 11 ++- .../system/SystemDeptSearchValidate.java | 8 ++- .../system/SystemDeptUpdateValidate.java | 12 +++- .../system/SystemMenuCreateValidate.java | 19 ++++- .../system/SystemMenuUpdateValidate.java | 20 +++++- .../system/SystemPostCreateValidate.java | 11 ++- .../system/SystemPostSearchValidate.java | 9 ++- .../system/SystemPostUpdateValidate.java | 18 +++-- .../system/SystemRoleCreateValidate.java | 12 ++-- .../system/SystemRoleUpdateValidate.java | 12 +++- .../system/SystemSearchLoginsValidate.java | 10 ++- .../system/SystemSearchOperateValidate.java | 14 +++- .../com/mdd/admin/vo/CrontabDetailVo.java | 45 ++++++++---- .../com/mdd/admin/vo/CrontabListedVo.java | 51 ++++++++++---- .../com/mdd/admin/vo/album/AlbumCateVo.java | 25 ++++--- .../java/com/mdd/admin/vo/album/AlbumVo.java | 41 +++++++---- .../mdd/admin/vo/article/ArticleCateVo.java | 33 ++++++--- .../mdd/admin/vo/article/ArticleDetailVo.java | 57 ++++++++++----- .../mdd/admin/vo/article/ArticleListedVo.java | 45 ++++++++---- .../com/mdd/admin/vo/channel/ChannelH5Vo.java | 17 +++-- .../com/mdd/admin/vo/channel/ChannelMpVo.java | 18 ++++- .../com/mdd/admin/vo/channel/ChannelOaVo.java | 18 ++++- .../com/mdd/admin/vo/channel/ChannelOpVo.java | 9 ++- .../admin/vo/channel/ChannelRpDefaultVo.java | 17 ++++- .../admin/vo/channel/ChannelRpFollowsVo.java | 17 ++++- .../admin/vo/channel/ChannelRpKeywordVo.java | 21 +++++- .../com/mdd/admin/vo/channel/ChannelRpVo.java | 25 ------- .../vo/decorate/DecorateDataArticleVo.java | 21 +++++- .../mdd/admin/vo/decorate/DecoratePageVo.java | 11 ++- .../admin/vo/decorate/DecorateTabbarVo.java | 9 ++- .../vo/decorate/DecorateTabsListsVo.java | 19 ++++- .../vo/decorate/DecorateTabsStyleVo.java | 9 ++- .../admin/vo/setting/SettingCopyrightVo.java | 9 ++- .../admin/vo/setting/SettingDictDataVo.java | 41 +++++++---- .../admin/vo/setting/SettingDictTypeVo.java | 33 ++++++--- .../mdd/admin/vo/setting/SettingLoginVo.java | 25 ++++--- .../vo/setting/SettingNoticeDetailVo.java | 21 +++++- .../vo/setting/SettingNoticeListedVo.java | 41 +++++++---- .../vo/setting/SettingProtocolDetailVo.java | 9 ++- .../vo/setting/SettingProtocolObjectVo.java | 8 ++- .../vo/setting/SettingSearchDetailVo.java | 9 ++- .../vo/setting/SettingSearchObjectVo.java | 9 ++- .../mdd/admin/vo/setting/SettingUserVo.java | 7 +- .../admin/vo/setting/SettingWebsiteVo.java | 15 ++++ .../vo/system/SystemAuthAdminDetailVo.java | 57 ++++++++++----- .../vo/system/SystemAuthAdminInformVo.java | 53 ++++++++++---- .../vo/system/SystemAuthAdminListedVo.java | 53 ++++++++++---- .../vo/system/SystemAuthAdminSelvesVo.java | 13 ++-- .../mdd/admin/vo/system/SystemAuthDeptVo.java | 41 +++++++---- .../mdd/admin/vo/system/SystemAuthMenuVo.java | 69 ++++++++++++++----- .../mdd/admin/vo/system/SystemAuthPostVo.java | 37 +++++++--- .../mdd/admin/vo/system/SystemAuthRoleVo.java | 41 +++++++---- .../mdd/admin/vo/system/SystemCaptchaVo.java | 9 ++- .../mdd/admin/vo/system/SystemLogLoginVo.java | 33 ++++++--- .../admin/vo/system/SystemLogOperateVo.java | 65 ++++++++++++----- .../mdd/admin/vo/system/SystemLoginVo.java | 9 ++- .../java/com/mdd/admin/vo/user/UserVo.java | 29 +++++++- 136 files changed, 1529 insertions(+), 1524 deletions(-) delete mode 100644 server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpVo.java diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/AlbumsController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/AlbumsController.java index 42971cc6..a89183fa 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/AlbumsController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/AlbumsController.java @@ -13,120 +13,79 @@ import com.mdd.admin.validate.commons.PageValidate; import com.mdd.admin.vo.album.AlbumVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 相册管理 - */ @RestController @RequestMapping("api/albums") +@Api(tags = "相册数据管理") public class AlbumsController { @Resource IAlbumsService iAlbumsService; - /** - * 相册文件列表 - * - * @author fzr - * @return AjaxResult> - */ @GetMapping("/albumList") + @ApiOperation(value="相册文件列表") public AjaxResult> albumList(@Validated PageValidate pageValidate, @Validated AlbumSearchValidate searchValidate) { PageResult voPageResult = iAlbumsService.albumList(pageValidate, searchValidate); return AjaxResult.success(voPageResult); } - /** - * 相册文件重命名 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册文件重命名") @PostMapping("/albumRename") + @ApiOperation(value="相册文件重命名") public AjaxResult albumRename(@Validated @RequestBody AlbumRenameValidate renameValidate) { iAlbumsService.albumRename(renameValidate.getId(), renameValidate.getName()); return AjaxResult.success(); } - /** - * 相册文件移动 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册文件移动") @PostMapping("/albumMove") + @ApiOperation(value="相册文件移动") public AjaxResult albumMove(@Validated @RequestBody AlbumMoveValidate moveValidate) { iAlbumsService.albumMove(moveValidate.getIds(), moveValidate.getCid()); return AjaxResult.success(); } - /** - * 相册文件删除 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册文件删除") @PostMapping("/albumDel") + @ApiOperation(value="相册文件删除") public AjaxResult albumDel(@Validated @RequestBody IdsValidate idsValidate) { iAlbumsService.albumDel(idsValidate.getIds()); return AjaxResult.success(); } - /** - * 相册分类列表 - * - * @author fzr - * @param searchValidate 搜索参数 - * @return AjaxResult - */ @GetMapping("/cateList") + @ApiOperation(value="相册分类列表") public AjaxResult cateList(@Validated AlbumSearchValidate searchValidate) { JSONArray jsonArray = iAlbumsService.cateList(searchValidate); return AjaxResult.success(jsonArray); } - /** - * 相册分类新增 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册分类新增") @PostMapping("/cateAdd") + @ApiOperation(value="相册分类新增") public AjaxResult cateAdd(@Validated @RequestBody AlbumCateValidate cateValidate) { iAlbumsService.cateAdd(cateValidate); return AjaxResult.success(); } - /** - * 相册分类重命名 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册分类重命名") @PostMapping("/cateRename") + @ApiOperation(value="相册分类重命名") public AjaxResult cateRename(@Validated @RequestBody AlbumRenameValidate renameValidate) { iAlbumsService.cateRename(renameValidate.getId(), renameValidate.getName()); return AjaxResult.success(); } - /** - * 相册分类删除 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "相册分类删除") @PostMapping("/cateDel") + @ApiOperation(value="相册分类删除") public AjaxResult cateDel(@Validated @RequestBody IdValidate idValidate) { iAlbumsService.cateDel(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/ArtCateController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/ArtCateController.java index 47f5e386..3eda39fa 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/ArtCateController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/ArtCateController.java @@ -12,114 +12,72 @@ import com.mdd.admin.vo.article.ArticleCateVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 文章分类管理 - */ @RestController @RequestMapping("api/article/cate") +@Api(tags = "文章分类管理") public class ArtCateController { @Resource IArtCateService iArtCateService; - /** - * 分类所有 - * - * @author fzr - * @return AjaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="所有分类") public AjaxResult> all() { List list = iArtCateService.all(); return AjaxResult.success(list); } - /** - * 分类列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="分类列表") public AjaxResult> list(@Validated PageValidate pageValidate, @Validated ArtCateSearchValidate searchValidate) { PageResult list = iArtCateService.list(pageValidate, searchValidate); return AjaxResult.success(list); } - /** - * 分类详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="分类详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { ArticleCateVo vo = iArtCateService.detail(id); return AjaxResult.success(vo); } - /** - * 分类新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @Log(title = "文章分类新增") @PostMapping("/add") + @ApiOperation(value="分类新增") public AjaxResult add(@Validated @RequestBody ArtCateCreateValidate createValidate) { iArtCateService.add(createValidate); return AjaxResult.success(); } - /** - * 分类编辑 - * - * @author fzr - * @param updateValidate 编辑 - * @return AjaxResult - */ @Log(title = "文章分类编辑") @PostMapping("/edit") + @ApiOperation(value="分类编辑") public AjaxResult edit(@Validated @RequestBody ArtCateUpdateValidate updateValidate) { iArtCateService.edit(updateValidate); return AjaxResult.success(); } - /** - * 分类删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "文章分类删除") @PostMapping("/del") + @ApiOperation(value="分类删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iArtCateService.del(idValidate.getId()); return AjaxResult.success(); } - /** - * 分类状态 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "文章分类状态") @PostMapping("/change") + @ApiOperation(value="分类状态") public AjaxResult change(@Validated @RequestBody IdValidate idValidate) { iArtCateService.change(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/ArticleController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/ArticleController.java index 4a59306f..8156bd70 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/ArticleController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/ArticleController.java @@ -13,100 +13,63 @@ import com.mdd.admin.vo.article.ArticleListedVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 文章管理 - */ @RestController @RequestMapping("api/article") +@Api(tags = "文章数据管理") public class ArticleController { @Resource IArticleService iArticleService; - /** - * 文章列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="文章列表") public AjaxResult> list(@Validated PageValidate pageValidate, @Validated ArticleSearchValidate searchValidate) { PageResult vos = iArticleService.list(pageValidate, searchValidate); return AjaxResult.success(vos); } - /** - * 文章详情 - * - * @author fzr - * @param id 文章ID - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="文章详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { ArticleDetailVo vo = iArticleService.detail(id); return AjaxResult.success(vo); } - /** - * 文章新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @Log(title = "文章新增") @PostMapping("/add") + @ApiOperation(value="文章新增") public AjaxResult add(@Validated @RequestBody ArticleCreateValidate createValidate) { iArticleService.add(createValidate); return AjaxResult.success(); } - /** - * 文章编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @Log(title = "文章编辑") @PostMapping("/edit") + @ApiOperation(value="文章编辑") public AjaxResult edit(@Validated @RequestBody ArticleUpdateValidate updateValidate) { iArticleService.edit(updateValidate); return AjaxResult.success(); } - /** - * 文章删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "文章删除") @PostMapping("/del") + @ApiOperation(value="文章删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iArticleService.del(idValidate.getId()); return AjaxResult.success(); } - /** - * 文章状态 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "文章状态") @PostMapping("/change") + @ApiOperation(value="文章状态") public AjaxResult change(@Validated @RequestBody IdValidate idValidate) { iArticleService.change(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/CrontabController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/CrontabController.java index c79a86f5..d4a51295 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/CrontabController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/CrontabController.java @@ -10,6 +10,8 @@ import com.mdd.admin.vo.CrontabListedVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.quartz.SchedulerException; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; @@ -18,71 +20,42 @@ import javax.annotation.Resource; @RestController @RequestMapping("api/crontab") +@Api(tags = "计划任务管理") public class CrontabController { @Resource ICrontabService iCrontabService; - /** - * 计划任务列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @return AjaxResult< PageResult> - */ @GetMapping("/list") + @ApiOperation(value="计划任务列表") public AjaxResult< PageResult> list(@Validated PageValidate pageValidate) { PageResult list = iCrontabService.list(pageValidate); return AjaxResult.success(list); } - /** - * 计划任务详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="计划任务详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { CrontabDetailVo vo = iCrontabService.detail(id); return AjaxResult.success(vo); } - /** - * 计划任务新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="计划任务新增") public AjaxResult add(@Validated @RequestBody CrontabCreateValidate createValidate) throws SchedulerException { iCrontabService.add(createValidate); return AjaxResult.success(); } - /** - * 计划任务编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="计划任务编辑") public AjaxResult edit(@Validated @RequestBody CrontabUpdateValidate updateValidate) throws SchedulerException { iCrontabService.edit(updateValidate); return AjaxResult.success(); } - /** - * 计划任务删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="计划任务删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) throws SchedulerException { iCrontabService.del(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/IndexController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/IndexController.java index 06f97bd6..94d5aa24 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/IndexController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/IndexController.java @@ -3,6 +3,8 @@ package com.mdd.admin.controller; import com.mdd.common.aop.NotLogin; import com.mdd.admin.service.IIndexService; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import lombok.extern.slf4j.Slf4j; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; @@ -11,37 +13,25 @@ import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; import java.util.Map; -/** - * 主页管理 - */ @Slf4j @RestController @RequestMapping("api/index") +@Api(tags = "主页数据管理") public class IndexController { @Resource IIndexService iIndexService; - /** - * 控制台 - * - * @author fzr - * @return AjaxResult> - */ @GetMapping("/console") + @ApiOperation(value="控制台") public AjaxResult> console() { Map map = iIndexService.console(); return AjaxResult.success(map); } - /** - * 公共配置 - * - * @author fzr - * @return AjaxResult - */ @NotLogin @GetMapping("/config") + @ApiOperation(value="公共配置") public AjaxResult> config() { Map map = iIndexService.config(); return AjaxResult.success(map); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/UploadController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/UploadController.java index be966a99..c978d9cf 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/UploadController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/UploadController.java @@ -10,6 +10,8 @@ import com.mdd.common.exception.OperateException; import com.mdd.common.plugin.storage.StorageDriver; import com.mdd.common.plugin.storage.UploadFilesVo; import com.mdd.common.util.StringUtils; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @@ -21,25 +23,17 @@ import javax.servlet.http.HttpServletRequest; import java.util.LinkedHashMap; import java.util.Map; -/** - * 上传管理 - */ @RestController @RequestMapping("api/upload") +@Api(tags = "上传文件管理") public class UploadController { @Resource IAlbumsService iAlbumsService; - /** - * 上传图片 - * - * @author fzr - * @param request 请求对象 - * @return AjaxResult - */ @Log(title = "上传图片", requestType = RequestType.File) @PostMapping("/image") + @ApiOperation(value="上传图片") public AjaxResult image(HttpServletRequest request) { MultipartFile multipartFile; try { @@ -70,15 +64,9 @@ public class UploadController { return AjaxResult.success(vo); } - /** - * 上传视频 - * - * @author fzr - * @param request 请求对象 - * @return AjaxResult - */ @Log(title = "上传视频", requestType = RequestType.File) @PostMapping("/video") + @ApiOperation(value="上传视频") public AjaxResult video(HttpServletRequest request) { MultipartFile multipartFile; try { diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/UsersController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/UsersController.java index d977c82a..4d9cc31d 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/UsersController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/UsersController.java @@ -8,57 +8,38 @@ import com.mdd.admin.vo.user.UserVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 用户管理 - */ @RestController @RequestMapping("api/user") +@Api(tags = "用户数据管理") public class UsersController { @Resource IUsersService iUsersService; - /** - * 用户列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="用户列表") public AjaxResult> list(@Validated PageValidate pageValidate, @Validated UsersSearchValidate searchValidate) { PageResult list = iUsersService.list(pageValidate, searchValidate); return AjaxResult.success(list); } - /** - * 用户详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="用户详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { UserVo vo = iUsersService.detail(id); return AjaxResult.success(vo); } - /** - * 用户编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="用户编辑") public AjaxResult edit(@Validated @RequestBody UsersUpdateValidate updateValidate) { iUsersService.edit(updateValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelH5Controller.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelH5Controller.java index 797662ef..f0041614 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelH5Controller.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelH5Controller.java @@ -5,42 +5,31 @@ import com.mdd.admin.service.IChannelH5ConfigService; import com.mdd.admin.validate.channel.ChannelH5Validate; import com.mdd.admin.vo.channel.ChannelH5Vo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * H5渠道设置 - */ @RestController @RequestMapping("api/channel/h5") +@Api(tags = "移动渠道设置") public class ChannelH5Controller { @Resource IChannelH5ConfigService iChannelH5ConfigService; - /** - * H5渠道设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="H5渠道设置详情") public AjaxResult detail() { ChannelH5Vo vo = iChannelH5ConfigService.detail(); return AjaxResult.success(vo); } - /** - * H5渠道设置保存 - * - * @author fzr - * @param channelH5Validate 参数 - * @return AjaxResult - */ @Log(title = "H5渠道设置保存") @PostMapping("/save") + @ApiOperation(value="H5渠道设置保存") public AjaxResult save(@Validated @RequestBody ChannelH5Validate channelH5Validate) { iChannelH5ConfigService.save(channelH5Validate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelMpController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelMpController.java index 00709a54..2f956ce8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelMpController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelMpController.java @@ -5,42 +5,31 @@ import com.mdd.admin.service.IChannelMpConfigService; import com.mdd.admin.validate.channel.ChannelMpValidate; import com.mdd.admin.vo.channel.ChannelMpVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 微信小程序渠道设置 - */ @RestController @RequestMapping("api/channel/mp") +@Api(tags = "微信程序渠道") public class ChannelMpController { @Resource IChannelMpConfigService iChannelMpConfigService; - /** - * 微信小程序渠道设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="微信程序渠道设置详情") public AjaxResult detail() { ChannelMpVo vo = iChannelMpConfigService.detail(); return AjaxResult.success(vo); } - /** - * 微信小程序渠道设置保存 - * - * @author fzr - * @param channelMpValidate 参数 - * @return AjaxResult - */ @Log(title = "微信小程序渠道设置保存") @PostMapping("/save") + @ApiOperation(value="微信程序渠道设置保存") public AjaxResult save(@Validated @RequestBody ChannelMpValidate channelMpValidate) { iChannelMpConfigService.save(channelMpValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaController.java index a9e717d4..30837018 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaController.java @@ -5,42 +5,31 @@ import com.mdd.admin.service.IChannelOaConfigService; import com.mdd.admin.validate.channel.ChannelOaValidate; import com.mdd.admin.vo.channel.ChannelOaVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 微信公众号渠道设置 - */ @RestController @RequestMapping("api/channel/oa") +@Api(tags = "公众号渠道设置") public class ChannelOaController { @Resource IChannelOaConfigService iChannelOaConfigService; - /** - * 公众号渠道设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="公众号渠道设置详情") public AjaxResult detail() { ChannelOaVo vo = iChannelOaConfigService.detail(); return AjaxResult.success(vo); } - /** - * 公众号渠道设置保存 - * - * @author fzr - * @param channelOaValidate 参数 - * @return AjaxResult - */ @Log(title = "公众号渠道设置保存") @PostMapping("/save") + @ApiOperation(value="公众号渠道设置保存") public AjaxResult save(@Validated @RequestBody ChannelOaValidate channelOaValidate) { iChannelOaConfigService.save(channelOaValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaMenuController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaMenuController.java index 6f01b548..802f6d28 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaMenuController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaMenuController.java @@ -3,54 +3,37 @@ package com.mdd.admin.controller.channel; import com.alibaba.fastjson2.JSONArray; import com.mdd.admin.service.IChannelOaMenusService; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 公众号菜单管理 - */ @RestController @RequestMapping("api/channel/oaMenu") +@Api(tags = "公众号菜单管理") public class ChannelOaMenuController { @Resource IChannelOaMenusService iChannelOaMenusService; - /** - * 菜单详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="菜单详情") public AjaxResult detail() { JSONArray detail = iChannelOaMenusService.detail(); return AjaxResult.success(detail); } - /** - * 仅是保存菜单 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="仅是保存菜单") public AjaxResult save(@RequestBody List params) { iChannelOaMenusService.save(params, false); return AjaxResult.success(); } - /** - * 保存并发布菜单 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @PostMapping("/publish") + @ApiOperation(value="保存并发布菜单") public AjaxResult publish(@RequestBody List params) { iChannelOaMenusService.save(params, true); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyDefaultController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyDefaultController.java index f47560ed..e051d008 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyDefaultController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyDefaultController.java @@ -8,94 +8,58 @@ import com.mdd.admin.vo.channel.ChannelRpDefaultVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 公众号默认回复管理 - */ @RestController @RequestMapping("api/channel/oaReplyDefault") +@Api(tags = "公众号默认回复") public class ChannelOaReplyDefaultController { @Resource IChannelOaReplyDefaultService iChannelOaReplyDefaultService; - /** - * 默认回复列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="默认回复列表") public AjaxResult> list(@Validated PageValidate pageValidate) { PageResult list = iChannelOaReplyDefaultService.list(pageValidate); return AjaxResult.success(list); } - /** - * 默认回复详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="默认回复详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { ChannelRpDefaultVo vo = iChannelOaReplyDefaultService.detail(id); return AjaxResult.success(vo); } - /** - * 默认回复新增 - * - * @author fzr - * @param defaultValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="默认回复新增") public AjaxResult add(@Validated @RequestBody ChannelRpDefaultValidate defaultValidate) { iChannelOaReplyDefaultService.add(defaultValidate); return AjaxResult.success(); } - /** - * 默认回复编辑 - * - * @author fzr - * @param defaultValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="默认回复编辑") public AjaxResult edit(@Validated @RequestBody ChannelRpDefaultValidate defaultValidate) { iChannelOaReplyDefaultService.edit(defaultValidate); return AjaxResult.success(); } - /** - * 默认回复删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="默认回复删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyDefaultService.del(idValidate.getId()); return AjaxResult.success(); } - /** - * 默认回复状态 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/status") + @ApiOperation(value="默认回复状态") public AjaxResult status(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyDefaultService.status(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyFollowController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyFollowController.java index f95f2b1c..02ffcff0 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyFollowController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyFollowController.java @@ -8,94 +8,58 @@ import com.mdd.admin.vo.channel.ChannelRpFollowsVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 公众号关注回复管理 - */ @RestController @RequestMapping("api/channel/oaReplyFollow") +@Api(tags = "公众号关注回复") public class ChannelOaReplyFollowController { @Resource IChannelOaReplyFollowService iChannelOaReplyFollowService; - /** - * 关注回复列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="关注回复列表") public AjaxResult> list(@Validated PageValidate pageValidate) { PageResult list = iChannelOaReplyFollowService.list(pageValidate); return AjaxResult.success(list); } - /** - * 关注回复详情 - * - * @author fzr - * @param id 参数 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="关注回复详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { ChannelRpFollowsVo vo = iChannelOaReplyFollowService.detail(id); return AjaxResult.success(vo); } - /** - * 关注回复新增 - * - * @author fzr - * @param followsValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="关注回复新增") public AjaxResult add(@Validated @RequestBody ChannelRpFollowsValidate followsValidate) { iChannelOaReplyFollowService.add(followsValidate); return AjaxResult.success(); } - /** - * 关注回复编辑 - * - * @author fzr - * @param followsValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="关注回复编辑") public AjaxResult edit(@Validated @RequestBody ChannelRpFollowsValidate followsValidate) { iChannelOaReplyFollowService.edit(followsValidate); return AjaxResult.success(); } - /** - * 关注回复删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="关注回复删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyFollowService.del(idValidate.getId()); return AjaxResult.success(); } - /** - * 关注回复状态 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/status") + @ApiOperation(value="关注回复状态") public AjaxResult status(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyFollowService.status(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyKeywordController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyKeywordController.java index 4038f47d..6d536730 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyKeywordController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOaReplyKeywordController.java @@ -8,97 +8,61 @@ import com.mdd.admin.vo.channel.ChannelRpKeywordVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 公众号关键词回复管理 - */ @RestController @RequestMapping("api/channel/oaReplyKeyword") +@Api(tags = "公众号关键回复") public class ChannelOaReplyKeywordController { @Resource IChannelOaReplyKeywordService iChannelOaReplyKeywordService; - /** - * 关键词回复列表 - * - * @author fzr - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="关键词回复列表") public AjaxResult> list(@Validated PageValidate pageValidate) { PageResult list = iChannelOaReplyKeywordService.list(pageValidate); return AjaxResult.success(list); } - /** - * 关键词回复详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="关键词回复详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { ChannelRpKeywordVo vo = iChannelOaReplyKeywordService.detail(id); return AjaxResult.success(vo); } - /** - * 关键词回复新增 - * - * @author fzr - * @param keywordValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="关键词回复新增") public AjaxResult add(@Validated @RequestBody ChannelRpKeywordValidate keywordValidate) { iChannelOaReplyKeywordService.add(keywordValidate); return AjaxResult.success(); } - /** - * 关键词回复编辑 - * - * @author fzr - * @param keywordValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="关键词回复编辑") public AjaxResult edit(@Validated @RequestBody ChannelRpKeywordValidate keywordValidate) { iChannelOaReplyKeywordService.edit(keywordValidate); return AjaxResult.success(); } - /** - * 关键词回复删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="关键词回复删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyKeywordService.del(idValidate.getId()); return AjaxResult.success(); } - /** - * 关键词回复状态 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/status") + @ApiOperation(value="关键词回复状态") public AjaxResult status(@Validated @RequestBody IdValidate idValidate) { iChannelOaReplyKeywordService.status(idValidate.getId()); return AjaxResult.success(); } - } diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOpController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOpController.java index 2660297a..36d5e552 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOpController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/channel/ChannelOpController.java @@ -4,41 +4,30 @@ import com.mdd.admin.service.IChannelOpService; import com.mdd.admin.validate.channel.ChannelOpValidate; import com.mdd.admin.vo.channel.ChannelOpVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 微信开发平台渠道设置 - */ @RestController @RequestMapping("api/channel/op") +@Api(tags = "微信开放渠道") public class ChannelOpController { @Resource IChannelOpService iChannelOpService; - /** - * 开放平台设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="开放平台设置详情") public AjaxResult detail() { ChannelOpVo vo = iChannelOpService.detail(); return AjaxResult.success(vo); } - /** - * 开放平台设置保存 - * - * @author fzr - * @param opValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="开放平台设置保存") public AjaxResult save(@Validated @RequestBody ChannelOpValidate opValidate) { iChannelOpService.save(opValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateDataController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateDataController.java index dfe9fd1e..9a96e634 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateDataController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateDataController.java @@ -4,6 +4,8 @@ import com.mdd.common.aop.NotPower; import com.mdd.admin.service.IDecorateDataService; import com.mdd.admin.vo.decorate.DecorateDataArticleVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RequestParam; @@ -12,25 +14,17 @@ import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; import java.util.List; -/** - * 装修数据管理 - */ @RestController @RequestMapping("api/decorate/data") +@Api(tags = "装修数据管理") public class DecorateDataController { @Resource IDecorateDataService iDecorateDataService; - /** - * 获取文章数据 - * - * @author fzr - * @param limit 条数 - * @return AjaxResult> - */ @NotPower @GetMapping("/article") + @ApiOperation(value="获取文章数据") public AjaxResult> article(@RequestParam(defaultValue = "10") Integer limit) { List list = iDecorateDataService.article(limit); return AjaxResult.success(list); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecoratePagesController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecoratePagesController.java index 59d9b203..ab5592a3 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecoratePagesController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecoratePagesController.java @@ -6,16 +6,16 @@ import com.mdd.admin.validate.DecoratePageValidate; import com.mdd.admin.vo.decorate.DecoratePageVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 页面装修管理 - */ @RestController @RequestMapping("api/decorate/pages") +@Api(tags = "装修页面管理") public class DecoratePagesController { @Resource @@ -29,6 +29,7 @@ public class DecoratePagesController { * @return AjaxResult */ @GetMapping("/detail") + @ApiOperation(value="页面装修详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { DecoratePageVo vo = iDecoratePageService.detail(id); return AjaxResult.success(vo); @@ -43,6 +44,7 @@ public class DecoratePagesController { */ @Log(title = "页面装修保存") @PostMapping("/save") + @ApiOperation(value="页面装修保存") public AjaxResult save(@RequestBody DecoratePageValidate decoratePageValidate) { iDecoratePageService.save(decoratePageValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateTabbarController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateTabbarController.java index af3da643..a2c00ce6 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateTabbarController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/decorate/DecorateTabbarController.java @@ -4,16 +4,16 @@ import com.mdd.admin.service.IDecorateTabbarService; import com.mdd.admin.validate.DecorateTabsValidate; import com.mdd.admin.vo.decorate.DecorateTabbarVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 装修底部导航管理 - */ @RestController @RequestMapping("api/decorate/tabbar") +@Api(tags = "装修导航管理") public class DecorateTabbarController { @Resource @@ -26,6 +26,7 @@ public class DecorateTabbarController { * @return AjaxResult */ @GetMapping("/detail") + @ApiOperation(value="底部导航详情") public AjaxResult detail() { DecorateTabbarVo vo = iDecorateTabbarService.detail(); return AjaxResult.success(vo); @@ -39,6 +40,7 @@ public class DecorateTabbarController { * @return AjaxResult */ @PostMapping("/save") + @ApiOperation(value="底部导航保存") public AjaxResult save(@Validated @RequestBody DecorateTabsValidate tabsValidate) { iDecorateTabbarService.save(tabsValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorCacheController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorCacheController.java index 8e1e2803..38d15785 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorCacheController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorCacheController.java @@ -4,6 +4,8 @@ package com.mdd.admin.controller.monitor; import com.mdd.admin.aop.Log; import com.mdd.common.core.AjaxResult; import com.mdd.common.util.StringUtils; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.data.redis.connection.RedisServerCommands; import org.springframework.data.redis.core.RedisCallback; import org.springframework.data.redis.core.RedisTemplate; @@ -14,11 +16,9 @@ import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; import java.util.*; -/** - * 缓存监控管理 - */ @RestController @RequestMapping("api/monitor") +@Api(tags = "监控缓存管理") public class MonitorCacheController { @Resource @@ -32,6 +32,7 @@ public class MonitorCacheController { */ @Log(title = "缓存监控") @GetMapping("/cache") + @ApiOperation(value="缓存监控") public AjaxResult info() { Properties info = (Properties) redisTemplate.execute((RedisCallback) RedisServerCommands::info); Properties commandStats = (Properties) redisTemplate.execute((RedisCallback) connection -> connection.info("commandstats")); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorServerController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorServerController.java index 55def763..ceb920b1 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorServerController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/monitor/MonitorServerController.java @@ -3,17 +3,17 @@ package com.mdd.admin.controller.monitor; import com.mdd.admin.aop.Log; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.ServerResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import java.util.Map; -/** - * 服务监控管理 - */ @RestController @RequestMapping("api/monitor") +@Api(tags = "监控服务管理") public class MonitorServerController { /** @@ -24,6 +24,7 @@ public class MonitorServerController { */ @Log(title = "服务监控") @GetMapping("/server") + @ApiOperation(value="服务监控") public AjaxResult> info() { ServerResult server = new ServerResult(); return AjaxResult.success(server.copyTo()); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingCopyrightController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingCopyrightController.java index 392657d7..dcec4443 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingCopyrightController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingCopyrightController.java @@ -4,42 +4,31 @@ import com.mdd.admin.service.ISettingCopyrightService; import com.mdd.admin.validate.setting.SettingCopyrightValidate; import com.mdd.admin.vo.setting.SettingCopyrightVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 网站版权配置管理 - */ @RestController @RequestMapping("api/setting/copyright") +@Api(tags = "配置网站版权") public class SettingCopyrightController { @Resource ISettingCopyrightService iSettingCopyrightService; - /** - * 获取网站版权信息 - * - * @author fzr - * @return AjaxResult> - */ @GetMapping("/detail") + @ApiOperation(value="获取网站版权信息") public AjaxResult> detail() { List list = iSettingCopyrightService.detail(); return AjaxResult.success(list); } - /** - * 保存网站版本信息 - * - * @author fzr - * @param copyrightValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="保存网站版本信息") public AjaxResult save(@Validated @RequestBody SettingCopyrightValidate copyrightValidate) { iSettingCopyrightService.save(copyrightValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictDataController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictDataController.java index ddbd27e9..8f2912e8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictDataController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictDataController.java @@ -12,6 +12,8 @@ import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.util.StringUtils; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; @@ -19,40 +21,25 @@ import javax.annotation.Resource; import java.util.List; import java.util.Map; -/** - * 字典数据配置管理 - */ @RestController @RequestMapping("api/setting/dict/data") +@Api(tags = "配置字典数据") public class SettingDictDataController { @Resource ISettingDictDataService iSettingDictDataService; - /** - * 字典数据所有 - * - * @author fzr - * @param params 参数 - * @return jaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="字典数据所有") public AjaxResult> all(@RequestParam Map params) { Assert.isFalse(StringUtils.isEmpty(params.get("dictType")), "dictType缺失"); List list = iSettingDictDataService.all(params); return AjaxResult.success(list); } - /** - * 字典数据列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param params 搜索参数 - * @return PageResult - */ @GetMapping("/list") + @ApiOperation(value="字典数据列表") public AjaxResult> list(@Validated PageValidate pageValidate, @RequestParam Map params) { Assert.isFalse(StringUtils.isEmpty(params.get("dictType")), "dictType缺失"); @@ -60,53 +47,29 @@ public class SettingDictDataController { return AjaxResult.success(list); } - /** - * 字典数据详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="字典数据详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SettingDictDataVo vo = iSettingDictDataService.detail(id); return AjaxResult.success(vo); } - /** - * 字典数据新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="字典数据新增") public AjaxResult add(@Validated @RequestBody DictDataCreateValidate createValidate) { iSettingDictDataService.add(createValidate); return AjaxResult.success(); } - /** - * 字典数据编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="字典数据编辑") public AjaxResult edit(@Validated @RequestBody DictDataUpdateValidate updateValidate) { iSettingDictDataService.edit(updateValidate); return AjaxResult.success(); } - /** - * 字典数据删除 - * - * @author fzr - * @param idsValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="字典数据删除") public AjaxResult del(@Validated @RequestBody IdsValidate idsValidate) { iSettingDictDataService.del(idsValidate.getIds()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictTypeController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictTypeController.java index d72dcbcc..15a0590a 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictTypeController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingDictTypeController.java @@ -10,6 +10,8 @@ import com.mdd.admin.vo.setting.SettingDictTypeVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; @@ -17,91 +19,53 @@ import javax.annotation.Resource; import java.util.List; import java.util.Map; -/** - * 字典类型配置管理 - */ @RestController @RequestMapping("api/setting/dict/type") +@Api(tags = "配置字典类型") public class SettingDictTypeController { @Resource ISettingDictTypeService iSettingDictTypeService; - /** - * 字典类型所有 - * - * @author fzr - * @return AjaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="字典类型所有") public AjaxResult> all() { List list = iSettingDictTypeService.all(); return AjaxResult.success(list); } - /** - * 字典类型列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param params 搜索参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="字典类型列表") public AjaxResult> list(@Validated PageValidate pageValidate, @RequestParam Map params) { PageResult list = iSettingDictTypeService.list(pageValidate, params); return AjaxResult.success(list); } - /** - * 字典类型详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="字典类型详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SettingDictTypeVo vo = iSettingDictTypeService.detail(id); return AjaxResult.success(vo); } - /** - * 字典类型新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="字典类型新增") public AjaxResult add(@Validated @RequestBody DictTypeCreateValidate createValidate) { iSettingDictTypeService.add(createValidate); return AjaxResult.success(); } - /** - * 字典类型编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="字典类型编辑") public AjaxResult edit(@Validated @RequestBody DictTypeUpdateValidate updateValidate) { iSettingDictTypeService.edit(updateValidate); return AjaxResult.success(); } - /** - * 字典类型删除 - * - * @author fzr - * @param idsValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="字典类型删除") public AjaxResult del(@Validated @RequestBody IdsValidate idsValidate) { iSettingDictTypeService.del(idsValidate.getIds()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingLoginController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingLoginController.java index 591e631f..6d3bd45d 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingLoginController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingLoginController.java @@ -4,6 +4,8 @@ import com.mdd.admin.service.ISettingLoginService; import com.mdd.admin.validate.setting.SettingLoginValidate; import com.mdd.admin.vo.setting.SettingLoginVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; @@ -12,31 +14,21 @@ import java.util.Map; @RestController @RequestMapping("api/setting/login") +@Api(tags = "配置用户登录") public class SettingLoginController { @Resource ISettingLoginService iSettingLoginService; - /** - * 登录设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="登录设置详情") public AjaxResult detail() { SettingLoginVo vo = iSettingLoginService.detail(); return AjaxResult.success(vo); } - /** - * 登录设置保存 - * - * @author fzr - * @param loginValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="登录设置保存") public AjaxResult save(@Validated @RequestBody SettingLoginValidate loginValidate) { iSettingLoginService.save(loginValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingNoticeController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingNoticeController.java index 46518a82..084463fd 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingNoticeController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingNoticeController.java @@ -5,6 +5,8 @@ import com.mdd.admin.vo.setting.SettingNoticeDetailVo; import com.mdd.admin.vo.setting.SettingNoticeListedVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; @@ -17,45 +19,28 @@ import java.util.Map; */ @RestController @RequestMapping("api/setting/notice") +@Api(tags = "配置消息通知") public class SettingNoticeController { @Resource ISettingNoticeService iSettingNoticeService; - /** - * 通知设置列表 - * - * @author fzr - * @param recipient 类型: 1=用户, 2=平台 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="通知设置列表") public AjaxResult> list(@RequestParam Integer recipient) { List list = iSettingNoticeService.list(recipient); return AjaxResult.success(list); } - /** - * 通知设置详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="通知设置详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SettingNoticeDetailVo vo = iSettingNoticeService.detail(id); return AjaxResult.success(vo); } - /** - * 通知设置保存 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="通知设置保存") public AjaxResult save(@RequestBody Map params) { iSettingNoticeService.save(params); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingProtocolController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingProtocolController.java index 03cf7681..3996eb84 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingProtocolController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingProtocolController.java @@ -4,41 +4,30 @@ import com.mdd.admin.service.ISettingProtocolService; import com.mdd.admin.validate.setting.SettingProtocolValidate; import com.mdd.admin.vo.setting.SettingProtocolDetailVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 政策协议配置管理 - */ @RestController @RequestMapping("api/setting/protocol") +@Api(tags = "配置政策协议") public class SettingProtocolController { @Resource ISettingProtocolService iSettingProtocolService; - /** - * 获取政策协议信息 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="获取政策协议信息") public AjaxResult detail() { SettingProtocolDetailVo detail = iSettingProtocolService.detail(); return AjaxResult.success(detail); } - /** - * 保存政策协议信息 - * - * @author fzr - * @param protocolValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="保存政策协议信息") public AjaxResult save(@Validated @RequestBody SettingProtocolValidate protocolValidate) { iSettingProtocolService.save(protocolValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSearchController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSearchController.java index 7f05f709..d5621e93 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSearchController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSearchController.java @@ -4,42 +4,31 @@ import com.mdd.admin.service.ISettingSearchService; import com.mdd.admin.validate.setting.SettingSearchValidate; import com.mdd.admin.vo.setting.SettingSearchDetailVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.Map; -/** - * 热搜设置 - */ @RestController @RequestMapping("api/setting/search") +@Api(tags = "配置热门搜索") public class SettingSearchController { @Resource ISettingSearchService iSettingSearchService; - /** - * 热门搜索详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="热门搜索详情") public AjaxResult detail() { SettingSearchDetailVo vo = iSettingSearchService.detail(); return AjaxResult.success(vo); } - /** - * 热门搜索保存 - * - * @author fzr - * @param searchValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="热门搜索保存") public AjaxResult save(@Validated @RequestBody SettingSearchValidate searchValidate) { iSettingSearchService.save(searchValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSmsController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSmsController.java index ca0636e3..0d8718d3 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSmsController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingSmsController.java @@ -3,6 +3,8 @@ package com.mdd.admin.controller.setting; import com.mdd.admin.aop.Log; import com.mdd.admin.service.ISettingSmsService; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; @@ -14,45 +16,29 @@ import java.util.Map; */ @RestController @RequestMapping("api/setting/sms") +@Api(tags = "配置短信引擎") public class SettingSmsController { @Resource ISettingSmsService iSettingSmsService; - /** - * 短信引擎列表 - * - * @author fzr - * @return AjaxResult>> - */ @GetMapping("/list") + @ApiOperation(value="短信引擎列表") public AjaxResult>> list() { List> list = iSettingSmsService.list(); return AjaxResult.success(list); } - /** - * 短信引擎详情 - * - * @author fzr - * @param alias 别名 - * @return AjaxResult> - */ @GetMapping("/detail") + @ApiOperation(value="短信引擎详情") public AjaxResult> detail(String alias) { Map map = iSettingSmsService.detail(alias); return AjaxResult.success(map); } - /** - * 短信引擎保存 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @Log(title = "短信引擎保存") @PostMapping("/save") + @ApiOperation(value="短信引擎保存") public AjaxResult save(@RequestBody Map params) { iSettingSmsService.save(params); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingStorageController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingStorageController.java index 1517c10d..1bf54ca6 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingStorageController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingStorageController.java @@ -3,67 +3,45 @@ package com.mdd.admin.controller.setting; import com.baomidou.mybatisplus.core.toolkit.Assert; import com.mdd.admin.service.ISettingStorageService; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; import java.util.Map; -/** - * 存储方式配置管理 - */ @RestController @RequestMapping("api/setting/storage") +@Api(tags = "配置存储方式") public class SettingStorageController { @Resource ISettingStorageService iSettingStorageService; - /** - * 存储列表 - * - * @author fzr - * @return AjaxResult>> - */ @GetMapping("/list") + @ApiOperation(value="存储列表") public AjaxResult>> list() { List> list = iSettingStorageService.list(); return AjaxResult.success(list); } - /** - * 存储详情 - * - * @param alias 引擎别名 - * @return AjaxResult> - */ @GetMapping("/detail") + @ApiOperation(value="存储详情") public AjaxResult> detail(String alias) { Map map = iSettingStorageService.detail(alias); return AjaxResult.success(map); } - /** - * 存储编辑 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="存储编辑") public AjaxResult edit(@RequestBody Map params) { iSettingStorageService.edit(params); return AjaxResult.success(); } - /** - * 存储切换 - * - * @author fzr - * @param params 参数 - * @return AjaxResult - */ @PostMapping("/change") + @ApiOperation(value="存储切换") public AjaxResult change(@RequestBody Map params) { Assert.notNull(params.get("alias"), "alias参数缺失"); Assert.notNull(params.get("status"), "status参数缺失"); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingUserController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingUserController.java index b0b1a8e9..e7b5d230 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingUserController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingUserController.java @@ -4,41 +4,30 @@ import com.mdd.admin.service.ISettingUserService; import com.mdd.admin.validate.setting.SettingUserValidate; import com.mdd.admin.vo.setting.SettingUserVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 用户设置管理 - */ @RestController @RequestMapping("api/setting/user") +@Api(tags = "配置用户参数") public class SettingUserController { @Resource ISettingUserService iSettingUserService; - /** - * 用户设置详情 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="用户设置详情") public AjaxResult detail() { SettingUserVo vo = iSettingUserService.detail(); return AjaxResult.success(vo); } - /** - * 用户设置保存 - * - * @author fzr - * @param userValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="用户设置保存") public AjaxResult save(@Validated @RequestBody SettingUserValidate userValidate) { iSettingUserService.save(userValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingWebsiteController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingWebsiteController.java index cfb7ca85..6f157215 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingWebsiteController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/setting/SettingWebsiteController.java @@ -4,42 +4,31 @@ import com.mdd.admin.service.ISettingWebsiteService; import com.mdd.admin.validate.setting.SettingWebsiteValidate; import com.mdd.admin.vo.setting.SettingWebsiteVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.Map; -/** - * 网站信息配置管理 - */ @RestController @RequestMapping("api/setting/website") +@Api(tags = "配置网站信息") public class SettingWebsiteController { @Resource ISettingWebsiteService iSettingWebsiteService; - /** - * 获取网站配置信息 - * - * @author fzr - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="获取网站配置信息") public AjaxResult detail() { SettingWebsiteVo detail = iSettingWebsiteService.detail(); return AjaxResult.success(detail); } - /** - * 保存网站配置信息 - * - * @author fzr - * @param websiteValidate 参数 - * @return AjaxResult - */ @PostMapping("/save") + @ApiOperation(value="保存网站配置信息") public AjaxResult save(@Validated @RequestBody SettingWebsiteValidate websiteValidate) { iSettingWebsiteService.save(websiteValidate); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthAdminController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthAdminController.java index bb906416..88abe71f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthAdminController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthAdminController.java @@ -16,129 +16,84 @@ import com.mdd.admin.vo.system.SystemAuthAdminSelvesVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; -/** - * 系统管理员管理 - */ @RestController @RequestMapping("api/system/admin") +@Api(tags = "系统用户管理") public class SystemAuthAdminController { @Resource ISystemAuthAdminService iSystemAuthAdminService; - /** - * 管理员列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/list") + @ApiOperation(value="管理员列表") public AjaxResult> list(@Validated PageValidate pageValidate, @Validated SystemAdminSearchValidate searchValidate) { PageResult list = iSystemAuthAdminService.list(pageValidate, searchValidate); return AjaxResult.success(list); } - /** - * 管理员信息 - * - * @author fzr - * @return AjaxResult - */ @NotPower @GetMapping("/self") + @ApiOperation(value="管理员信息") public AjaxResult self() { Integer adminId = LikeAdminThreadLocal.getAdminId(); SystemAuthAdminSelvesVo vo = iSystemAuthAdminService.self(adminId); return AjaxResult.success(vo); } - /** - * 管理员详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="管理员详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SystemAuthAdminDetailVo vo = iSystemAuthAdminService.detail(id); return AjaxResult.success(vo); } - /** - * 管理员新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @Log(title = "管理员新增") @PostMapping("/add") + @ApiOperation(value="管理员新增") public AjaxResult add(@Validated @RequestBody SystemAdminCreateValidate createValidate) { iSystemAuthAdminService.add(createValidate); return AjaxResult.success(); } - /** - * 管理员编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @Log(title = "管理员编辑") @PostMapping("/edit") + @ApiOperation(value="管理员编辑") public AjaxResult edit(@Validated @RequestBody SystemAdminUpdateValidate updateValidate) { Integer adminId = LikeAdminThreadLocal.getAdminId(); iSystemAuthAdminService.edit(updateValidate, adminId); return AjaxResult.success(); } - /** - * 当前管理员更新 - * - * @author fzr - * @return AjaxResult - */ @NotPower @Log(title = "管理员更新") @PostMapping("/upInfo") + @ApiOperation(value="当前管理员更新") public AjaxResult upInfo(@Validated @RequestBody SystemAdminUpInfoValidate upInfoValidate) { Integer adminId = LikeAdminThreadLocal.getAdminId(); iSystemAuthAdminService.upInfo(upInfoValidate, adminId); return AjaxResult.success(); } - /** - * 管理员删除 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "管理员删除") @PostMapping("/del") + @ApiOperation(value="管理员删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { Integer adminId = LikeAdminThreadLocal.getAdminId(); iSystemAuthAdminService.del(idValidate.getId(), adminId); return AjaxResult.success(); } - /** - * 管理员状态切换 - * - * @author fzr - * @return AjaxResult - */ @Log(title = "管理员状态") @PostMapping("/disable") + @ApiOperation(value="管理员状态切换") public AjaxResult disable(@Validated @RequestBody IdValidate idValidate) { Integer adminId = LikeAdminThreadLocal.getAdminId(); iSystemAuthAdminService.disable(idValidate.getId(), adminId); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthDeptController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthDeptController.java index 97ec83d7..dce5d843 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthDeptController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthDeptController.java @@ -10,95 +10,60 @@ import com.mdd.admin.validate.system.SystemDeptUpdateValidate; import com.mdd.admin.vo.system.SystemAuthDeptVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 系统部门管理 - */ @RestController @RequestMapping("api/system/dept") +@Api(tags = "系统部门管理") public class SystemAuthDeptController { @Resource ISystemAuthDeptService iSystemAuthDeptService; - /** - * 部门所有 - * - * @author fzr - * @return AjaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="部门所有") public AjaxResult> all() { List list = iSystemAuthDeptService.all(); return AjaxResult.success(list); } - /** - * 部门列表 - * - * @author fzr - * @param searchValidate 搜索参数 - * @return AjaxResult - */ @GetMapping("/list") + @ApiOperation(value="部门列表") public AjaxResult list(@Validated SystemDeptSearchValidate searchValidate) { JSONArray list = iSystemAuthDeptService.list(searchValidate); return AjaxResult.success(list); } - /** - * 部门详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="部门详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SystemAuthDeptVo vo = iSystemAuthDeptService.detail(id); return AjaxResult.success(vo); } - /** - * 部门新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="部门新增") public AjaxResult add(@Validated @RequestBody SystemDeptCreateValidate createValidate) { iSystemAuthDeptService.add(createValidate); return AjaxResult.success(); } - /** - * 部门编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="部门编辑") public AjaxResult edit(@Validated @RequestBody SystemDeptUpdateValidate updateValidate) { iSystemAuthDeptService.edit(updateValidate); return AjaxResult.success(); } - /** - * 部门删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="部门删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iSystemAuthDeptService.del(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthMenuController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthMenuController.java index dd51eb90..b1a7c4cf 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthMenuController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthMenuController.java @@ -11,99 +11,65 @@ import com.mdd.admin.validate.system.SystemMenuUpdateValidate; import com.mdd.admin.vo.system.SystemAuthMenuVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 系统菜单管理 - */ @RestController @RequestMapping("api/system/menu") +@Api(tags = "系统菜单管理") public class SystemAuthMenuController { @Resource ISystemAuthMenuService iSystemAuthMenuService; - /** - * 获取菜单路由 - * - * @author fzr - * @return AjaxResult - */ @NotPower @GetMapping("/route") + @ApiOperation(value="获取菜单路由") public AjaxResult route() { List roleIds = LikeAdminThreadLocal.getRoleIds(); JSONArray lists = iSystemAuthMenuService.selectMenuByRoleId(roleIds); return AjaxResult.success(lists); } - /** - * 获取菜单列表 - * - * @author fzr - * @return AjaxResult - */ @NotPower @GetMapping("/list") + @ApiOperation(value="获取菜单列表") public AjaxResult list() { JSONArray lists = iSystemAuthMenuService.list(); return AjaxResult.success(lists); } - /** - * 获取菜单详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="获取菜单详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SystemAuthMenuVo vo = iSystemAuthMenuService.detail(id); return AjaxResult.success(vo); } - /** - * 新增菜单 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @Log(title = "菜单新增") @PostMapping("/add") + @ApiOperation(value="新增菜单") public AjaxResult add(@Validated @RequestBody SystemMenuCreateValidate createValidate) { iSystemAuthMenuService.add(createValidate); return AjaxResult.success(); } - /** - * 更新菜单 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @Log(title = "菜单编辑") @PostMapping("/edit") + @ApiOperation(value="菜单编辑") public AjaxResult edit(@Validated @RequestBody SystemMenuUpdateValidate updateValidate) { iSystemAuthMenuService.edit(updateValidate); return AjaxResult.success(); } - /** - * 删除菜单 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "菜单删除") @PostMapping("/del") + @ApiOperation(value="菜单删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iSystemAuthMenuService.del(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthPostController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthPostController.java index 756622d1..f3db30db 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthPostController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthPostController.java @@ -11,95 +11,61 @@ import com.mdd.admin.vo.system.SystemAuthPostVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 系统岗位管理 - */ @RestController @RequestMapping("api/system/post") +@Api(tags = "系统岗位管理") public class SystemAuthPostController { @Resource ISystemAuthPostService iSystemAuthPostService; - /** - * 岗位所有 - * - * @author fzr - * @return AjaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="所有岗位") public AjaxResult> all() { List list = iSystemAuthPostService.all(); return AjaxResult.success(list); } - /** - * 岗位列表 - * @param pageValidate 分页参数 - * @param searchValidate 搜索参数 - * @return PageResult - */ @GetMapping("/list") + @ApiOperation(value="岗位列表") public AjaxResult> list(@Validated PageValidate pageValidate, @Validated SystemPostSearchValidate searchValidate) { PageResult list = iSystemAuthPostService.list(pageValidate, searchValidate); return AjaxResult.success(list); } - /** - * 岗位详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @GetMapping("/detail") + @ApiOperation(value="岗位详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SystemAuthPostVo vo = iSystemAuthPostService.detail(id); return AjaxResult.success(vo); } - /** - * 岗位新增 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @PostMapping("/add") + @ApiOperation(value="岗位新增") public AjaxResult add(@Validated @RequestBody SystemPostCreateValidate createValidate) { iSystemAuthPostService.add(createValidate); return AjaxResult.success(); } - /** - * 岗位编辑 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @PostMapping("/edit") + @ApiOperation(value="岗位编辑") public AjaxResult edit(@Validated @RequestBody SystemPostUpdateValidate updateValidate) { iSystemAuthPostService.edit(updateValidate); return AjaxResult.success(); } - /** - * 岗位删除 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @PostMapping("/del") + @ApiOperation(value="岗位删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iSystemAuthPostService.del(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthRoleController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthRoleController.java index 04bc9d12..151bc0bf 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthRoleController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemAuthRoleController.java @@ -11,100 +11,65 @@ import com.mdd.admin.vo.system.SystemAuthRoleVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import java.util.List; -/** - * 系统角色管理 - */ @RestController @RequestMapping("api/system/role") +@Api(tags = "系统角色管理") public class SystemAuthRoleController { @Resource ISystemAuthRoleService iSystemAuthRoleService; - /** - * 角色所有 - * - * @author fzr - * @return AjaxResult> - */ @NotPower @GetMapping("/all") + @ApiOperation(value="所有角色") public AjaxResult> all() { List list = iSystemAuthRoleService.all(); return AjaxResult.success(list); } - /** - * 角色列表 - * - * @author fzr - * @param pageValidate 分页参数 - * @return PageResult - */ @Log(title = "角色列表") @GetMapping("/list") + @ApiOperation(value="角色列表") public AjaxResult> list(@Validated PageValidate pageValidate) { PageResult list = iSystemAuthRoleService.list(pageValidate); return AjaxResult.success(list); } - /** - * 角色详情 - * - * @author fzr - * @param id 主键 - * @return AjaxResult - */ @Log(title = "角色详情") @GetMapping("/detail") + @ApiOperation(value="角色详情") public AjaxResult detail(@Validated @IDMust() @RequestParam("id") Integer id) { SystemAuthRoleVo vo = iSystemAuthRoleService.detail(id); return AjaxResult.success(vo); } - /** - * 新增角色 - * - * @author fzr - * @param createValidate 参数 - * @return AjaxResult - */ @Log(title = "角色新增") @PostMapping("/add") + @ApiOperation(value="角色新增") public AjaxResult add(@Validated @RequestBody SystemRoleCreateValidate createValidate) { iSystemAuthRoleService.add(createValidate); return AjaxResult.success(); } - /** - * 编辑角色 - * - * @author fzr - * @param updateValidate 参数 - * @return AjaxResult - */ @Log(title = "角色编辑") @PostMapping("/edit") + @ApiOperation(value="角色编辑") public AjaxResult edit(@Validated @RequestBody SystemRoleUpdateValidate updateValidate) { iSystemAuthRoleService.edit(updateValidate); return AjaxResult.success(); } - /** - * 删除角色 - * - * @author fzr - * @param idValidate 参数 - * @return AjaxResult - */ @Log(title = "角色删除") @PostMapping("/del") + @ApiOperation(value="角色删除") public AjaxResult del(@Validated @RequestBody IdValidate idValidate) { iSystemAuthRoleService.del(idValidate.getId()); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLoginController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLoginController.java index 691c4f70..e0d3416b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLoginController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLoginController.java @@ -7,58 +7,41 @@ import com.mdd.admin.validate.system.SystemAdminLoginsValidate; import com.mdd.admin.vo.system.SystemCaptchaVo; import com.mdd.admin.vo.system.SystemLoginVo; import com.mdd.common.core.AjaxResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.*; import javax.annotation.Resource; import javax.servlet.http.HttpServletRequest; -/** - * 系统登录管理 - */ @RestController @RequestMapping("api/system") +@Api(tags = "系统登录管理") public class SystemLoginController { @Resource ISystemLoginService iSystemLoginService; - /** - * 验证码 - * - * @author fzr - * @return AjaxResult - */ @NotLogin @GetMapping("/captcha") + @ApiOperation(value="取验证码") public AjaxResult captcha() { SystemCaptchaVo vo = iSystemLoginService.captcha(); return AjaxResult.success(vo); } - /** - * 登录系统 - * - * @author fzr - * @param loginsValidate 登录参数 - * @return AjaxResult - */ @NotLogin @PostMapping("/login") + @ApiOperation(value="登录系统") public AjaxResult login(@Validated() @RequestBody SystemAdminLoginsValidate loginsValidate) { SystemLoginVo vo = iSystemLoginService.login(loginsValidate); return AjaxResult.success(vo); } - /** - * 退出登录 - * - * @author fzr - * @param request 请求接口 - * @return AjaxResult - */ @NotPower @PostMapping("/logout") + @ApiOperation(value="退出登录") public AjaxResult logout(HttpServletRequest request) { iSystemLoginService.logout(request.getHeader("token")); return AjaxResult.success(); diff --git a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLogsController.java b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLogsController.java index fb18d80a..1b234b17 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLogsController.java +++ b/server/like-admin/src/main/java/com/mdd/admin/controller/system/SystemLogsController.java @@ -8,6 +8,8 @@ import com.mdd.admin.vo.system.SystemLogLoginVo; import com.mdd.admin.vo.system.SystemLogOperateVo; import com.mdd.common.core.AjaxResult; import com.mdd.common.core.PageResult; +import io.swagger.annotations.Api; +import io.swagger.annotations.ApiOperation; import org.springframework.validation.annotation.Validated; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; @@ -15,38 +17,24 @@ import org.springframework.web.bind.annotation.RestController; import javax.annotation.Resource; -/** - * 系统日志管理 - */ @RestController @RequestMapping("api/system/log") +@Api(tags = "系统日志管理") public class SystemLogsController { @Resource ISystemLogsServer iSystemLogsServer; - /** - * 系统操作日志 - * - * @author fzr - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/operate") + @ApiOperation(value="系统操作日志") public AjaxResult> operate(@Validated PageValidate pageValidate, @Validated SystemSearchOperateValidate searchValidate) { PageResult list = iSystemLogsServer.operate(pageValidate, searchValidate); return AjaxResult.success(list); } - /** - * 系统登录日志 - * - * @author fzr - * @param searchValidate 搜索参数 - * @return AjaxResult> - */ @GetMapping("/login") + @ApiOperation(value="系统登录日志") public AjaxResult> login(@Validated PageValidate pageValidate, @Validated SystemSearchLoginsValidate searchValidate) { PageResult list = iSystemLogsServer.login(pageValidate, searchValidate); diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumCateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumCateValidate.java index 74afec55..c24e790a 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumCateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumCateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,24 +11,25 @@ import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 附件分类参数 - */ @Data +@ApiModel("附件分类参数") public class AlbumCateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "缺少pid参数") @Min(value = 0, message = "pid参数必须为数字") + @ApiModelProperty(value = "上级ID", required = true) private Integer pid; @NotNull(message = "缺少type参数") @IntegerContains(values = {10, 20, 30}, message = "type不在合法值内") + @ApiModelProperty(value = "附件类型", required = true) private Integer type; @NotEmpty(message = "名称不能为空") @Length(min = 1, max = 30, message = "名称不能大于30个字符") + @ApiModelProperty(value = "附件名称", required = true) private String name; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumMoveValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumMoveValidate.java index 11d50f1d..4bd28463 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumMoveValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumMoveValidate.java @@ -1,23 +1,25 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotNull; import java.io.Serializable; import java.util.List; -/** - * 附件移动参数 - */ @Data +@ApiModel("附件移动参数") public class AlbumMoveValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "ids参数缺失") + @ApiModelProperty(value = "附件ID", required = true) private List ids; @NotNull(message = "cid参数缺失") + @ApiModelProperty(value = "类目ID", required = true) private Integer cid; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumRenameValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumRenameValidate.java index 2a7c39f8..c5c3afff 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumRenameValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumRenameValidate.java @@ -1,24 +1,26 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.NotEmpty; import java.io.Serializable; -/** - * 附件重命名参数 - */ @Data +@ApiModel("附件重命名参数") public class AlbumRenameValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "附件ID", required = true) private Integer id; @NotEmpty(message = "名称不能为空") @Length(min = 1, max = 30, message = "名称不能大于30个字符") + @ApiModelProperty(value = "附件名称", required = true) private String name; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumSearchValidate.java index 12deeac2..7a8d8bca 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/AlbumSearchValidate.java @@ -1,21 +1,24 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 附件搜索参数 - */ @Data +@ApiModel("附件搜索参数") public class AlbumSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "分类ID") private Integer cid; + @ApiModelProperty(value = "类型") private Integer type; + @ApiModelProperty(value = "关键词") private String keyword; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateCreateValidate.java index 342f0ecf..b1b418eb 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,24 +11,25 @@ import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 文章分类创建参数 - */ @Data +@ApiModel("文章分类创建参数") public class ArtCateCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotEmpty(message = "分类名称不能为空") @Length(min = 1, max = 60, message = "分类名称不能大于60个字符") + @ApiModelProperty(value = "分类名称", required = true) private String name; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort; @NotNull(message = "缺少isShow参数") @IntegerContains(values = {0, 1}, message = "isShow不是合法值") + @ApiModelProperty(value = "是否显示", required = true) private Integer isShow; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateSearchValidate.java index 5b7be1e5..6e8e69f0 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateSearchValidate.java @@ -1,19 +1,21 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 文章分类搜索参数 - */ @Data +@ApiModel("文章分类搜索参数") public class ArtCateSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "分类名称") private String name; + @ApiModelProperty(value = "是否显示") private Integer isShow; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateUpdateValidate.java index feb4ddd9..69b771c7 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArtCateUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,27 +12,29 @@ import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 文章分类更新参数 - */ @Data +@ApiModel("文章分类更新参数") public class ArtCateUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotEmpty(message = "分类名称不能为空") @Length(min = 1, max = 60, message = "分类名称不能大于60个字符") + @ApiModelProperty(value = "分类名称", required = true) private String name; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort; @NotNull(message = "缺少isShow参数") @IntegerContains(values = {0, 1}, message = "isShow不是合法值") + @ApiModelProperty(value = "是否显示", required = true) private Integer isShow; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleCreateValidate.java index 9ca73e50..dd308cd4 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleCreateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,43 +12,51 @@ import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 文章创建参数 - */ @Data +@ApiModel("文章创建参数") public class ArticleCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "cid参数必传且需大于0") + @ApiModelProperty(value = "分类ID", required = true) private Integer cid; @NotEmpty(message = "文章标题不能为空") @Length(min = 1, max = 200, message = "文章标题不能大于200个字符") + @ApiModelProperty(value = "文章标题", required = true) private String title; @Length(max = 200, message = "简介不能超出200个字符") + @ApiModelProperty(value = "文章简介") private String intro = ""; @Length(max = 200, message = "图片链接过长不能超200个字符") + @ApiModelProperty(value = "封面图片") private String image = ""; @Length(max = 32, message = "作者名称不能超32个字符") + @ApiModelProperty(value = "作者姓名") private String author = ""; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort; @NotNull(message = "缺少isShow参数") @IntegerContains(values = {0, 1}, message = "isShow不是合法值") + @ApiModelProperty(value = "是否显示", required = true) private Integer isShow; + @ApiModelProperty(value = "文章内容") private String content = ""; + @ApiModelProperty(value = "文章描述") private String summary = ""; @DecimalMin(value = "0", message = "初始浏览量不能少于0") + @ApiModelProperty(value = "浏览数量") private Integer visit = 0; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleSearchValidate.java index 16d06a51..9825edd6 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleSearchValidate.java @@ -1,25 +1,30 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 文章搜索参数 - */ @Data +@ApiModel("文章搜索参数") public class ArticleSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "文章标题") private String title; + @ApiModelProperty(value = "文章分类") private Integer cid; + @ApiModelProperty(value = "是否显示") private Integer isShow; + @ApiModelProperty(value = "开始时间") private String startTime; + @ApiModelProperty(value = "结束时间") private String endTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleUpdateValidate.java index 896352e9..a8caac31 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/ArticleUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,46 +12,55 @@ import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 文章更新参数 - */ @Data +@ApiModel("文章更新参数") public class ArticleUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @IDMust(message = "cid参数必传且需大于0") + @ApiModelProperty(value = "分类ID", required = true) private Integer cid; @NotEmpty(message = "文章标题不能为空") @Length(min = 1, max = 200, message = "文章标题不能大于200个字符") + @ApiModelProperty(value = "文章标题", required = true) private String title; @Length(max = 200, message = "简介不能超出200个字符") + @ApiModelProperty(value = "文章简介") private String intro = ""; @Length(max = 200, message = "图片链接过长不能超200个字符") + @ApiModelProperty(value = "封面图片") private String image = ""; @Length(max = 32, message = "作者名称不能超32个字符") + @ApiModelProperty(value = "作者姓名") private String author = ""; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort; @NotNull(message = "缺少isShow参数") @IntegerContains(values = {0, 1}, message = "isShow不是合法值") + @ApiModelProperty(value = "是否显示", required = true) private Integer isShow; + @ApiModelProperty(value = "文章内容") private String content = ""; + @ApiModelProperty(value = "文章描述") private String summary = ""; @DecimalMin(value = "0", message = "初始浏览量不能少于0") + @ApiModelProperty(value = "浏览数量") private Integer visit = 0; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabCreateValidate.java index c0bdbb70..a0ed242c 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -8,35 +10,44 @@ import javax.validation.constraints.NotNull; import java.io.Serializable; @Data +@ApiModel("计划任务创建参数") public class CrontabCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "name参数缺失") + @ApiModelProperty(value = "任务名称", required = true) private String name; @NotNull(message = "groups参数缺失") + @ApiModelProperty(value = "任务分组", required = true) private String groups; @NotNull(message = "command参数缺失") + @ApiModelProperty(value = "执行指令", required = true) private String command; @NotNull(message = "rules参数缺失") + @ApiModelProperty(value = "执行规则", required = true) private String rules; @Length(max = 200, message = "remark参数不能超出200个字符") + @ApiModelProperty(value = "备注") private String remark; @NotNull(message = "status参数缺失") @IntegerContains(values = {1, 2, 3}, message = "status参数取值异常") + @ApiModelProperty(value = "状态") private Integer status; @NotNull(message = "strategy参数缺失") @IntegerContains(values = {1, 2, 3}, message = "strategy参数取值异常") + @ApiModelProperty(value = "strategy", required = true) private Integer strategy; @NotNull(message = "concurrent参数缺失") @IntegerContains(values = {0, 1}, message = "concurrent参数取值异常") + @ApiModelProperty(value = "concurrent", required = true) private Integer concurrent; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabUpdateValidate.java index e5096ee8..b7b80c0f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/CrontabUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,38 +11,48 @@ import javax.validation.constraints.NotNull; import java.io.Serializable; @Data +@ApiModel("计划任务更新参数") public class CrontabUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "groups参数缺失") + @ApiModelProperty(value = "任务分组", required = true) private String groups; @NotNull(message = "name参数缺失") + @ApiModelProperty(value = "任务名称", required = true) private String name; @NotNull(message = "command参数缺失") + @ApiModelProperty(value = "执行指令", required = true) private String command; @NotNull(message = "rules参数缺失") + @ApiModelProperty(value = "执行规则", required = true) private String rules; @Length(max = 200, message = "remark参数不能超出200个字符") + @ApiModelProperty(value = "备注") private String remark; @NotNull(message = "status参数缺失") @IntegerContains(values = {1, 2, 3}, message = "status参数取值异常") + @ApiModelProperty(value = "状态", required = true) private Integer status; @NotNull(message = "strategy参数缺失") @IntegerContains(values = {1, 2, 3}, message = "strategy参数取值异常") + @ApiModelProperty(value = "strategy", required = true) private Integer strategy; @NotNull(message = "concurrent参数缺失") @IntegerContains(values = {0, 1}, message = "concurrent参数取值异常") + @ApiModelProperty(value = "concurrent", required = true) private Integer concurrent; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/DecoratePageValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/DecoratePageValidate.java index 168508e9..5701106b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/DecoratePageValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/DecoratePageValidate.java @@ -1,24 +1,25 @@ package com.mdd.admin.validate; - import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 页面装修参数类 - */ @Data +@ApiModel("页面装修参数") public class DecoratePageValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "pageData参数缺失") + @ApiModelProperty(value = "装修数据", required = true) private String pageData; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/DecorateTabsValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/DecorateTabsValidate.java index 2401828e..d6cd1425 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/DecorateTabsValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/DecorateTabsValidate.java @@ -1,8 +1,9 @@ package com.mdd.admin.validate; - import com.mdd.admin.vo.decorate.DecorateTabsListsVo; import com.mdd.admin.vo.decorate.DecorateTabsStyleVo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; @@ -12,12 +13,15 @@ import java.util.List; * 底部导航装修参数 */ @Data +@ApiModel("底部装修参数") public class DecorateTabsValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "样式") private DecorateTabsStyleVo style; + @ApiModelProperty(value = "列表") private List list; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/UsersSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/UsersSearchValidate.java index 0fac6665..394ca05f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/UsersSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/UsersSearchValidate.java @@ -1,23 +1,27 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 用户搜索参数 - */ @Data +@ApiModel("用户搜索参数") public class UsersSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "渠道") private Integer channel; + @ApiModelProperty(value = "关键词") private String keyword; + @ApiModelProperty(value = "开始时间") private String startTime; + @ApiModelProperty(value = "结束时间") private String endTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/UsersUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/UsersUpdateValidate.java index 25c6da81..70cf3641 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/UsersUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/UsersUpdateValidate.java @@ -1,21 +1,24 @@ package com.mdd.admin.validate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 用户更新参数 - */ @Data +@ApiModel("用户更新参数") public class UsersUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + @ApiModelProperty(value = "字段") private String field; + @ApiModelProperty(value = "值") private String value; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelH5Validate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelH5Validate.java index f7e0a432..b002b25e 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelH5Validate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelH5Validate.java @@ -1,29 +1,32 @@ package com.mdd.admin.validate.channel; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * H5渠道参数 - */ @Data +@ApiModel("H5渠道参数") public class ChannelH5Validate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "status不是合法值") + @ApiModelProperty(value = "渠道状态", required = true) private Integer status; @NotNull(message = "close参数确实") @IntegerContains(values = {0, 1}, message = "close不是合法值") + @ApiModelProperty(value = "渠道开关", required = true) private Integer close; @Length(max = 500, message = "url不能超500个字符") + @ApiModelProperty(value = "关闭链接") private String url; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelMpValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelMpValidate.java index a38eb557..6de3554a 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelMpValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelMpValidate.java @@ -1,14 +1,13 @@ package com.mdd.admin.validate.channel; +import io.swagger.annotations.ApiModel; import lombok.Data; import org.hibernate.validator.constraints.Length; import java.io.Serializable; -/** - * 小程序渠道参数 - */ @Data +@ApiModel("小程序渠道参数") public class ChannelMpValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOaValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOaValidate.java index 1a3d1913..4682dfa9 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOaValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOaValidate.java @@ -1,15 +1,14 @@ package com.mdd.admin.validate.channel; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; import lombok.Data; import org.hibernate.validator.constraints.Length; import java.io.Serializable; -/** - * 公众号渠道参数 - */ @Data +@ApiModel("公众号渠道参数") public class ChannelOaValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOpValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOpValidate.java index 91686ea6..d0605166 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOpValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelOpValidate.java @@ -1,19 +1,21 @@ package com.mdd.admin.validate.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 开发平台渠道参数 - */ @Data +@ApiModel("开发平台渠道参数") public class ChannelOpValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "appId") private String appId; + @ApiModelProperty(value = "appSecret") private String appSecret; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpDefaultValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpDefaultValidate.java index 300d8d4e..e5e07130 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpDefaultValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpDefaultValidate.java @@ -1,16 +1,16 @@ package com.mdd.admin.validate.channel; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 公众号默认回复 - */ @Data +@ApiModel("公众号默认回复参数") public class ChannelRpDefaultValidate implements Serializable { private static final long serialVersionUID = 1L; @@ -19,21 +19,26 @@ public class ChannelRpDefaultValidate implements Serializable { @NotNull(message = "name参数缺失") @NotEmpty(message = "规则名称不能为空") + @ApiModelProperty(value = "名称", required = true) private String name; @NotNull(message = "content参数缺失") @NotEmpty(message = "回复内容不能为空") + @ApiModelProperty(value = "回复内容", required = true) private String content; @NotNull(message = "contentType参数缺失") @IntegerContains(values = {1, 2}, message = "contentType值不符合规范") + @ApiModelProperty(value = "内容类型", required = true) private Integer contentType; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "状态选择异常") + @ApiModelProperty(value = "状态", required = true) private Integer status; @NotNull(message = "sort参数缺失") + @ApiModelProperty(value = "排序", required = true) private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpFollowsValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpFollowsValidate.java index 175fb0f0..dc45cecf 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpFollowsValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpFollowsValidate.java @@ -1,16 +1,16 @@ package com.mdd.admin.validate.channel; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 公众号关注回复 - */ @Data +@ApiModel("公众号关注回复参数") public class ChannelRpFollowsValidate implements Serializable { private static final long serialVersionUID = 1L; @@ -19,21 +19,26 @@ public class ChannelRpFollowsValidate implements Serializable { @NotNull(message = "name参数缺失") @NotEmpty(message = "规则名称不能为空") + @ApiModelProperty(value = "名称", required = true) private String name; @NotNull(message = "content参数缺失") @NotEmpty(message = "回复内容不能为空") + @ApiModelProperty(value = "回复内容", required = true) private String content; @NotNull(message = "contentType参数缺失") @IntegerContains(values = {1, 2}, message = "contentType值不符合规范") + @ApiModelProperty(value = "内容类型", required = true) private Integer contentType; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "状态选择异常") + @ApiModelProperty(value = "状态", required = true) private Integer status; @NotNull(message = "sort参数缺失") + @ApiModelProperty(value = "排序", required = true) private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpKeywordValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpKeywordValidate.java index 9cdeccfe..7cdc31bd 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpKeywordValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/channel/ChannelRpKeywordValidate.java @@ -1,16 +1,16 @@ package com.mdd.admin.validate.channel; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 公众号关键词回复 - */ @Data +@ApiModel("公众号关键词回复参数") public class ChannelRpKeywordValidate implements Serializable { private static final long serialVersionUID = 1L; @@ -19,29 +19,36 @@ public class ChannelRpKeywordValidate implements Serializable { @NotNull(message = "name参数缺失") @NotEmpty(message = "规则名称不能为空") + @ApiModelProperty(value = "名称", required = true) private String name; @NotNull(message = "content参数缺失") @NotEmpty(message = "回复内容不能为空") + @ApiModelProperty(value = "回复内容", required = true) private String content; @NotNull(message = "contentType参数缺失") @IntegerContains(values = {1, 2}) + @ApiModelProperty(value = "内容类型", required = true) private Integer contentType; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "状态选择异常") + @ApiModelProperty(value = "状态", required = true) private Integer status; @NotNull(message = "keyword参数缺失") @NotEmpty(message = "关键词不能为空") + @ApiModelProperty(value = "关键词", required = true) private String keyword; @NotNull(message = "matchingType参数缺失") @IntegerContains(values = {1, 2}) + @ApiModelProperty(value = "模式", required = true) private Integer matchingType; @NotNull(message = "sort参数缺失") + @ApiModelProperty(value = "排序", required = true) private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdValidate.java index 5451fc1f..915280dd 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdValidate.java @@ -1,19 +1,20 @@ package com.mdd.admin.validate.commons; import com.mdd.common.validator.annotation.IDMust; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * ID参数 - */ @Data +@ApiModel("ID参数") public class IdValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "ID", required = true) private Integer id; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdsValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdsValidate.java index 9e9d20bd..d5534313 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdsValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/IdsValidate.java @@ -1,20 +1,21 @@ package com.mdd.admin.validate.commons; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import javax.validation.constraints.NotNull; import java.io.Serializable; import java.util.List; -/** - * IDS参数 - */ @Data +@ApiModel("IDS参数") public class IdsValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "ids参数缺失") + @ApiModelProperty(value = "ID数组", required = true) private List ids; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/PageValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/PageValidate.java index a80c739e..304c5fa5 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/commons/PageValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/commons/PageValidate.java @@ -1,15 +1,14 @@ package com.mdd.admin.validate.commons; +import io.swagger.annotations.ApiModel; import lombok.Data; import javax.validation.constraints.DecimalMax; import javax.validation.constraints.DecimalMin; import java.io.Serializable; -/** - * 分页参数 - */ @Data +@ApiModel("分页参数") public class PageValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataCreateValidate.java index 362f31b9..47fd3b90 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataCreateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.setting; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,32 +11,36 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 字典数据创建参数 - */ @Data +@ApiModel("字典数据创建参数") public class DictDataCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "typeId参数必传且需大于0") + @ApiModelProperty(value = "类型ID", required = true) private Integer typeId; @NotNull(message = "name参数缺失") + @ApiModelProperty(value = "键", required = true) private String name; @NotNull(message = "value参数缺失") @Length(max = 100, message = "键名不能超出100个字符") + @ApiModelProperty(value = "值", required = true) private String value; @Length(max = 200, message = "数值不能超出200个字符") + @ApiModelProperty(value = "备注") private String remark; @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序") private Integer sort; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "status参数不在合法值内") + @ApiModelProperty(value = "状态", required = true) private Integer status; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataUpdateValidate.java index fc11d7d5..d61618ae 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictDataUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.setting; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,35 +11,40 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 字典数据更新参数 - */ @Data +@ApiModel("字典数据更新参数") public class DictDataUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "ID", required = true) private Integer id; @IDMust(message = "typeId参数必传且需大于0") + @ApiModelProperty(value = "类型ID", required = true) private Integer typeId; @NotNull(message = "name参数缺失") + @ApiModelProperty(value = "键", required = true) private String name; @NotNull(message = "value参数缺失") @Length(max = 100, message = "键名不能超出100个字符") + @ApiModelProperty(value = "值", required = true) private String value; @Length(max = 200, message = "数值不能超出200个字符") + @ApiModelProperty(value = "备注") private String remark; @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序") private Integer sort; @NotNull(message = "status参数缺失") @IntegerContains(values = {0, 1}, message = "status参数不在合法值内") + @ApiModelProperty(value = "状态", required = true) private Integer status; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeCreateValidate.java index e7917a4f..d28bb0c1 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeCreateValidate.java @@ -1,33 +1,37 @@ package com.mdd.admin.validate.setting; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 字典类型创建参数 - */ @Data +@ApiModel("字典类型创建参数") public class DictTypeCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "dictName参数缺失") @Length(max = 200, message = "名称不能超出200个字符") + @ApiModelProperty(value = "名称", required = true) private String dictName; @NotNull(message = "dictType参数缺失") @Length(max = 200, message = "类型不能超出200个字符") + @ApiModelProperty(value = "类型", required = true) private String dictType; @Length(max = 200, message = "备注不能超出200个字符") + @ApiModelProperty(value = "备注") private String dictRemark; @NotNull(message = "dictStatus参数缺失") @IntegerContains(values = {0, 1}, message = "dictStatus参数不在合法值内") + @ApiModelProperty(value = "状态", required = true) private Integer dictStatus; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeUpdateValidate.java index 9eed1c78..0bfe2060 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/DictTypeUpdateValidate.java @@ -2,36 +2,41 @@ package com.mdd.admin.validate.setting; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 字典类型更新参数 - */ @Data +@ApiModel("字典类型更新参数") public class DictTypeUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "ID", required = true) private Integer id; @NotNull(message = "dictName参数缺失") @Length(max = 200, message = "名称不能超出200个字符") + @ApiModelProperty(value = "名称", required = true) private String dictName; @NotNull(message = "dictType参数缺失") @Length(max = 200, message = "类型不能超出200个字符") + @ApiModelProperty(value = "类型", required = true) private String dictType; @Length(max = 200, message = "备注不能超出200个字符") + @ApiModelProperty(value = "备注") private String dictRemark; @NotNull(message = "dictStatus参数缺失") @IntegerContains(values = {0, 1}, message = "dictStatus参数不在合法值内") + @ApiModelProperty(value = "状态", required = true) private Integer dictStatus; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingCopyrightValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingCopyrightValidate.java index 470d43cc..e486686b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingCopyrightValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingCopyrightValidate.java @@ -1,19 +1,20 @@ package com.mdd.admin.validate.setting; import com.mdd.admin.vo.setting.SettingCopyrightVo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; -/** - * 版权信息设置参数 - */ @Data +@ApiModel("版权信息设置参数") public class SettingCopyrightValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "版权列表") private List list; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingLoginValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingLoginValidate.java index f1364512..e4291d47 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingLoginValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingLoginValidate.java @@ -1,14 +1,12 @@ package com.mdd.admin.validate.setting; +import io.swagger.annotations.ApiModel; import lombok.Data; import java.io.Serializable; - -/** - * 登录信息设置参数 - */ @Data +@ApiModel("登录信息设置参数") public class SettingLoginValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingProtocolValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingProtocolValidate.java index 53c5fe5d..16c38418 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingProtocolValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingProtocolValidate.java @@ -1,20 +1,22 @@ package com.mdd.admin.validate.setting; import com.mdd.admin.vo.setting.SettingProtocolObjectVo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 政策协议设置参数 - */ @Data +@ApiModel("政策协议设置参数") public class SettingProtocolValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "服务协议") private SettingProtocolObjectVo service; + @ApiModelProperty(value = "隐私协议") private SettingProtocolObjectVo privacy; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingSearchValidate.java index 71dca0ba..168f214b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingSearchValidate.java @@ -1,21 +1,23 @@ package com.mdd.admin.validate.setting; import com.mdd.admin.vo.setting.SettingSearchObjectVo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; -/** - * 热门搜索设置参数 - */ @Data +@ApiModel("热门搜索设置参数") public class SettingSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "是否开启热门搜索") private Integer isHotSearch; + @ApiModelProperty(value = "关键词列表") private List list; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingUserValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingUserValidate.java index 6139d405..3f6b46a5 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingUserValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingUserValidate.java @@ -1,13 +1,12 @@ package com.mdd.admin.validate.setting; +import io.swagger.annotations.ApiModel; import lombok.Data; import java.io.Serializable; -/** - * 用户设置参数 - */ @Data +@ApiModel("用户设置参数") public class SettingUserValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingWebsiteValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingWebsiteValidate.java index d23275f0..c069f2b9 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingWebsiteValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/setting/SettingWebsiteValidate.java @@ -1,13 +1,12 @@ package com.mdd.admin.validate.setting; +import io.swagger.annotations.ApiModel; import lombok.Data; import java.io.Serializable; -/** - * 基础设置参数 - */ @Data +@ApiModel("基础设置参数") public class SettingWebsiteValidate implements Serializable { private static final long serialVersionUID = 1L; diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminCreateValidate.java index 342888e2..937aa2ec 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -11,46 +13,54 @@ import javax.validation.constraints.NotNull; import java.io.Serializable; import java.util.List; -/** - * 系统管理员创建参数 - */ @Data +@ApiModel("系统管理员创建参数") public class SystemAdminCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotEmpty(message = "账号不能为空") @Length(min = 2, max = 20, message = "账号必须在2~20个字符内") + @ApiModelProperty(value = "登录账号", required = true) private String username; @NotEmpty(message = "昵称不能为空") @Length(min = 2, max = 30, message = "昵称必须在2~30个字符内") + @ApiModelProperty(value = "用户昵称", required = true) private String nickname; @NotEmpty(message = "密码不能为空") @Length(min = 6, max = 32, message = "密码必须在6~32个字符内") + @ApiModelProperty(value = "登录密码", required = true) private String password; @NotNull(message = "请选择是否禁用") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "是否禁用", required = true) private Integer isDisable; @NotNull(message = "请选择是否支持多端登录") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "支持多端", required = true) private Integer isMultipoint; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort = 0; @Length(max = 200, message = "头像不能超出200个字符") + @ApiModelProperty(value = "头像") private String avatar = ""; @NotNull(message = "请选择角色") + @ApiModelProperty(value = "角色ID", required = true) private List roleIds; + @ApiModelProperty(value = "部门ID") private List deptIds; + @ApiModelProperty(value = "岗位ID") private List postIds; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminLoginsValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminLoginsValidate.java index 1f501028..55773521 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminLoginsValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminLoginsValidate.java @@ -1,29 +1,33 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.NotEmpty; import java.io.Serializable; -/** - * 系统登录参数 - */ @Data +@ApiModel("系统登录参数") public class SystemAdminLoginsValidate implements Serializable { private static final long serialVersionUID = 1L; @NotEmpty(message = "账号不能为空") @Length(min = 2, max = 20, message = "账号或密码错误") + @ApiModelProperty(value = "登录账号", required = true) private String username; @NotEmpty(message = "密码不能为空") @Length(min = 6, max = 18, message = "账号或密码错误") + @ApiModelProperty(value = "登录密码", required = true) private String password; + @ApiModelProperty(value = "验证码") private String code; + @ApiModelProperty(value = "标识码") private String uuid; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminSearchValidate.java index e975644b..7082c25e 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminSearchValidate.java @@ -1,21 +1,24 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统管理员搜索参数 - */ @Data +@ApiModel("系统管理员搜索参数") public class SystemAdminSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "登录账号") private String username; + @ApiModelProperty(value = "用户昵称") private String nickname; + @ApiModelProperty(value = "角色ID") private Integer role; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpInfoValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpInfoValidate.java index c42b5ab7..91b8676f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpInfoValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpInfoValidate.java @@ -1,21 +1,22 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import org.hibernate.validator.constraints.Length; import lombok.Data; import javax.validation.constraints.NotEmpty; import java.io.Serializable; -/** - * 系统管理员自更新参数 - */ @Data +@ApiModel("系统管理员自更新参数") public class SystemAdminUpInfoValidate implements Serializable { private static final long serialVersionUID = 1L; @NotEmpty(message = "昵称不能为空") @Length(min = 2, max = 30, message = "昵称必须在2~30个字符内") + @ApiModelProperty(value = "用户昵称") private String nickname; @Length(max = 32, message = "密码必须在6~32个字符内") diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpdateValidate.java index 1f37db08..cc8959ca 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemAdminUpdateValidate.java @@ -2,58 +2,67 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; import javax.validation.constraints.DecimalMin; -import javax.validation.constraints.Min; import javax.validation.constraints.NotEmpty; import javax.validation.constraints.NotNull; import java.io.Serializable; import java.util.List; -/** - * 系统管理员更新参数 - */ @Data +@ApiModel("系统管理员更新参数") public class SystemAdminUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "ID", required = true) private Integer id; @NotEmpty(message = "账号不能为空") @Length(min = 2, max = 20, message = "账号必须在2~20个字符内") + @ApiModelProperty(value = "登录账号", required = true) private String username; @NotEmpty(message = "昵称不能为空") @Length(min = 2, max = 30, message = "昵称必须在2~30个字符内") + @ApiModelProperty(value = "用户昵称", required = true) private String nickname; + @ApiModelProperty(value = "登录密码") private String password; @NotNull(message = "请选择是否禁用") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "是否禁用", required = true) private Integer isDisable; @NotNull(message = "请选择是否支持多端登录") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "支持多端", required = true) private Integer isMultipoint; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort = 0; @Length(max = 200, message = "头像不能超出200个字符") + @ApiModelProperty(value = "头像") private String avatar = ""; @NotNull(message = "请选择角色") - + @ApiModelProperty(value = "角色ID") private List roleIds; + @ApiModelProperty(value = "部门ID") private List deptIds; + @ApiModelProperty(value = "岗位ID") private List postIds; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptCreateValidate.java index 0ebdbb0f..2c72be01 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,20 +12,20 @@ import javax.validation.constraints.NotNull; import javax.validation.constraints.Pattern; import java.io.Serializable; -/** - * 系统部门创建参数 - */ @Data +@ApiModel("系统部门创建参数") public class SystemDeptCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "pid参数缺失") @DecimalMin(value = "0", message = "上级值不能少于0") + @ApiModelProperty(value = "上级ID", required = true) private Integer pid; @NotNull(message = "name参数缺失") @Length(min = 1, max = 100, message = "部门名称必须在1~100个字符内") + @ApiModelProperty(value = "部门名称", required = true) private String name; @Length(min = 1, max = 30, message = "负责人名称必须在1~30个字符内") @@ -31,15 +33,18 @@ public class SystemDeptCreateValidate implements Serializable { @Length(min = 11, max = 11, message = "手机号只能为11位") @Pattern(regexp = "^[1][3,4,5,6,7,8,9][0-9]{9}$", message = "手机号格式有误") + @ApiModelProperty(value = "手机号码") private String mobile; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "状态", required = true) private Integer isStop; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") @DecimalMax(value = "9999", message = "排序号值不能大于9999") + @ApiModelProperty(value = "排序") private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptSearchValidate.java index 28d1a749..9e045195 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptSearchValidate.java @@ -1,19 +1,21 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统部门搜索参数 - */ @Data +@ApiModel("系统部门搜索参数") public class SystemDeptSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "名称") private String name; + @ApiModelProperty(value = "是否停用") private Integer isStop; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptUpdateValidate.java index 6efc2eb1..cad03dc9 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemDeptUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -11,23 +13,24 @@ import javax.validation.constraints.NotNull; import javax.validation.constraints.Pattern; import java.io.Serializable; -/** - * 系统部门更新参数 - */ @Data +@ApiModel("系统部门更新参数") public class SystemDeptUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "pid参数缺失") @DecimalMin(value = "0", message = "上级值不能少于0") + @ApiModelProperty(value = "上级ID", required = true) private Integer pid; @NotNull(message = "name参数缺失") @Length(min = 1, max = 100, message = "部门名称必须在1~100个字符内") + @ApiModelProperty(value = "部门名称") private String name; @Length(min = 1, max = 30, message = "负责人名称必须在1~30个字符内") @@ -35,14 +38,17 @@ public class SystemDeptUpdateValidate implements Serializable { @Length(min = 11, max = 11, message = "手机号只能为11位") @Pattern(regexp = "^[1][3,4,5,6,7,8,9][0-9]{9}$", message = "手机号格式有误") + @ApiModelProperty(value = "手机号码") private String mobile; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "状态") private Integer isStop; @DecimalMin(value = "0", message = "排序号值不能少于0") @DecimalMax(value = "9999", message = "排序号值不能大于9999") + @ApiModelProperty(value = "排序") private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuCreateValidate.java index 45a7805c..765008ba 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuCreateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IntegerContains; import com.mdd.common.validator.annotation.StringContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,58 +11,69 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统菜单创建参数 - */ @Data +@ApiModel("系统菜单创建参数") public class SystemMenuCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "上级菜单不能为空") @DecimalMin(value = "0", message = "上级菜单值不能少于0") + @ApiModelProperty(value = "上级ID", required = true) private Integer pid; @NotNull(message = "menuType参数缺失") @StringContains(values = {"M", "C", "A"}, message = "菜单类型不是合法值(M,C,A)") + @ApiModelProperty(value = "菜单类型", required = true) private String menuType; @NotNull(message = "缺少参数menuName") @Length(min = 1, max = 30, message = "菜单名称必须在1~30个字符内") + @ApiModelProperty(value = "菜单名称", required = true) private String menuName; @Length(max = 100, message = "图标名称不能超过100个字符") + @ApiModelProperty(value = "菜单图标") private String menuIcon; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "菜单排序") private Integer menuSort; @Length(max = 100, message = "权限字符不能超过100个字符") + @ApiModelProperty(value = "权限字符") private String perms; @Length(max = 200, message = "路由地址不能超过200个字符") + @ApiModelProperty(value = "路由地址") private String paths; @Length(max = 200, message = "前端组件不能超过200个字符") + @ApiModelProperty(value = "前端组件") private String component; @Length(max = 200, message = "选中菜单路径不能超过200个字符") + @ApiModelProperty(value = "选中菜单") private String selected; @Length(max = 200, message = "路由参数不能超过200个字符") + @ApiModelProperty(value = "路由参数") private String params; @NotNull(message = "请选择缓存状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "缓存状态", required = true) private Integer isCache; @NotNull(message = "请选择显示状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "显示状态", required = true) private Integer isShow; @NotNull(message = "请选择菜单状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "菜单状态", required = true) private Integer isDisable; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuUpdateValidate.java index 14195944..4417afb7 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemMenuUpdateValidate.java @@ -3,6 +3,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; import com.mdd.common.validator.annotation.StringContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,61 +12,73 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统菜单更新参数 - */ @Data +@ApiModel("系统菜单更新参数") public class SystemMenuUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "上级菜单不能为空") @DecimalMin(value = "0", message = "上级菜单值不能少于0") + @ApiModelProperty(value = "上级ID", required = true) private Integer pid; @NotNull(message = "menuType参数缺失") @StringContains(values = {"M", "C", "A"}, message = "菜单类型不是合法值(M,C,A)") + @ApiModelProperty(value = "菜单类型", required = true) private String menuType; @NotNull(message = "缺少参数menuName") @Length(min = 1, max = 30, message = "菜单名称必须在1~30个字符内") + @ApiModelProperty(value = "菜单名称", required = true) private String menuName; @Length(max = 100, message = "图标名称不能超过100个字符") + @ApiModelProperty(value = "菜单图标") private String menuIcon; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "菜单排序") private Integer menuSort; @Length(max = 100, message = "权限字符不能超过100个字符") + @ApiModelProperty(value = "权限字符") private String perms; @Length(max = 200, message = "路由地址不能超过200个字符") + @ApiModelProperty(value = "路由地址") private String paths; @Length(max = 200, message = "前端组件不能超过200个字符") + @ApiModelProperty(value = "前端组件") private String component; @Length(max = 200, message = "选中菜单路径不能超过200个字符") + @ApiModelProperty(value = "菜单路径") private String selected; @Length(max = 200, message = "路由参数不能超过200个字符") + @ApiModelProperty(value = "路由参数") private String params; @NotNull(message = "请选择缓存状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "缓存状态", required = true) private Integer isCache; @NotNull(message = "请选择显示状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "显示状态", required = true) private Integer isShow; @NotNull(message = "请选择菜单状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "菜单状态", required = true) private Integer isDisable; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostCreateValidate.java index 124f4e6f..0f6abb59 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -8,31 +10,34 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统岗位创建参数 - */ @Data +@ApiModel("系统岗位创建参数") public class SystemPostCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "code参数缺失") @Length(min = 1, max = 30, message = "岗位编码必须在1~30个字符内") + @ApiModelProperty(value = "编码", required = true) private String code; @NotNull(message = "name参数缺失") @Length(min = 1, max = 30, message = "岗位名称必须在1~30个字符内") + @ApiModelProperty(value = "岗位名称", required = true) private String name; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "是否停用", required = true) private Integer isStop = 0; @Length( max = 250, message = "岗位备注不能大于250个字符内") + @ApiModelProperty(value = "备注信息") private String remarks = ""; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort = 0; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostSearchValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostSearchValidate.java index 77527229..ae56678f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostSearchValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostSearchValidate.java @@ -1,21 +1,24 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统岗位搜索参数 - */ @Data +@ApiModel("系统岗位搜索参数") public class SystemPostSearchValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "编码") private String code; + @ApiModelProperty(value = "岗位名称") private String name; + @ApiModelProperty(value = "是否停用") private Integer isStop; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostUpdateValidate.java index 503e9181..138735e7 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemPostUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -9,34 +11,38 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统岗位更新参数 - */ @Data +@ApiModel("系统岗位更新参数") public class SystemPostUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "code参数缺失") @Length(min = 1, max = 30, message = "岗位编码必须在1~30个字符内") + @ApiModelProperty(value = "岗位编码", required = true) private String code; @NotNull(message = "name参数缺失") @Length(min = 1, max = 30, message = "岗位名称必须在1~30个字符内") + @ApiModelProperty(value = "岗位名称", required = true) private String name; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) - private Integer isStop = 0; + @ApiModelProperty(value = "是否停用", required = true) + private Integer isStop; @Length( max = 250, message = "岗位备注不能大于250个字符内") - private String remarks = ""; + @ApiModelProperty(value = "岗位备注") + private String remarks; @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") - private Integer sort = 0; + @ApiModelProperty(value = "排序", required = true) + private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleCreateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleCreateValidate.java index d7436aac..3d5a6882 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleCreateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleCreateValidate.java @@ -1,6 +1,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -8,29 +10,31 @@ import javax.validation.constraints.DecimalMin; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统角色创建参数 - */ @Data +@ApiModel("系统角色创建参数") public class SystemRoleCreateValidate implements Serializable { private static final long serialVersionUID = 1L; @NotNull(message = "缺少参数name") @Length(min = 1, max = 30, message = "角色名称必须在1~30个字符内") + @ApiModelProperty(value = "角色名称", required = true) private String name; @Length(max = 200, message = "备注信息不能超过200个字符") + @ApiModelProperty(value = "备注", required = true) private String remark; - @NotNull(message = "排序号不能为空") @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序", required = true) private Integer sort = 0; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "是否禁用", required = true) private Integer isDisable; + @ApiModelProperty(value = "菜单权限") private String menuIds = ""; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleUpdateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleUpdateValidate.java index f60fc59a..f459d18f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleUpdateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemRoleUpdateValidate.java @@ -2,6 +2,8 @@ package com.mdd.admin.validate.system; import com.mdd.common.validator.annotation.IDMust; import com.mdd.common.validator.annotation.IntegerContains; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import org.hibernate.validator.constraints.Length; @@ -10,31 +12,35 @@ import javax.validation.constraints.Max; import javax.validation.constraints.NotNull; import java.io.Serializable; -/** - * 系统角色更新参数 - */ @Data +@ApiModel("系统角色更新参数") public class SystemRoleUpdateValidate implements Serializable { private static final long serialVersionUID = 1L; @IDMust(message = "id参数必传且需大于0") + @ApiModelProperty(value = "id", required = true) private Integer id; @NotNull(message = "缺少参数name") @Length(min = 1, max = 30, message = "角色名称必须在1~30个字符内") + @ApiModelProperty(value = "角色名称", required = true) private String name; @Length(max = 200, message = "备注信息不能超过200个字符") + @ApiModelProperty(value = "备注", required = true) private String remark; @DecimalMin(value = "0", message = "排序号值不能少于0") + @ApiModelProperty(value = "排序") private Integer sort = 0; @NotNull(message = "请选择状态") @IntegerContains(values = {0, 1}) + @ApiModelProperty(value = "是否禁用", required = true) private Integer isDisable; + @ApiModelProperty(value = "菜单权限") private String menuIds = ""; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchLoginsValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchLoginsValidate.java index 545eb5fb..54c12d89 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchLoginsValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchLoginsValidate.java @@ -1,23 +1,27 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统登录日志搜索参数 - */ @Data +@ApiModel("系统登录日志搜索参数") public class SystemSearchLoginsValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "账号") private String username; + @ApiModelProperty(value = "状态") private Integer status; + @ApiModelProperty(value = "开始时间") private String startTime; + @ApiModelProperty(value = "结束时间") private String endTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchOperateValidate.java b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchOperateValidate.java index debcf14d..bd595a93 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchOperateValidate.java +++ b/server/like-admin/src/main/java/com/mdd/admin/validate/system/SystemSearchOperateValidate.java @@ -1,31 +1,39 @@ package com.mdd.admin.validate.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统操作日志搜索参数 - */ @Data +@ApiModel("系统操作日志搜索参数") public class SystemSearchOperateValidate implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "标题") private String title; + @ApiModelProperty(value = "账号") private String username; + @ApiModelProperty(value = "IP") private String ip; + @ApiModelProperty(value = "类型") private String type; + @ApiModelProperty(value = "状态") private String status; + @ApiModelProperty(value = "路由") private String url; + @ApiModelProperty(value = "开始时间") private String startTime; + @ApiModelProperty(value = "结束时间") private String endTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabDetailVo.java index ed9b31c0..bdc8ab63 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabDetailVo.java @@ -1,26 +1,45 @@ package com.mdd.admin.vo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 计划任务详情Vo - */ @Data +@ApiModel("计划任务详情Vo") public class CrontabDetailVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 任务主键 - private String groups; // 任务分组 - private String name; // 任务名称 - private String command; // 执行命令 - private String rules; // 执行规则 - private String remark; // 备注信息 - private String error; // 错误信息 - private Integer status; // 执行状态: 1=正在运行, 2=任务停止, 3=发生错误 - private Integer strategy; // 执行策略: 1=立即执行, 2=执行一次, 3=放弃执行 - private Integer concurrent; // 并发执行: 0=否, 1=是 + @ApiModelProperty(value = "任务ID") + private Integer id; + + @ApiModelProperty(value = "任务分组") + private String groups; + + @ApiModelProperty(value = "任务名称") + private String name; + + @ApiModelProperty(value = "执行命令") + private String command; + + @ApiModelProperty(value = "执行规则") + private String rules; + + @ApiModelProperty(value = "备注信息") + private String remark; + + @ApiModelProperty(value = "错误信息") + private String error; + + @ApiModelProperty(value = "执行状态: 1=正在运行, 2=任务停止, 3=发生错误") + private Integer status; + + @ApiModelProperty(value = "执行策略: 1=立即执行, 2=执行一次, 3=放弃执行") + private Integer strategy; + + @ApiModelProperty(value = "并发执行: 0=否, 1=是") + private Integer concurrent; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabListedVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabListedVo.java index adce440d..e49dd04f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabListedVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/CrontabListedVo.java @@ -1,28 +1,51 @@ package com.mdd.admin.vo; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 计划任务列表Vo - */ @Data +@ApiModel("计划任务列表Vo") public class CrontabListedVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "任务ID") private Integer id; // 执行ID - private String groups; // 执行分组 - private String name; // 执行名称 - private String command; // 执行命令 - private String rules; // 执行规则 - private String error; // 错误信息 - private Integer status; // 执行状态: 1=正在运行, 2=任务停止, 3=发生错误 - private Integer strategy; // 执行策略: 1=立即执行, 2=执行一次, 3=放弃执行 - private Integer concurrent; // 并发执行: 0=否, 1=是 - private String startTime; // 开始时间 - private String endTime; // 结束时间 - private Long taskTime; // 执行耗时 + + @ApiModelProperty(value = "任务分组") + private String groups; + + @ApiModelProperty(value = "任务名称") + private String name; + + @ApiModelProperty(value = "执行命令") + private String command; + + @ApiModelProperty(value = "执行规则") + private String rules; + + @ApiModelProperty(value = "错误信息") + private String error; + + @ApiModelProperty(value = "执行状态: [1=正在运行, 2=任务停止, 3=发生错误]") + private Integer status; + + @ApiModelProperty(value = "执行策略: [1=立即执行, 2=执行一次, 3=放弃执行]") + private Integer strategy; + + @ApiModelProperty(value = "并发执行: [0=否, 1=是]") + private Integer concurrent; + + @ApiModelProperty(value = "开始时间") + private String startTime; + + @ApiModelProperty(value = "结束时间") + private String endTime; + + @ApiModelProperty(value = "执行耗时") + private Long taskTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumCateVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumCateVo.java index 47ef5ea6..6d17eaa8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumCateVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumCateVo.java @@ -1,21 +1,30 @@ package com.mdd.admin.vo.album; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 相册分类Vo - */ @Data +@ApiModel("相册分类Vo") public class AlbumCateVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer pid; // 类目父级 - private String name; // 类目名称 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "类目父级") + private Integer pid; + + @ApiModelProperty(value = "类目名称") + private String name; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumVo.java index 9f7ae0ad..df048360 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/album/AlbumVo.java @@ -1,25 +1,42 @@ package com.mdd.admin.vo.album; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 相册Vo - */ @Data +@ApiModel("相册Vo") public class AlbumVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer cid; // 所属类目 - private String name; // 文件名称 - private String path; // 相对路径 - private String uri; // 文件路径 - private String ext; // 文件扩展 - private String size; // 文件大小 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "所属类目") + private Integer cid; + + @ApiModelProperty(value = "文件名称") + private String name; + + @ApiModelProperty(value = "相对路径") + private String path; + + @ApiModelProperty(value = "文件路径") + private String uri; + + @ApiModelProperty(value = "文件扩展") + private String ext; + + @ApiModelProperty(value = "文件大小") + private String size; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleCateVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleCateVo.java index 4d01d75f..4b539edc 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleCateVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleCateVo.java @@ -1,23 +1,36 @@ package com.mdd.admin.vo.article; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 文章分类Vo - */ @Data +@ApiModel("文章分类Vo") public class ArticleCateVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String name; // 分类名称 - private Long number; // 文章数量 - private Integer sort; // 排序编号 - private Integer isShow; // 是否显示 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "分类名称") + private String name; + + @ApiModelProperty(value = "文章数量") + private Long number; + + @ApiModelProperty(value = "排序编号") + private Integer sort; + + @ApiModelProperty(value = "是否显示") + private Integer isShow; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleDetailVo.java index 3c1b1d4a..c5311f0b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleDetailVo.java @@ -1,29 +1,54 @@ package com.mdd.admin.vo.article; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 文章详情Vo - */ @Data +@ApiModel("文章详情Vo") public class ArticleDetailVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer cid; // 分类 - private String title; // 标题 - private String image; // 图片 - private String intro; // 简介 - private String summary; // 摘要 - private String content; // 内容 - private String author; // 作者 - private Integer visit; // 访问 - private Integer sort; // 排序 - private Integer isShow; // 是否显示: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "分类") + private Integer cid; + + @ApiModelProperty(value = "标题") + private String title; + + @ApiModelProperty(value = "图片") + private String image; + + @ApiModelProperty(value = "简介") + private String intro; + + @ApiModelProperty(value = "摘要") + private String summary; + + @ApiModelProperty(value = "内容") + private String content; + + @ApiModelProperty(value = "作者") + private String author; + + @ApiModelProperty(value = "访问") + private Integer visit; + + @ApiModelProperty(value = "排序") + private Integer sort; + + @ApiModelProperty(value = "是否显示") + private Integer isShow; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleListedVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleListedVo.java index f4c7bef3..ce3b2c2b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleListedVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/article/ArticleListedVo.java @@ -1,26 +1,45 @@ package com.mdd.admin.vo.article; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 文章列表Vo - */ @Data +@ApiModel("文章列表Vo") public class ArticleListedVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String category; // 分类 - private String title; // 标题 - private String image; // 图片 - private String author; // 作者 - private Integer visit; // 访问 - private Integer sort; // 排序 - private Integer isShow; // 是否显示: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "分类") + private String category; + + @ApiModelProperty(value = "标题") + private String title; + + @ApiModelProperty(value = "图片") + private String image; + + @ApiModelProperty(value = "作者") + private String author; + + @ApiModelProperty(value = "访问") + private Integer visit; + + @ApiModelProperty(value = "排序") + private Integer sort; + + @ApiModelProperty(value = "是否显示") + private Integer isShow; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelH5Vo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelH5Vo.java index fffb414d..d786345b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelH5Vo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelH5Vo.java @@ -1,19 +1,24 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * H5渠道Vo - */ @Data +@ApiModel("H5渠道Vo") public class ChannelH5Vo implements Serializable { private static final long serialVersionUID = 1L; - private Integer status; // 是否关闭 - private Integer close; // 关闭类型 - private String url; // 关闭访问 + @ApiModelProperty(value = "是否关闭") + private Integer status; + + @ApiModelProperty(value = "关闭类型") + private Integer close; + + @ApiModelProperty(value = "关闭访问") + private String url; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelMpVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelMpVo.java index 5a892083..51ef568e 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelMpVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelMpVo.java @@ -1,29 +1,41 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 小程序渠道Vo - */ @Data +@ApiModel("小程序渠道Vo") public class ChannelMpVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "小程序名称") private String name; + @ApiModelProperty(value = "原始ID") private String primaryId; + @ApiModelProperty(value = "appId") private String appId; + @ApiModelProperty(value = "appSecret") private String appSecret; + @ApiModelProperty(value = "二维码") private String qrCode; + @ApiModelProperty(value = "request合法域名") private String requestDomain; + @ApiModelProperty(value = "socket合法域名") private String socketDomain; + @ApiModelProperty(value = "uploadFile合法域名") private String uploadFileDomain; + @ApiModelProperty(value = "downloadFile合法域名") private String downloadFileDomain; + @ApiModelProperty(value = "udp合法域名") private String udpDomain; + @ApiModelProperty(value = "tcp合法域名") private String tcpDomain; + @ApiModelProperty(value = "业务域名") private String businessDomain; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOaVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOaVo.java index 4c2f190d..ce0a799b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOaVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOaVo.java @@ -1,29 +1,41 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 公众号渠道Vo - */ @Data +@ApiModel("公众号渠道Vo") public class ChannelOaVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "公众号名称") private String name; + @ApiModelProperty(value = "原始ID") private String primaryId; + @ApiModelProperty(value = "appId") private String appId; + @ApiModelProperty(value = "appSecret") private String appSecret; + @ApiModelProperty(value = "二维码") private String qrCode; + @ApiModelProperty(value = "URL") private String url; + @ApiModelProperty(value = "Token") private String token; + @ApiModelProperty(value = "EncodingAESKey") private String encodingAesKey ; + @ApiModelProperty(value = "消息加密方式") private Integer encryptionType; + @ApiModelProperty(value = "业务域名") private String businessDomain; + @ApiModelProperty(value = "JS接口安全域名") private String jsDomain; + @ApiModelProperty(value = "网页授权域名") private String webDomain; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOpVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOpVo.java index 9d236079..27bdaeb8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOpVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelOpVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 开发平台Vo - */ @Data +@ApiModel("开发平台Vo") public class ChannelOpVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "appId") private String appId; + + @ApiModelProperty(value = "appSecret") private String appSecret; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpDefaultVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpDefaultVo.java index d1da3849..dd28d43a 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpDefaultVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpDefaultVo.java @@ -1,22 +1,33 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 公众号默认回复Vo - */ @Data +@ApiModel("公众号默认回复Vo") public class ChannelRpDefaultVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "规则名") private String name; + + @ApiModelProperty(value = "回复内容") private String content; + + @ApiModelProperty(value = "内容类型: [1=文本]") private Integer contentType; + + @ApiModelProperty(value = "排序编号") private Integer sort; + + @ApiModelProperty(value = "启动状态: [1=启动, 0=关闭]") private Integer status; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpFollowsVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpFollowsVo.java index ddc3b112..e23ab8d3 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpFollowsVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpFollowsVo.java @@ -1,22 +1,33 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 公众号关注回复Vo - */ @Data +@ApiModel("公众号关注回复Vo") public class ChannelRpFollowsVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "规则名") private String name; + + @ApiModelProperty(value = "回复内容") private String content; + + @ApiModelProperty(value = "内容类型: [1=文本]") private Integer contentType; + + @ApiModelProperty(value = "排序编号") private Integer sort; + + @ApiModelProperty(value = "启动状态: [1=启动, 0=关闭]") private Integer status; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpKeywordVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpKeywordVo.java index 00e02be2..d95c874c 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpKeywordVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpKeywordVo.java @@ -1,24 +1,39 @@ package com.mdd.admin.vo.channel; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 关键词回复Vo - */ @Data +@ApiModel("公众号关键词回复Vo") public class ChannelRpKeywordVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "规则名") private String name; + + @ApiModelProperty(value = "关键词") private String keyword; + + @ApiModelProperty(value = "回复内容") private String content; + + @ApiModelProperty(value = "内容类型: [1=文本]") private Integer contentType; + + @ApiModelProperty(value = "匹配方式: [1=全匹配, 2=模糊匹配]") private Integer matchingType; + + @ApiModelProperty(value = "排序编号") private Integer sort; + + @ApiModelProperty(value = "启动状态: [1=启动, 0=关闭]") private Integer status; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpVo.java deleted file mode 100644 index 9382294a..00000000 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/channel/ChannelRpVo.java +++ /dev/null @@ -1,25 +0,0 @@ -package com.mdd.admin.vo.channel; - -import lombok.Data; - -import java.io.Serializable; - -/** - * 公众号回复Vo - */ -@Data -public class ChannelRpVo implements Serializable { - - private static final long serialVersionUID = 1L; - - private Integer id; - private String name; - private String keyword; - private String content; - private Integer replyType; - private Integer contentType; - private Integer matchingType; - private Integer sort; - private Integer status; - -} diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateDataArticleVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateDataArticleVo.java index 6a2b1dda..63b7c1de 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateDataArticleVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateDataArticleVo.java @@ -1,24 +1,39 @@ package com.mdd.admin.vo.decorate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 装修文章数据Vo - */ @Data +@ApiModel("装修文章数据Vo") public class DecorateDataArticleVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "文章标题") private String title; + + @ApiModelProperty(value = "文章简介") private String intro; + + @ApiModelProperty(value = "文章描述") private String summary; + + @ApiModelProperty(value = "文章图片") private String image; + + @ApiModelProperty(value = "文章作者") private String author; + + @ApiModelProperty(value = "浏览数量") private Integer visit; + + @ApiModelProperty(value = "创建时间") private String createTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecoratePageVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecoratePageVo.java index a604c730..7610cdbd 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecoratePageVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecoratePageVo.java @@ -1,19 +1,24 @@ package com.mdd.admin.vo.decorate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 装修页面Vo - */ @Data +@ApiModel("装修页面Vo") public class DecoratePageVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "页面类型") private Integer pageType; + + @ApiModelProperty(value = "页面数据") private String pageData; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabbarVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabbarVo.java index 41c66dc6..db7b2a70 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabbarVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabbarVo.java @@ -1,20 +1,23 @@ package com.mdd.admin.vo.decorate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; import java.util.Map; -/** - * 装修底部导航Vo - */ @Data +@ApiModel("装修底部导航Vo") public class DecorateTabbarVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "样式") private Map style; + + @ApiModelProperty(value = "列表") private List list; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsListsVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsListsVo.java index 5e7cc32f..44d62f00 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsListsVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsListsVo.java @@ -1,25 +1,38 @@ package com.mdd.admin.vo.decorate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; import java.util.Map; -/** - * 装修底部导航列表Vo - */ @Data +@ApiModel("装修底部导航列表Vo") public class DecorateTabsListsVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "导航名称") private String name; + + @ApiModelProperty(value = "已选图标") private String selected; + + @ApiModelProperty(value = "未选图标") private String unselected; + + @ApiModelProperty(value = "id") private Object link; + + @ApiModelProperty(value = "创建时间") private String createTime; + + @ApiModelProperty(value = "更新时间") private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsStyleVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsStyleVo.java index 141df838..a5673440 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsStyleVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/decorate/DecorateTabsStyleVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.decorate; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 装修底部导航样式Vo - */ @Data +@ApiModel("装修底部导航样式Vo") public class DecorateTabsStyleVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "默认颜色") private String defaultColor; + + @ApiModelProperty(value = "选中颜色") private String selectedColor; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingCopyrightVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingCopyrightVo.java index db928ecd..7033b989 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingCopyrightVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingCopyrightVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 版权设置Vo - */ @Data +@ApiModel("版权设置Vo") public class SettingCopyrightVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "名称") private String name; + + @ApiModelProperty(value = "链接") private String link; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictDataVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictDataVo.java index 2be6d9e0..e649a61c 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictDataVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictDataVo.java @@ -1,25 +1,42 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 字典数据Vo - */ @Data +@ApiModel("字典数据Vo") public class SettingDictDataVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer typeId; // 类型 - private String name; // 键 - private String value; // 值 - private String remark; // 备注 - private Integer sort; // 排序 - private Integer status; // 状态: [0=停用, 1=禁用] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "类型") + private Integer typeId; + + @ApiModelProperty(value = "键") + private String name; + + @ApiModelProperty(value = "值") + private String value; + + @ApiModelProperty(value = "备注") + private String remark; + + @ApiModelProperty(value = "排序") + private Integer sort; + + @ApiModelProperty(value = "是否停用") + private Integer status; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictTypeVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictTypeVo.java index e7bc87f9..f7035222 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictTypeVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingDictTypeVo.java @@ -1,23 +1,36 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 字典类型Vo - */ @Data +@ApiModel("字典类型Vo") public class SettingDictTypeVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String dictName; // 字典名称 - private String dictType; // 字典类型 - private String dictRemark; // 字典备注 - private Integer dictStatus; // 字典状态 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "字典名称") + private String dictName; + + @ApiModelProperty(value = "字典类型") + private String dictType; + + @ApiModelProperty(value = "字典备注") + private String dictRemark; + + @ApiModelProperty(value = "字典状态") + private Integer dictStatus; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingLoginVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingLoginVo.java index 73d3a903..750c5218 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingLoginVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingLoginVo.java @@ -1,22 +1,31 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; -/** - * 登录设置Vo - */ @Data +@ApiModel("登录设置Vo") public class SettingLoginVo implements Serializable { private static final long serialVersionUID = 1L; - private List loginWay; // 登录方式 - private Integer forceBindMobile; // 强制绑定手机 - private Integer openAgreement; // 是否开启协议 - private Integer openOtherAuth; // 第三方的登录 - private List autoLoginAuth; // 自动登录授权 + @ApiModelProperty(value = "登录方式") + private List loginWay; + + @ApiModelProperty(value = "强制绑定手机") + private Integer forceBindMobile; + + @ApiModelProperty(value = "是否开启协议") + private Integer openAgreement; + + @ApiModelProperty(value = "第三方的登录") + private Integer openOtherAuth; + + @ApiModelProperty(value = "自动登录授权") + private List autoLoginAuth; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeDetailVo.java index dd883de3..02b40fb5 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeDetailVo.java @@ -1,24 +1,39 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 通知设置详情Vo - */ @Data +@ApiModel("通知设置详情Vo") public class SettingNoticeDetailVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "id") private Integer id; + + @ApiModelProperty(value = "场景名称") private String name; + + @ApiModelProperty(value = "通知类型: [1=业务, 2=验证]") private String type; + + @ApiModelProperty(value = "场景描述") private String remarks; + + @ApiModelProperty(value = "系统的通知设置") private Object systemNotice; + + @ApiModelProperty(value = "公众号通知设置") private Object oaNotice; + + @ApiModelProperty(value = "小程序通知设置") private Object mnpNotice; + + @ApiModelProperty(value = "短信的通知设置") private Object smsNotice; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeListedVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeListedVo.java index a9e17ac9..09667eab 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeListedVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingNoticeListedVo.java @@ -1,25 +1,42 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 通知设置列表Vo - */ @Data +@ApiModel("通知设置列表Vo") public class SettingNoticeListedVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String name; // 通知名称 - private String type; // 通知类型 - private Integer systemStatus; // 通知状态 - private Integer smsStatus; // 通知状态 - private Integer oaStatus; // 公众号状态 - private Integer mnpStatus; // 小程序状态 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "通知名称") + private String name; + + @ApiModelProperty(value = "通知类型") + private String type; + + @ApiModelProperty(value = "通知状态") + private Integer systemStatus; + + @ApiModelProperty(value = "通知状态") + private Integer smsStatus; + + @ApiModelProperty(value = "公众号状态") + private Integer oaStatus; + + @ApiModelProperty(value = "小程序状态") + private Integer mnpStatus; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolDetailVo.java index 45031f25..984e219b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolDetailVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 政策协议详情Vo - */ @Data +@ApiModel("政策协议详情Vo") public class SettingProtocolDetailVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "服务协议") private SettingProtocolObjectVo service; + + @ApiModelProperty(value = "隐私协议") private SettingProtocolObjectVo privacy; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolObjectVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolObjectVo.java index 1bb21a35..eba47a0f 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolObjectVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingProtocolObjectVo.java @@ -1,19 +1,21 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 政策协议设置对象Vo - */ @Data +@ApiModel("政策协议设置对象Vo") public class SettingProtocolObjectVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "协议名称") private String name; + @ApiModelProperty(value = "协议内容") private String content; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchDetailVo.java index b0c8da3f..800ef984 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchDetailVo.java @@ -1,20 +1,23 @@ package com.mdd.admin.vo.setting; import com.mdd.common.entity.setting.HotSearch; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; -/** - * 热门搜索详情Vo - */ @Data +@ApiModel("热门搜索详情Vo") public class SettingSearchDetailVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "是否开起热门搜索") private Integer isHotSearch; + + @ApiModelProperty(value = "热门搜索关键词") private List list; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchObjectVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchObjectVo.java index ae12444d..77afd9c9 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchObjectVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingSearchObjectVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 热门搜索对象Vo - */ @Data +@ApiModel("热门搜索对象Vo") public class SettingSearchObjectVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "关键词") private String name; + + @ApiModelProperty(value = "排序") private Integer sort; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingUserVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingUserVo.java index 74f149a9..426bf3f8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingUserVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingUserVo.java @@ -1,17 +1,18 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 用户设置Vo - */ @Data +@ApiModel("用户设置Vo") public class SettingUserVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "默认头像") private String defaultAvatar; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingWebsiteVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingWebsiteVo.java index 9a70b5dc..32fb28d2 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingWebsiteVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/setting/SettingWebsiteVo.java @@ -1,5 +1,7 @@ package com.mdd.admin.vo.setting; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; @@ -8,21 +10,34 @@ import java.io.Serializable; * 基础设置Vo */ @Data +@ApiModel("基础设置Vo") public class SettingWebsiteVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "网站名称") private String name; + @ApiModelProperty(value = "网站logo") private String logo; + @ApiModelProperty(value = "网站图标") private String favicon; + @ApiModelProperty(value = "登录页广告图") private String backdrop; + + @ApiModelProperty(value = "商城名称") private String shopName; + @ApiModelProperty(value = "商城LOGO") private String shopLogo; + @ApiModelProperty(value = "PC端LOGO") private String pcLogo; + @ApiModelProperty(value = "网站标题") private String pcTitle; + @ApiModelProperty(value = "网站图标") private String pcIco; + @ApiModelProperty(value = "网站描述") private String pcDesc; + @ApiModelProperty(value = "网站关键词") private String pcKeywords; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminDetailVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminDetailVo.java index f0138959..58890510 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminDetailVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminDetailVo.java @@ -1,30 +1,55 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; import java.util.List; -/** - * 管理员详情Vo - */ @Data +@ApiModel("管理员详情Vo") public class SystemAuthAdminDetailVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private List roleIds; // 角色ID - private List deptIds; // 部门ID - private List postIds; // 岗位ID - private String username; // 账号 - private String nickname; // 昵称 - private String avatar; // 头像 - private Integer isMultipoint; // 多端登录: [0=否, 1=是] - private Integer isDisable; // 是否禁用: [0=否, 1=是] - private String lastLoginIp; // 最后登录IP - private String lastLoginTime; // 最后登录时间 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "角色ID") + private List roleIds; + + @ApiModelProperty(value = "部门ID") + private List deptIds; + + @ApiModelProperty(value = "岗位ID") + private List postIds; + + @ApiModelProperty(value = "账号") + private String username; + + @ApiModelProperty(value = "昵称") + private String nickname; + + @ApiModelProperty(value = "头像") + private String avatar; + + @ApiModelProperty(value = "多端登录: [0=否, 1=是]") + private Integer isMultipoint; + + @ApiModelProperty(value = "是否禁用: [0=否, 1=是]") + private Integer isDisable; + + @ApiModelProperty(value = "最后登录IP") + private String lastLoginIp; + + @ApiModelProperty(value = "最后登录时间") + private String lastLoginTime; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminInformVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminInformVo.java index edb8a203..ff2e091b 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminInformVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminInformVo.java @@ -1,28 +1,51 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 管理员Vo - */ @Data +@ApiModel("管理员信息Vo") public class SystemAuthAdminInformVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer deptId; // 部门ID - private Integer postId; // 岗位ID - private String username; // 账号 - private String nickname; // 昵称 - private String avatar; // 头像 - private Integer isMultipoint; // 多端登录: [0=否, 1=是] - private Integer isDisable; // 是否禁用: [0=否, 1=是] - private String lastLoginIp; // 最后登录IP - private String lastLoginTime; // 最后登录时间 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "部门ID") + private Integer deptId; + + @ApiModelProperty(value = "岗位ID") + private Integer postId; + + @ApiModelProperty(value = "账号") + private String username; + + @ApiModelProperty(value = "昵称") + private String nickname; + + @ApiModelProperty(value = "头像") + private String avatar; + + @ApiModelProperty(value = "多端登录: [0=否, 1=是]") + private Integer isMultipoint; + + @ApiModelProperty(value = "是否禁用: [0=否, 1=是]") + private Integer isDisable; + + @ApiModelProperty(value = "最后登录IP") + private String lastLoginIp; + + @ApiModelProperty(value = "最后登录时间") + private String lastLoginTime; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminListedVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminListedVo.java index 4aa9cbec..d96d10be 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminListedVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminListedVo.java @@ -1,28 +1,51 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 管理员列表Vo - */ @Data +@ApiModel("管理员列表Vo") public class SystemAuthAdminListedVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String username; // 账号 - private String nickname; // 昵称 - private String avatar; // 头像 - private String dept; // 部门 - private String role; // 角色 - private Integer isMultipoint; // 多端登录: [0=否, 1=是] - private Integer isDisable; // 是否禁用: [0=否, 1=是] - private String lastLoginIp; // 最后登录IP - private String lastLoginTime; // 最后登录时间 - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "账号") + private String username; + + @ApiModelProperty(value = "昵称") + private String nickname; + + @ApiModelProperty(value = "头像") + private String avatar; + + @ApiModelProperty(value = "部门") + private String dept; + + @ApiModelProperty(value = "角色") + private String role; + + @ApiModelProperty(value = "多端登录: [0=否, 1=是]") + private Integer isMultipoint; + + @ApiModelProperty(value = "是否禁用: [0=否, 1=是]") + private Integer isDisable; + + @ApiModelProperty(value = "最后登录IP") + private String lastLoginIp; + + @ApiModelProperty(value = "最后登录时间") + private String lastLoginTime; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminSelvesVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminSelvesVo.java index 1db397b9..8cad9f70 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminSelvesVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthAdminSelvesVo.java @@ -1,14 +1,17 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; -/** - * 当前系统管理员Vo - */ @Data +@ApiModel("当前系统管理员Vo") public class SystemAuthAdminSelvesVo { - private Object user; // 用户信息 - private Object permissions; // 权限集合: [[*]=>所有权限, ['article:add']=>部分权限] + @ApiModelProperty(value = "用户信息") + private Object user; + + @ApiModelProperty(value = "权限集合: [[*]=>所有权限, ['article:add']=>部分权限]") + private Object permissions; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthDeptVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthDeptVo.java index d1df1a85..24fdc8d0 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthDeptVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthDeptVo.java @@ -1,25 +1,42 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 部门Vo - */ @Data +@ApiModel("部门Vo") public class SystemAuthDeptVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer pid; // 部门父级 - private String name; // 部门名称 - private String duty; // 负责人 - private String mobile; // 联系电话 - private Integer sort; // 排序编号 - private Integer isStop; // 是否停用: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "部门父级") + private Integer pid; + + @ApiModelProperty(value = "部门名称") + private String name; + + @ApiModelProperty(value = "负责人") + private String duty; + + @ApiModelProperty(value = "联系电话") + private String mobile; + + @ApiModelProperty(value = "排序编号") + private Integer sort; + + @ApiModelProperty(value = "是否停用: [0=否, 1=是]") + private Integer isStop; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthMenuVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthMenuVo.java index bdff1c29..be82455e 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthMenuVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthMenuVo.java @@ -1,32 +1,63 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统菜单Vo - */ @Data +@ApiModel("系统菜单Vo") public class SystemAuthMenuVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private Integer pid; // 上级菜单 - private String menuType; // 权限类型: [M=目录, C=菜单, A=按钮] - private String menuName; // 菜单名称 - private String menuIcon; // 菜单图标 - private Integer menuSort; // 菜单排序 - private String perms; // 权限标识 - private String paths; // 路由地址 - private String component; // 前端组件 - private String selected; // 选中路径 - private String params; // 路由参数 - private Integer isCache; // 是否缓存: [0=否, 1=是] - private Integer isShow; // 是否显示: [0=否, 1=是] - private Integer isDisable; // 是否禁用: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "上级菜单") + private Integer pid; + + @ApiModelProperty(value = "权限类型: [M=目录, C=菜单, A=按钮]") + private String menuType; + + @ApiModelProperty(value = "菜单名称") + private String menuName; + + @ApiModelProperty(value = "菜单图标") + private String menuIcon; + + @ApiModelProperty(value = "菜单排序") + private Integer menuSort; + + @ApiModelProperty(value = "权限标识") + private String perms; + + @ApiModelProperty(value = "路由地址") + private String paths; + + @ApiModelProperty(value = "前端组件") + private String component; + + @ApiModelProperty(value = "选中路径") + private String selected; + + @ApiModelProperty(value = "路由参数") + private String params; + + @ApiModelProperty(value = "是否缓存: [0=否, 1=是]") + private Integer isCache; + + @ApiModelProperty(value = "是否显示: [0=否, 1=是]") + private Integer isShow; + + @ApiModelProperty(value = "是否禁用: [0=否, 1=是]") + private Integer isDisable; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthPostVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthPostVo.java index 153f422a..d5e7f64a 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthPostVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthPostVo.java @@ -1,24 +1,39 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统岗位Vo - */ @Data +@ApiModel("系统岗位Vo") public class SystemAuthPostVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String code; // 岗位编号 - private String name; // 岗位名称 - private String remarks; // 岗位备注 - private Integer sort; // 岗位排序 - private Integer isStop; // 是否停用: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "岗位编号") + private String code; + + @ApiModelProperty(value = "岗位名称") + private String name; + + @ApiModelProperty(value = "岗位备注") + private String remarks; + + @ApiModelProperty(value = "岗位排序") + private Integer sort; + + @ApiModelProperty(value = "是否停用: [0=否, 1=是]") + private Integer isStop; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthRoleVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthRoleVo.java index bdd98c50..7de547c4 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthRoleVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemAuthRoleVo.java @@ -1,25 +1,42 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统角色Vo - */ @Data +@ApiModel("系统角色Vo") public class SystemAuthRoleVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String name; // 角色名称 - private String remark; // 角色备注 - private Object menus; // 关联菜单 - private Integer member; // 成员数量 - private Integer sort; // 角色排序 - private Integer isDisable; // 是否禁用: [0=否, 1=是] - private String createTime; // 创建时间 - private String updateTime; // 更新时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "角色名称") + private String name; + + @ApiModelProperty(value = "角色备注") + private String remark; + + @ApiModelProperty(value = "关联菜单") + private Object menus; + + @ApiModelProperty(value = "成员数量") + private Integer member; + + @ApiModelProperty(value = "角色排序") + private Integer sort; + + @ApiModelProperty(value = "是否禁用: [0=否, 1=是]") + private Integer isDisable; + + @ApiModelProperty(value = "创建时间") + private String createTime; + + @ApiModelProperty(value = "更新时间") + private String updateTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemCaptchaVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemCaptchaVo.java index 17793f6e..5bfd00e1 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemCaptchaVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemCaptchaVo.java @@ -1,14 +1,17 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; -/** - * 验证码 - */ @Data +@ApiModel("验证码") public class SystemCaptchaVo { + @ApiModelProperty(value = "标识") private String uuid; + + @ApiModelProperty(value = "图片") private String img; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogLoginVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogLoginVo.java index 4f87f5b4..36d482e0 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogLoginVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogLoginVo.java @@ -1,23 +1,36 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 登录日志Vo - */ @Data +@ApiModel("登录日志Vo") public class SystemLogLoginVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String username; // 登录账号 - private String ip; // 来源IP - private String os; // 操作系统 - private String browser; // 浏览器 - private Integer status; // 操作状态: [1=成功, 2=失败] - private String createTime; // 创建时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "登录账号") + private String username; + + @ApiModelProperty(value = "来源IP") + private String ip; + + @ApiModelProperty(value = "操作系统") + private String os; + + @ApiModelProperty(value = "浏览器") + private String browser; + + @ApiModelProperty(value = "操作状态: [1=成功, 2=失败]") + private Integer status; + + @ApiModelProperty(value = "创建时间") + private String createTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogOperateVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogOperateVo.java index ca702dc8..6aaa91f3 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogOperateVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLogOperateVo.java @@ -1,31 +1,60 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 操作日志Vo - */ @Data +@ApiModel("操作日志Vo") public class SystemLogOperateVo implements Serializable { private static final long serialVersionUID = 1L; - private Integer id; // 主键 - private String username; // 用户账号 - private String nickname; // 用户昵称 - private String type; // 请求类型: GET/POST/PUT - private String title; // 操作标题 - private String method; // 请求方式 - private String ip; // 请求IP - private String url; // 请求地址 - private String args; // 请求参数 - private String error; // 错误信息 - private Integer status; // 执行状态: [1=成功, 2=失败] - private String taskTime; // 执行耗时 - private String startTime; // 开始时间 - private String endTime; // 结束时间 - private String createTime; // 创建时间 + @ApiModelProperty(value = "主键") + private Integer id; + + @ApiModelProperty(value = "用户账号") + private String username; + + @ApiModelProperty(value = "用户昵称") + private String nickname; + + @ApiModelProperty(value = "请求类型: GET/POST/PUT") + private String type; + + @ApiModelProperty(value = "操作标题") + private String title; + + @ApiModelProperty(value = "请求方式") + private String method; + + @ApiModelProperty(value = "请求IP") + private String ip; + + @ApiModelProperty(value = "请求地址") + private String url; + + @ApiModelProperty(value = "请求参数") + private String args; + + @ApiModelProperty(value = "错误信息") + private String error; + + @ApiModelProperty(value = "执行状态: [1=成功, 2=失败]") + private Integer status; + + @ApiModelProperty(value = "执行耗时") + private String taskTime; + + @ApiModelProperty(value = "开始时间") + private String startTime; + + @ApiModelProperty(value = "结束时间") + private String endTime; + + @ApiModelProperty(value = "创建时间") + private String createTime; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLoginVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLoginVo.java index eb4701ff..e23a29a8 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLoginVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/system/SystemLoginVo.java @@ -1,18 +1,21 @@ package com.mdd.admin.vo.system; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 系统登录Vo - */ @Data +@ApiModel("系统登录Vo") public class SystemLoginVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "管理员ID") private Integer id; + + @ApiModelProperty(value = "登录令牌") private String token; } diff --git a/server/like-admin/src/main/java/com/mdd/admin/vo/user/UserVo.java b/server/like-admin/src/main/java/com/mdd/admin/vo/user/UserVo.java index e2219f23..535ce27d 100644 --- a/server/like-admin/src/main/java/com/mdd/admin/vo/user/UserVo.java +++ b/server/like-admin/src/main/java/com/mdd/admin/vo/user/UserVo.java @@ -1,28 +1,51 @@ package com.mdd.admin.vo.user; +import io.swagger.annotations.ApiModel; +import io.swagger.annotations.ApiModelProperty; import lombok.Data; import java.io.Serializable; -/** - * 用户Vo - */ @Data +@ApiModel("用户Vo") public class UserVo implements Serializable { private static final long serialVersionUID = 1L; + @ApiModelProperty(value = "用户ID") private Integer id; + + @ApiModelProperty(value = "用户编码") private Integer sn; + + @ApiModelProperty(value = "用户头像") private String avatar; + + @ApiModelProperty(value = "真实姓名") private String realName; + + @ApiModelProperty(value = "用户昵称") private String nickname; + + @ApiModelProperty(value = "登录账号") private String username; + + @ApiModelProperty(value = "手机号码") private String mobile; + + @ApiModelProperty(value = "用户性别") private String sex; + + @ApiModelProperty(value = "注册渠道") private String channel; + + @ApiModelProperty(value = "最后登录IP") private String lastLoginIp; + + @ApiModelProperty(value = "最后登录时间") private String lastLoginTime; + + @ApiModelProperty(value = "创建时间") private String createTime; public void setSex(Integer sex) {