swagger-ui及swagger用法

默认的swagger-ui好用但是不够美观，为了让生成的文档更加可观，我们可以使用swagger-ui-layer 来美化。

swagger-ui-layer，基于layui 开源的swagger-ui的替换。界面大气，使用起来也很方便。swagger-ui-layer 依于swagger的功能，所以在原先项目中导入以下依赖即可

注意：

使用规则：

一、在返回对象类上中要使用注解@ApiModel(value="实体类对象", description="实体类描述")，对象字段上使用@ApiModelProperty(value=”字段说明“,required=”是否必填”)表示对model属性的说明

注意：@ApiModel value 不能同名，否则会导致参数乱窜.

二、@API使用在Controller类上，表明是swagger资源

@Api(value = "仓库管理controller", tags = {"仓库管理接口"})

三、在每个接口方法中使用注解@ApiOperation(value = “接口说明”, httpMethod = “接口请求方式”, response = “接口返回参数类型”, notes = “接口发布说明”)；表示一个http请求的 *** 作

四、 @RequestBody和@ApiImplicitParam不能共用

@RequestBody主要用来接收前端传递给后端的json字符串中的数据的，如果想要swagger显示出实体类的参数描述信息要在实体类上使用@ApiModel(value="")

原先：在接口方法中会使用@ApiImplicitParam(name = "vo", value = "用户实体类", paramType = "body", required = true, dataType = "UserVo") 但@RequestBody和@ApiImplicitParam注解，会使实体类参数描述信息显示不出来，所以@ApiImplicitParam适用于没有接收实体类参数的方法

五、 @ApiParam 用于 Controller 中方法的参数说明。如图所示。

六、如果接口中，实体参数的描述没有显示出来可以加上@ModelAttribute 注解

七、通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中：URL 中的 {xxx} 占位符可以通过@PathVariable(“xxx“) 绑定到 *** 作方法的入参中。在swagger接口文档中，不会显示出这个占位符的具体信息，如下不会显示出这个id的说明

建议使用@ApiParam注解：

也可以使用@ApiImplicitParam对接收的参数进行解释

注意：

要改成这样

八、在使用@RequestParam注解，获得前台传递的值，一般要结合@ApiParam注解使用

Web API文档工具列表 Swagger ——Swagger框架可以通过代码生成漂亮的在线API，甚至可以提供运行示例。支持Scala、Java、Javascript、Ruby、PHP甚至 Actionscript 3。在线 Demo 。 I/O Docs ——I/O Docs是一个用于RESTful Web APIs的交互式文档系统...

1、首先@Entity注解加在实体类上，定义对象将会成为被JPA管理的实体，将映射到指定的数据库。

2、一般自增主键的名字都会用id来表示，@Id注解表名是表的自增主键，一个实体里只能又一个。

3、@IdClass注解可以实现一个实体类中有两个主健，即联合主健。首先需要创建一个联合主健类并且实现序列化接口，类名为TeacherBlogKey，该类中有id和studentId这两个字段。

4、@Basic表示属性到数据库字段的映射，实体类的属性不加任何注解的时候默认是@Basic注解。

5、最后如果实体类中的一个属性并不想和数据库中的字段做映射的话，可以使用@Transient注解，这个注解表示非持久化属性，与@Basic注解的作用相反，JPA映射数据库的时候会忽略它。

---