资讯专栏INFORMATION COLUMN

怎样给Swagger换皮肤?

baishancloud / 1254人阅读

摘要:怎样给换皮肤上文我们讲到在中集成的组件,那今天我们就来聊聊怎样给换个皮肤呢环境搭建使用依赖进行快速构建。构建工具是,开发工具是,版本是。

怎样给Swagger换皮肤?

上文我们讲到在Spring Boot中集成Swagger2的组件,那今天我们就来聊聊怎样给Swagger换个皮肤呢?环境搭建:使用Spring Boot依赖swagger-spring-boot-starter进行快速构建。具体swagger-spring-boot-starter可以参考:https://github.com/SpringForA... 。构建工具是Maven,开发工具是IDEA,JDK版本是1.8。

第一步:Maven快速构建Spring Boot的web项目

第二步:解压,IDEA导入项目

第三步:集成swagger-spring-boot-starter

pom中依赖:


    com.spring4all
    swagger-spring-boot-starter
    1.8.0.RELEASE

添加@EnableSwagger2Doc添加允许启用swagger注解,默认情况下就能产生所有当前Spring MVC加载的请求映射文档。

第四步:配置swagger
# 在application.properties进行配置
swagger.title=码歌学院API
swagger.description=码歌学院相关接口API文档
swagger.version=1.1
swagger.base-package=com.mage

其他具体配置请参考GitHub,https://github.com/SpringForA...。注意在IDEA中配置文件存在中文,那么需要将其配置文件的编码设置成utf-8。具体设置:File -> Settings -> Editor -> File Encodings将Properties Files (*.properties)下的Default encoding for properties files设置为UTF-8,将Transparent native-to-ascii conversion前的勾选上。

第五步:编写TestController
package com.mage.swagger02.controller;

import com.mage.swagger02.model.Test;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("test")
@Api(tags = "测试API接口")
public class TestController {

    @GetMapping("")
    @ApiOperation(value="获取列表数据", notes="获取列表下测试数据")
    public String list() {
        return "查询列表数据!";
    }

    @GetMapping("{id}")
    @ApiOperation(value="获取ID数据", notes="根据ID获取某条测试数据")
    @ApiImplicitParam(name = "id", value = "主键id", paramType = "path", required = true)
    public String find(@PathVariable Integer id) {
        return String.format("根据主键查询数据: %d", id);
    }

    @PostMapping("")
    @ApiOperation(value="新增数据")
    @ApiParam(name = "test", value = "添加的测试模型实体")
    public String add(@RequestBody Test test) {
        return "插入数据!";
    }

    @PutMapping("{id}")
    @ApiOperation(value="更新数据", notes="根据ID更新测试数据")
    @ApiImplicitParam(name = "id", value = "主键id", paramType = "path", required = true)
    public String update(@PathVariable Integer id, @ApiParam(name = "test", value = "更新的测试模型实体") @RequestBody Test test) {
        return String.format("根据主键更新一条记录: %d", id);
    }

    @DeleteMapping("{id}")
    @ApiOperation(value="删除数据", notes="根据ID删除测试数据")
    @ApiImplicitParam(name = "id", value = "主键id", paramType = "path", required = true)
    public String delete(@PathVariable Integer id) {
        return String.format("根据主键删除记录: %d", id);
    }
}
第六步:启动执行,浏览器输入http://localhost:8080/swagger-ui.html

第七步:换皮肤

大家如果觉得swagger这种皮肤不好看,那么可以更换,只需要在pom中引入一下jar包:


    com.github.caspar-chen
    swagger-ui-layer
    1.1.2

然后浏览器输入:http://localhost:8080/docs.html

好了换肤完成,源码下载:https://github.com/magekang/s...

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/72513.html

相关文章

  • webpack构建下肤功能的思路

    摘要:最近项目中要实现一个换肤的功能,大体想了下,记录一下思路要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个打包生成多份皮肤文件因为项目是使用构建的,要想生成多份文件,就要在入口中配置多个入口文件,每个入口文件会提取出一个文件中整 source 最近项目中要实现一个换肤的功能,大体想了下,记录一下思路 要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个 打包生成多...

    Andrman 评论0 收藏0
  • webpack构建下肤功能的思路

    摘要:最近项目中要实现一个换肤的功能,大体想了下,记录一下思路要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个打包生成多份皮肤文件因为项目是使用构建的,要想生成多份文件,就要在入口中配置多个入口文件,每个入口文件会提取出一个文件中整 source 最近项目中要实现一个换肤的功能,大体想了下,记录一下思路 要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个 打包生成多...

    sushi 评论0 收藏0
  • webpack构建下肤功能的思路

    摘要:最近项目中要实现一个换肤的功能,大体想了下,记录一下思路要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个打包生成多份皮肤文件因为项目是使用构建的,要想生成多份文件,就要在入口中配置多个入口文件,每个入口文件会提取出一个文件中整 source 最近项目中要实现一个换肤的功能,大体想了下,记录一下思路 要实现换肤功能,目标就是打包生成多份皮肤文件,需要哪个就用哪个 打包生成多...

    Alan 评论0 收藏0
  • 自动化代码生成工具 Snips 开发实践

    摘要:今天我来和大家分享一下以及自动化生成工具的开发经验。代码生成工具接着讲讲代码生成工具,对于来讲,有官方的代码生成器,还有其他的同类开源项目比如。现有的代码生成器没有可以开箱即用的,都需要去进行不少的修改。 前言 在开发工作中,经常会遇到新产品、服务上线后,需要将其 API 编写不同语言的 SDK。但不同语言 SDK 中都有很大一部分内容是用来进行 API 的描述,而且这部分代码量是最大...

    only_do 评论0 收藏0
  • 自动化代码生成工具 Snips 开发实践

    摘要:今天我来和大家分享一下以及自动化生成工具的开发经验。代码生成工具接着讲讲代码生成工具,对于来讲,有官方的代码生成器,还有其他的同类开源项目比如。现有的代码生成器没有可以开箱即用的,都需要去进行不少的修改。 前言 在开发工作中,经常会遇到新产品、服务上线后,需要将其 API 编写不同语言的 SDK。但不同语言 SDK 中都有很大一部分内容是用来进行 API 的描述,而且这部分代码量是最大...

    qc1iu 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<