<dependency>
    <groupId>com.spring4all</groupId>
    <artifactId>swagger-spring-boot-starter</artifactId>
    <version>1.7.1.RELEASE</version>
</dependency>

然后，application.yml 里放入

swagger:
  title: ${artifactId}
  version: @version@
  contact:
    name: 小姐姐味道
    email: xiaojiejie@sayhiai.com
  base-package: com.sayhiai.controller
  base-path: /**
  exclude-path: /error, /ops/**

最后, App.java中加入注解

@EnableSwagger2Doc
@Slf4j
public class App extends SpringBootServletInitializer {
    public static void main(String[] args) {
        SpringApplication.run(App.class, args);
    }

三部曲完成以后，访问 http://{ip}:{port}/{contextPath}/swagger-ui.html ，就可以看到界面啦

好看一点

swagger改版后，颜值很低。我们尝试来改变它。

这里推荐两个界面。都是引入相应的jar包即可，不需要有任何其他改动。

swagger-ui-layer

<dependency>
  <groupId>com.github.caspar-chen</groupId>
  <artifactId>swagger-ui-layer</artifactId>
  <version>${last-version}</version>
</dependency>

swagger-bootstrap-ui

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

至于种草哪一个，看你喽。

Nginx

nginx才是本文的重点。主要是去做路由，方便你在本地调试。哪怕服务端部署在其他环境。

本地启动一个nginx，加几行配置就OK了

server {
        listen       80;
        location / {
           proxy_pass  http://192.168.3.227:11057/;
        }
        location /static/ {
            alias /codes/devops-publish-webapp/src/main/resources/static/;
        }

稍微解释一下。

访问 /时，默认去找服务端的rest请求
访问前端页面时，指向本地的静态文件目录

是不是想大呼一声：卧槽，这么简单。对，就是这么简单！在后端解决跨域问题前，你甚至能将后端多个项目揉在一起。

其他

有同学反映有大量js在项目里的时候。打开Idea，会非常的慢。原因就是你的Idea在索引你的js文件。只要把静态目录排除掉就可以了。这里这里：