使用以下Swagger Core的Java Jersey项目:
<dependency>
<groupId>io.swagger.core.v3</groupId>
<artifactId>swagger-jaxrs2</artifactId>
<version>2.0.2</version>
</dependency>
文档链接转到“openapi.json”。从here下载Swagger-UI dist ver 3.20.5。 Java代码是这样的:
@Path("/auth")
public class TestConttroller {
@GET
@Path("/{id}")
@Produces({MediaType.APPLICATION_JSON, MediaType.APPLICATION_XML})
public Response testGet(
@DefaultValue("") @HeaderParam("Authorization") String a,
@DefaultValue("") @PathParam("id") String id)
{
return Response.ok().build();
}
当从邮递员发送请求时一切正常。但是当跟随Swagger-UI时,header-param字符串“a”是一个空字符串,而path-param字符串是好的。 openapi.json中的部分在这里:
"paths" : {
"/auth/{id}" : {
"get" : {
"operationId" : "testGet",
"parameters" : [ {
"name" : "Authorization",
"in" : "header",
"schema" : {
"type" : "string",
"default" : ""
}
}, {
"name" : "id",
"in" : "path",
"required" : true,
"schema" : {
"type" : "string",
"default" : ""
}
} ],
"responses" : {
"default" : {
"description" : "default response",
"content" : {
"application/json" : { },
"application/xml" : { }
}
}
}
}
}
@HeaderParam(“授权”)就像是HTTP的关键字?当我使用其他名称如“Auth”时,它的工作原理。