Как я могу заставить Swagger игнорировать @Suspended AsyncResponse в методах bean-компонентов @Asynchronous jax-rs?

Swagger-Core, похоже, интерпретирует окончательный элемент @Suspended asyncResponse asyncResponse как параметр тела запроса. Это явно не намеренно и не так.

Я хотел бы сказать swagger-core игнорировать этот параметр и исключить его из API-документов. Любые идеи?

Вот как выглядит мой код:

@Stateless
@Path("/coffee")
@Api(value = "/coffee", description = "The coffee service.")
public class CoffeeService
{
    @Inject
    Event<CoffeeRequest> coffeeRequestListeners;

    @GET
    @ApiOperation(value = "Get Coffee.", notes = "Get tasty coffee.")
    @ApiResponses({
            @ApiResponse(code = 200, message = "OK"),
            @ApiResponse(code = 404, message = "Beans not found."),
            @ApiResponse(code = 500, message = "Something exceptional happend.")})
    @Produces("application/json")
    @Asynchronous
    public void makeCoffee( @Suspended final AsyncResponse asyncResponse,

                             @ApiParam(value = "The coffee type.", required = true)
                             @QueryParam("type")
                             String type)
    {
        coffeeRequestListeners.fire(new CoffeeRequest(type, asyncResponse));
    }
}

Обновление: решение на основе ответа

public class InternalSwaggerFilter implements SwaggerSpecFilter
{
    @Override
    public boolean isOperationAllowed(Operation operation, ApiDescription apiDescription, Map<String, List<String>> stringListMap, Map<String, String> stringStringMap, Map<String, List<String>> stringListMap2) {
        return true;
    }

    @Override
    public boolean isParamAllowed(Parameter parameter, Operation operation, ApiDescription apiDescription, Map<String, List<String>> stringListMap, Map<String, String> stringStringMap, Map<String, List<String>> stringListMap2) {
        if( parameter.paramAccess().isDefined() && parameter.paramAccess().get().equals("internal") )
            return false;
        return true;
    }
}

FilterFactory.setFilter(new InternalSwaggerFilter());

Фрагмент исправленного примера кода

...
@Asynchronous
public void makeCoffee( @Suspended @ApiParam(access = "internal") final AsyncResponse asyncResponse,...)
...

jax-rs swagger ejb
person Özkan Can    schedule 20.02.2014    source источник

Ответы (4)


arrow_upward
0
arrow_downward

Я думаю, что вы должны использовать фильтры. Вот пример https://github.com/wordnik/swagger-core/issues/269

Может быть закодирован и на java.

person usul_    schedule 20.02.2014

arrow_upward
8
arrow_downward

Перенесемся в 2016 год, где swagger-springmvc заменен на springfox (доступна документация здесь). Игнорирование параметров доступно в springfox, но по какой-то причине не задокументировано:

Альтернатива 1: глобально игнорировать типы или аннотированные типы с помощью .ignoredParameterTypes(...) в конфигурации Docket:

@Bean
public Docket api() {
    return new Docket(DocumentationType.SWAGGER_2)
        .host(reverseProxyHost)
        .useDefaultResponseMessages(false)
        .directModelSubstitute(OffsetDateTime.class, String.class)
        .directModelSubstitute(Duration.class, String.class)
        .directModelSubstitute(LocalDate.class, String.class)
        .forCodeGeneration(true)
        .globalResponseMessage(RequestMethod.GET, newArrayList(
            new ResponseMessageBuilder()
                .code(200).message("Success").build()
            )
        .apiInfo(myApiInfo())
        .ignoredParameterTypes(AuthenticationPrincipal.class, Predicate.class, PathVariable.class)
        .select()
            .apis(withClassAnnotation(Api.class))
            .paths(any())
        .build();
}

Вариант 2: используйте аннотацию @ApiIgnore, чтобы игнорировать один параметр в методе:

@ApiOperation(value = "User details")
@RequestMapping(value = "/api/user", method = GET, produces = APPLICATION_JSON_UTF8_VALUE)
public MyUser getUser(@ApiIgnore @AuthenticationPrincipal MyUser user) {
    ...
}
person gogstad    schedule 19.05.2016
comment
Этот ответ специфичен для Spring. - person Vikas Prasad; 05.07.2018

arrow_upward
3
arrow_downward

Я решил эту проблему с помощью той же техники, что и вы, но с другим подходом. Вместо того, чтобы помечать его как внутренний, я просто игнорирую все параметры с типом AsyncResponse, таким образом мне не нужно обновлять код во всех методах, чтобы добавить модификатор доступа.

public class CustomSwaggerSpecFilter implements SwaggerSpecFilter {
    @Override
    public boolean isOperationAllowed(Operation operation, ApiDescription api, Map<String, List<String>> params, Map<String, String> cookies,
            Map<String, List<String>> headers) {
        return true;
    }

    @Override
    public boolean isParamAllowed(Parameter parameter, Operation operation, ApiDescription api, Map<String, List<String>> params,
            Map<String, String> cookies, Map<String, List<String>> headers) {
        if(parameter.dataType().equals("AsyncResponse")) { // ignoring AsyncResponse parameters
            return false;
        }

        return true;
    }
}

Это работает лучше для меня.

person raspacorp    schedule 10.09.2014
comment
Какую версию вы используете. Для меня нет такого метода dataType()? - person Vikas Prasad; 05.07.2018
comment
Извините, это было давно, не помню какая это была версия, уже не работает с той кодовой базой. Я думаю, что API-интерфейсы Swagger сильно изменились с тех пор. - person raspacorp; 16.07.2018

arrow_upward
0
arrow_downward

Другой способ может состоять в том, чтобы сделать это.

@Bean
public SwaggerSpringMvcPlugin mvPluginOverride() {
    SwaggerSpringMvcPlugin swaggerSpringMvcPlugin = new SwaggerSpringMvcPlugin(this.springSwaggerConfig).apiInfo(apiInfo());
    swaggerSpringMvcPlugin.ignoredParameterTypes(PagedResourcesAssembler.class, Pageable.class);
    return swaggerSpringMvcPlugin;
}
person lawal    schedule 19.03.2015