swagger2的一些配置描述和mvn deploy命令时遇到的一些问题和解决

主要是完善增删改

记录swagger2的一些配置描述和mvn deploy命令时遇到的一些问题和解决

下面的代码是有多个参数的情况,dataType java中的integer不支持,得写成int,paramType的值为query时,参数是以?page=1在路径中传参,值为path时,在路径中以/{}这种形式在路径中传数据

swagger2有两种UI界面,

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
    <version>1.7.7</version>
</dependency>

这种比较友好一些,可以参考https://blog.csdn.net/lkx444368875/article/details/80407893这篇文章

@ApiImplicitParams({
        @ApiImplicitParam(name = "page", value = "当前页", dataType = "int", paramType = "query"),
        @ApiImplicitParam(name = "size", value = "每页记录数", dataType = "int", paramType = "query")
})

PageHelper.startPage(page, size);

分页的时候注意page参数的处理,默认值为1,表示默认从第一页开始,page=page>=1?page:1;

mvn deploy -X 可以查看debug日志,可以看到deploy时会使用哪个settings.xml文件,默认会

默认会寻找配置的maven的conf下的settings.xml,我的配置了其他名字的配置,刚开始是把账号和密码配置在其他的配置里,默认的配置里没有添加账号和密码,所以一直报Return code is: 401, ReasonPhrase: Unauthorized,认证的错误,在默认的配置里加上账号和密码就好了,如果密码里有特殊符号比如&,需要转义,用&转义

mvn deploy的时候还要注意

私服的RepositoryID 是否和你pom.xml里面的distributionManagement的id是否一样,还有releases的ID是否一样