Swagger-UI

OpenAPI

随着互联网技术的发展,现在的网站架构基本都由原来的后端道染,变成了:前端渲染、前后端分离的形态,而且前端技术和后端技术在各自的道路上越走越远。前端和后端的唯一联系, 变成了API接口; API文档变成了前后端开发人员联系的纽带,变得越来越重要。

OpenAPI规范(OpenAPI Specification简称OAS)是Linux基金会的一个项目,试图通过定义一种用来描述API格式或API定义的语言,来规范RESTful服务开发过程。

Swagger

OpenAPI是一个编写API文档的规范,然而如果手动去编写OpenAPI规范的文档,是非常麻烦的。而Swagger就是一个实现了OpenAPI规范的工具集。

引用

<dependency>
	<groundId>io.springfox</groundId>
	<artifactId>springfox-swagger2</artifactId>
</dependency>
<dependency>
	<groundId>io.springfox</groundId>
	<artifactId>springfox-swagger-ui</artifactId>
</dependency>

配置

@Configuration
@EnableSwagger2
public class SwaggerConfig {
	@Bean
	public Docket api() {
		return new Docket (DocumentationType. SWAGGER_2)
			.host ("loealhost:8089")
			.apiInfo (apiInfo())
			.select()
			.apis (RequestHandlerSelectors. basePackare("com.leyou.order.controller"))
			.paths(PathSelectors.any())
			.build();
	}
	private ApiInfo apiInfo() {
		return new ApiInfoBuilder()
			. title("乐优商城订单系续")
			.description("乐优商城订单系统接口文档")
			.version("1.0")
			.build();
	}
}

Controller层

@RestController
@RequestMapping("order")
@Api("订单服务接口")
public class OrderController{
	@PostMapping
	@ApiOperation(value="创建订单接口,返回订单编号",notes="创建订单")
	public {……}


	@GetMapping("list")
	@ApiOperation(value ="分页查询当前用户订单。并且可以根据订单状去过油",notes ="分页查湖当前用户订单")
	@ApiImplicitParams(( 
		@ApiImplicitParams(name = "page", value ="当前页",defaultValue = "1", type ="Integer"),
		@ApiImplicitParams(name = "rows", value ="每页大小”,defaultValue =“5",type = "Integer"),
		@ApiImplicitParams(name="status", value ="订单状态: 1末付款,2己付款术发货,3已发货未确认。4己确认未评价,5交易关闭"
	})
	@ApiResponses((
		@ApiResponses(code = 200, message ="订单的分页结果")@ApiResponses(code = 404,
message ="没有查询到结果")@ApiResponses(code = 500, message ="查询失败")
	})
	public {……}

	
}


在这里插入图片描述

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值