swagger入门
上面的图中我们看到,除了自己暴露的接口外,还要框架自身暴露的,如果我们想要指定哪些接口暴露出来,可以使用如下图的方式:
我们还可以指定swagger是否自启动,可以调用docket实例的enable(),指定参数为false为不启动
一般不同组的开发人员,有属于他们自己的开发文档,是根据组名来区分开的,而组又是根据docket来分别的,所以一般都是在容器中会有多个docket:
下面讲的是页面中底部栏的实体类信息这一块,如果你直接在包中比如bean包下建了一个user类,swagger识别不了,根本就毫不关系两者,如果想要实体类被扫描到,可通过下面方式:
下面给swagger页面的接口和属性等加注释:
@ApiModel是给实体类加上注解
@ApiModelProperty是给实体类的属性加上注解
@API是用在controller等上面的,不是用在实体类