feat:增加swagger注释

shuili-system/src/main/java/com/kms/yg/znjg/controller/SyDirLayerController.java

@@ -6,6 +6,8 @@ import com.kms.yg.znjg.service.SyDirService;
 import com.kms.yg.znjg.service.SyLayerService;
 import com.kms.yg.znjg.vo.SyDirVo;
 import com.kms.yxgh.base.Response;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.transaction.annotation.Transactional;
 import org.springframework.transaction.interceptor.TransactionAspectSupport;
@@ -20,6 +22,7 @@ import java.util.List;
  */
 @RestController
 @RequestMapping("/map/layerDir")
+@Api(tags = "图层目录管理")
 public class SyDirLayerController {
     @Autowired
     private SyLayerService syLayerService;
@@ -37,6 +40,7 @@ public class SyDirLayerController {
      * @return
      */
     @GetMapping(value = "/getAllTreeDir")
+    @ApiOperation("查询图层目录树信息")
     public Response getAllTreeDir(String parentId) {
         Response response = new Response();
         try {
@@ -62,13 +66,14 @@ public class SyDirLayerController {
     }
 
     /**
-     * 保存图层目录信息
+     * 保存或更新图层目录信息
      *
      * @param syDir 目录实体对象
      * @return
      * @throws Exception
      */
     @PostMapping(value = "/saveDir")
+    @ApiOperation("保存或更新图层目录信息")
     public Response saveDir(SyDir syDir) throws Exception {
         try {
             return syDirService.saveSyDir(syDir);
@@ -82,7 +87,7 @@ public class SyDirLayerController {
     }
 
     /**
-     * 删除图层目录
+     * 根据目录id删除图层目录
      *
      * @param dirId 目录id,不能为空
      * @return
@@ -90,6 +95,7 @@ public class SyDirLayerController {
      */
     @Transactional(rollbackFor = Exception.class)
     @DeleteMapping(value = "/deleteDir")
+    @ApiOperation("根据目录id删除图层目录")
     public Response removeDirAndSonById(String dirId) throws Exception {
         Response response = new Response();
         try {

shuili-system/src/main/java/com/kms/yg/znjg/controller/SyLayerController.java

@@ -10,6 +10,8 @@ import com.kms.yg.znjg.service.SyLayerService;
 import com.kms.yxgh.base.Response;
 import com.shuili.common.core.domain.SearchParam;
 import com.shuili.common.core.domain.entity.SysUser;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.apache.commons.lang.StringUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -22,6 +24,7 @@ import java.util.stream.Collectors;
  */
 @RestController
 @RequestMapping("/map/layer")
+@Api(tags = "图层管理")
 public class SyLayerController {
     @Autowired
     private SyLayerService syLayerService;
@@ -34,6 +37,7 @@ public class SyLayerController {
      * @throws Exception
      */
     @RequestMapping(value = "/getDetails/{layerId}", method = RequestMethod.GET)
+    @ApiOperation("根据图层id获取图层详细信息")
     public Response getDetails(@PathVariable(value = "layerId") String layerId) throws Exception {
         Response resultForm = new Response();
         try {
@@ -55,6 +59,7 @@ public class SyLayerController {
      * @throws Exception
      */
     @PostMapping(value = "/saveOrUpdateLayer")
+    @ApiOperation("保存或者更新服务图层")
     public Response saveOrUpdateLayer(@RequestBody SyLayer syLayer) throws Exception {
         Response response = new Response();
         try {
@@ -100,6 +105,7 @@ public class SyLayerController {
      * @return
      */
     @RequestMapping(value = "/deleteLayer/{ids}", method = RequestMethod.DELETE)
+    @ApiOperation("根据图层id集合删除资源图层")
     public Response<String> deleteSrs(@PathVariable(value = "ids") String ids) {
         Response<String> responseInfo = new Response<>();
         try {
@@ -125,6 +131,7 @@ public class SyLayerController {
      * @return
      */
     @PostMapping(value = "/getLayers")
+    @ApiOperation("根据查询条件分页查询全部资源信息")
     public IPage<SyLayer> getLayers(@RequestBody SearchParam<SyLayer> spLayer) {
         SyLayer syLayerInfo = spLayer.getData();
         Page<SyLayer> page = new Page<>(spLayer.getPageNum(),spLayer.getPageSize());