java - Swagger api 客户端方法返回 void

Question

Swagger api 客户端，由 codegen 工具生成，仅创建返回类型为 void 的测试方法。如何测试我的休息 api？

这是我的服务代码规范:

 @Api(value = "Authentication Recovery")
 @Path("/authenticationRecovery")

public class AuthenticationRecoveryResource implements Authentication{

@ApiOperation(
        value = "Recover access token"
        , notes = "Recover access token assigned to the user (once it has been authenticated)"
        , response = TokenJAXB.class
        //, responseContainer = "List"
)
@ApiResponses(value = { 
        @ApiResponse(code = HttpURLConnection.HTTP_OK, message = "Authorized access") ,
        @ApiResponse(code = HttpURLConnection.HTTP_UNAUTHORIZED, message = "Unauthorized access") 
})
@POST
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_FORM_URLENCODED)
public Response authenticate(
        @ApiParam(value="Username", required=true) @FormParam("username") String username,
        @ApiParam(value="Password", required=true) @FormParam("password") String password) 
{..}

这是我生成的用于测试的 swagger 代码:

/**
  * API tests for AuthenticationRecoveryApi
*/
@Ignore

public class AuthenticationRecoveryApiTest {

private final AuthenticationRecoveryApi api = new AuthenticationRecoveryApi();

/**
 * Recover access token
 *
 * Recover access token assigned to the user (once it has been authenticated)
 *
 * @throws ApiException
 *             if the Api call fails
 */
@Test
public void authenticateTest() throws ApiException {
    String username = null;
    String password = null;
    api.authenticate(username, password);

    // TODO: test validations
}}

我已经生成了一个 swagger 客户端 api:

java -jar swagger-codegen-2.2.3/modules/swagger-codegen-cli/target/swagger-codegen-cli.jar generate -i http://localhost:8080/myproject/services/service0/swagger.json -l java -o client/myproject/java

Answer 1

Swagger Codegen 的 Java 生成器尽其所能 - 它具有带函数的测试代码(更像是函数 stub )，您可以在其中填写值要传递给 API 端点的参数，例如上面的变量 String username 和 String password。之后，调用 api 端点。

在 api 调用(api.authenticate(username, password) 上面)之后，您必须以某种方式验证响应是否成功。这需要人为因素，具体取决于您的 API，//TODO 注释提示您也这样做。

如果 API 调用成功，则什么都不做，void 函数退出。否则，您的代码需要抛出注释中所写的 ApiException。