Swagger UI 使用

简介,基于Swagger UI其实是纯static的web程序,仅仅在页面加载的时候,调用http连接,获取yaml字符串或者json字符串

1、下载Swagger UI的代码:
     https://github.com/swagger-api/swagger-ui

2、从下载的代码中提取dist文件夹

3、修改dist文件夹下的index.html文件,修改代码
  <script type="text/javascript">
    $(function () {
      var url = window.location.search.match(/url=([^&]+)/);
      if (url && url.length > 1) {
        url = decodeURIComponent(url[1]);
      } else {
        url = "http://petstore.swagger.io/v2/swagger.json";
      }
  <script type="text/javascript">
    var resourceName=window.location.href.split('?')[1];
    $(function () {
      var url = window.location.search.match(/url=([^&]+)/);
      if (url && url.length > 1) {
        url = decodeURIComponent(url[1]);
      } else {
        //url = "http://petstore.swagger.io/v2/swagger.json";
        url="/yaml/"+resourceName+".yaml";
      }
4、找个tomcat,将加入了跨域配置的Java Web项目添加到webapps
     yaml.zip参考文章:http://blog.csdn.net/gsying1474/article/details/49664883
5、在yaml项目中,添加所有的yaml文件到yaml项目根目录下,将dist目录放到yaml的根目录下

6、在yaml项目的根目录中添加index.html文件,代码如下:
<!DOCTYPE html>
<html>
<head>
</head>
<body class="swagger-section">
    <a href="dist/index.html?api1" target="_blank">api1</a></br>
    <a href="dist/index.html?api2" target="_blank">api2</a></br>
    <a href="dist/index.html?api3" target="_blank">api3</a></br>
    <a href="dist/index.html?api4" target="_blank">api4</a></br>
    <a href="dist/index.html?api5" target="_blank">api5</a></br>
</body>
</html>


7、tomcat启动,访问即可
     http:// localhost:8091/yaml/index.html

你可能感兴趣的:(UI,api,yaml,swagger)