swagger

src/main/java/com/huiju/estateagents/controller/ExtendContentController.java

 import com.huiju.estateagents.service.IExtendContentService;
 import com.huiju.estateagents.service.ITaBuildingDynamicService;
 import com.huiju.estateagents.service.ITaBuildingService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
+import io.swagger.annotations.ApiOperation;
 import org.apache.commons.lang3.StringUtils;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
  */
 @RestController
 @RequestMapping("/api")
+@Api(value = "轮播图", tags = "轮播图")
 public class ExtendContentController extends BaseController {
 
     private final Logger logger = LoggerFactory.getLogger(ExtendContentController.class);
      * @param pageSize
      * @return
      */
+    @ApiOperation(value = "后台轮播图列表", notes = "后台轮播图列表")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageNum", paramType = "query",value = "第几页"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageSize", paramType = "query",value = "一页多少行"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "buildingId", paramType = "query",value = "项目id"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "contentType", paramType = "query",value = "内容类型"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "showPosition", paramType = "query",value = "发布位置"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "status", paramType = "query",value = "状态"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "showType", paramType = "query",value = "发布类型")
+    })
     @RequestMapping(value="/admin/extendContent",method= RequestMethod.GET)
     public ResponseBean extendContentList(@RequestParam(value ="pageNum",defaultValue = "1") Integer pageNum,
                                           @RequestParam(value ="pageSize",defaultValue = "10") Integer pageSize,
     /**
      * 微信 开屏 / 轮播图
      */
+    @ApiOperation(value = "微信轮播图列表", notes = "微信轮播图列表")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageNum", paramType = "query",value = "第几页"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageSize", paramType = "query",value = "一页多少行"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "buildingId", paramType = "query",value = "项目id"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "contentType", paramType = "query",value = "内容类型"),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "targetId", paramType = "query",value = ""),
+            @ApiImplicitParam(dataTypeClass = String.class, name = "contentId", paramType = "query",value = "内容ID"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "cityId", paramType = "query",value = "城市ID")
+    })
     @RequestMapping(value="/wx/extendContent/{showType}",method= RequestMethod.GET)
     public ResponseBean extendContentListShowType(@PathVariable(value = "showType") String showType,
                                                   @RequestParam(value = "showPosition", required = false) String showPosition,
      * @param extendContent 实体对象
      * @return
      */
+    @ApiOperation(value = "后台轮播图保存", notes = "后台轮播图保存")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "ExtendContent", name = "extendContent", paramType = "body",value = "轮播图内容")
+    })
     @RequestMapping(value="/admin/extendContent",method= RequestMethod.POST)
     public ResponseBean extendContentAdd(@RequestBody ExtendContent extendContent, HttpServletRequest request){
         Integer cityId = iTaBuildingService.getCityById(extendContent.getBuildingId());
      * 根据id删除对象
      * @param id  实体ID
      */
+    @ApiOperation(value = "后台轮播图删除", notes = "后台轮播图删除")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "payh",value = "轮播图id")
+    })
     @ResponseBody
     @RequestMapping(value="/admin/extendContent/{id}", method= RequestMethod.DELETE)
     public ResponseBean extendContentDelete(@PathVariable Integer id){
      * @param extendContent 实体对象
      * @return
      */
+    @ApiOperation(value = "后台轮播图保存", notes = "后台轮播图保存")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "payh",value = "轮播图id"),
+            @ApiImplicitParam(dataType = "ExtendContent", name = "extendContent", paramType = "body",value = "轮播图内容")
+    })
     @RequestMapping(value="/admin/extendContent/{id}",method= RequestMethod.PUT)
     public ResponseBean extendContentUpdate(@PathVariable Integer id,
                                         @RequestBody ExtendContent extendContent,HttpServletRequest request){
      * 根据id查询对象
      * @param id  实体ID
      */
+    @ApiOperation(value = "后台轮播图查询", notes = "后台轮播图查询")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "payh",value = "轮播图id")
+    })
     @RequestMapping(value="/admin/extendContent/{id}",method= RequestMethod.GET)
     public ResponseBean extendContentGet(@PathVariable Integer id){
         ResponseBean responseBean = new ResponseBean();

src/main/java/com/huiju/estateagents/controller/TaPolicyController.java

 import com.huiju.estateagents.entity.TdCity;
 import com.huiju.estateagents.service.ITdCityService;
 import com.huiju.estateagents.service.ITaPolicyService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
+import io.swagger.annotations.ApiOperation;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
  */
 @RestController
 @RequestMapping("/api")
+@Api(value = "政策维护", tags = "政策维护")
 public class TaPolicyController extends BaseController {
 
     private final Logger logger = LoggerFactory.getLogger(TaPolicyController.class);
      * @param pageSize
      * @return
      */
+    @ApiOperation(value = "后台政策维护列表", notes = "后台政策维护列表")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageNum", paramType = "query",value = "第几页"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageSize", paramType = "query",value = "一页多少行"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "cityId", paramType = "query",value = "城市ID")
+    })
     @RequestMapping(value="/admin/taPolicy",method= RequestMethod.GET)
     public ResponseBean taPolicyList(@RequestParam(value ="pageNum",defaultValue = "1") Integer pageNum,
 									 @RequestParam(value ="pageSize",defaultValue = "10") Integer pageSize,
      * @param pageSize
      * @return
      */
+    @ApiOperation(value = "微信政策维护列表", notes = "微信政策维护列表")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageNum", paramType = "query",value = "第几页"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageSize", paramType = "query",value = "一页多少行"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "cityId", paramType = "query",value = "城市ID")
+    })
     @RequestMapping(value="/wx/taPolicy",method= RequestMethod.GET)
     public ResponseBean taPolicyListCity(@RequestParam(value ="pageNum",defaultValue = "1") Integer pageNum,
                                      @RequestParam(value ="pageSize",defaultValue = "10") Integer pageSize,
      * @param taPolicy 实体对象
      * @return
      */
+    @ApiOperation(value = "后台政策维护保存", notes = "后台政策维护保存")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "TaPolicy", name = "taPolicy", paramType = "body",value = "政策数据")
+    })
     @RequestMapping(value="/admin/taPolicy",method= RequestMethod.POST)
     public ResponseBean taPolicyAdd(@RequestBody TaPolicy taPolicy, HttpServletRequest request){
         ResponseBean responseBean = new ResponseBean();
      * 根据id删除对象
      * @param id  实体ID
      */
+    @ApiOperation(value = "后台政策维护删除", notes = "后台政策维护删除")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "path",value = "政策数据ID")
+    })
     @ResponseBody
     @RequestMapping(value="/admin/taPolicy/{id}", method= RequestMethod.DELETE)
     public ResponseBean taPolicyDelete(@PathVariable Integer id){
      * @param taPolicy 实体对象
      * @return
      */
+    @ApiOperation(value = "后台政策维护修改", notes = "后台政策维护修改")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "path",value = "政策数据ID"),
+            @ApiImplicitParam(dataType = "TaPolicy", name = "taPolicy", paramType = "body",value = "政策数据")
+    })
     @RequestMapping(value="/admin/taPolicy/{id}",method= RequestMethod.PUT)
     public ResponseBean taPolicyUpdate(@PathVariable Integer id,
                                         @RequestBody TaPolicy taPolicy,
      * 根据id查询对象
      * @param id  实体ID
      */
+    @ApiOperation(value = "后台政策维护查询", notes = "后台政策维护查询")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "path",value = "政策数据ID")
+    })
     @RequestMapping(value="/admin/taPolicy/{id}",method= RequestMethod.GET)
     public ResponseBean taPolicyGet(@PathVariable Integer id){
         ResponseBean responseBean = new ResponseBean();
      * 根据id查询对象
      * @param id  实体ID
      */
+    @ApiOperation(value = "微信政策维护查询", notes = "微信政策维护查询")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataType = "Integer", name = "id", paramType = "path",value = "政策数据ID")
+    })
     @RequestMapping(value="/wx/taPolicy/{id}",method= RequestMethod.GET)
     public ResponseBean taPolicyGetWx(@PathVariable Integer id){
         ResponseBean responseBean = new ResponseBean();

src/main/java/com/huiju/estateagents/controller/TdReportController.java

 import com.huiju.estateagents.base.ResponseBean;
 import com.huiju.estateagents.entity.TdReport;
 import com.huiju.estateagents.service.ITdReportService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiImplicitParam;
+import io.swagger.annotations.ApiImplicitParams;
+import io.swagger.annotations.ApiOperation;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
  */
 @RestController
 @RequestMapping("/api")
+@Api(value = "客户留言", tags = "客户留言")
 public class TdReportController extends BaseController {
 
     private final Logger logger = LoggerFactory.getLogger(TdReportController.class);
      * @param pageSize
      * @return
      */
+    @ApiOperation(value = "后台客户留言列表", notes = "后台客户留言列表")
+    @ApiImplicitParams({
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageNum", paramType = "query",value = "第几页"),
+            @ApiImplicitParam(dataTypeClass = Integer.class, name = "pageSize", paramType = "query",value = "一页多少行")
+    })
     @RequestMapping(value="/admin/tdReports",method= RequestMethod.GET)
     public ResponseBean tdReportList(@RequestParam(value ="pageNum",defaultValue = "1") Integer pageNum,
                                      @RequestParam(value ="pageSize",defaultValue = "10") Integer pageSize){