0

我正在使用 swaggerUI 来验证我的 swagger 规范。

GET 方法或带有主体的 POST 方法可以正常工作，但是在使用带有 @FormParam 的 POST 方法时会遇到问题。我的服务器说它缺少请求中的内容类型，这是正确的，SwaggerUi 生成的命令看起来像这样

curl -X POST "https://localhost:8184/authentication/password/reset?username=chrome&newPassword=11114444" -H "accept: application/json"

我的 swaggerUI 代码看起来是这样的

 /user/delete:
post:
  tags:
  - "Usermanagement"
  summary: Löscht einen Nutzer
  description: Löscht einen Nutzer anhand seines "username"
  consumes: 
  - application/x-www-form-urlencoded
  produces: 
  - application/json
  parameters: 
  - in: query
    name: username
    type: "string"
    description: Benutzername
  responses:
    200:
      description: Nutzer wurde erfolgreich gelöscht
    400:
      description: Der Löschvorgang konnte nicht ausgeführt werden

而我的服务器代码看起来像这样

@POST
@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
@Produces(MediaType.APPLICATION_JSON)
@Path("/activation")
public Response activation(@NotNull @FormParam("username") String username,
        @NotNull @FormParam("active") Boolean active) {
    return runWithExceptionMapper(() -> {
        if (active) {
            userService.activateUser(username);
        } else {
            userService.deactivateUser(username);
        }
    });
}

服务器代码通常很好，它可以在浏览器和 Postman 中运行。

我只是不明白为什么 swaggerUI 不使用 curl 命令发送 contenttype 或者我如何强制它这样做。

编辑：我发现 brwoser 不是发送 curl 命令，而是发送 http 请求。但是负载中仍然缺少内容，即内容类型。为什么我的服务器不知道如何处理“未知”数据。

4

1 回答 1

0

问题解决了。

错误是我的参数类型。而不是查询，它应该是 formData （显然）。

正确的规范代码如下所示

/user/delete:
post:
tags:
- "Usermanagement"
summary: Löscht einen Nutzer
description: Löscht einen Nutzer anhand seines "username"
consumes: 
- application/x-www-form-urlencoded
produces: 
- application/json
parameters: 
  - in: formData
  name: username
  type: "string"
  description: Benutzername
responses:
  200:
    description: Nutzer wurde erfolgreich gelöscht
  400:
    description: Der Löschvorgang konnte nicht ausgeführt werden
于 2018-10-01T09:15:41.143 回答