How to add the json request body in swagger ui (for java code, possibly using annotations)?

[wakandan]

I'm writing a dropwizard app. I want to have something similar to this

but what I'm having is only this (it doesn't have the json request body text form)

my annotations are like these

    @POST
    @UnitOfWork
    @Consumes(MediaType.APPLICATION_JSON)
    @ApiOperation(value = "Create a new shop", response = long.class, consumes="application/json")
    @ApiResponses(value = {
            @ApiResponse(code = 406, message = R.ERROR_SHOP_NAME_EXISTED),
            @ApiResponse(code = 404, message = R.ERROR_USER_NOT_FOUND),
            @ApiResponse(code = 201, message = "shop id") })
    public Response create(Shop shop) {

How do I make it work like the first picture? Thanks.

[webron]

Which version of swagger-core do you use?

[wakandan]

I'm using 1.5.3-M1

[fehguy]

Hi if you can, please update to 1.5.3 (yes, no M1 suffix).

[wakandan]

Hmm I was using swagger-core from com.wordnik, there was no 1.5.3 version. Changed to io.swagger:swagger-core:1.5.3 but it's still the same

[fehguy]

OK, please update your signature with an annotation:

public Response create(@ApiParam("description") Shop shop)

I believe that'll do it.

[wakandan]

is com.wordnik a fork from io.swagger? It's was in the first result that's why I added it in

[fehguy]

It was the predecessor to the io.swagger project.

[wakandan]

I'm using dropwizard-swagger package to work with dropwizard. This package seems to be using swagger-core:1.5.1-M2. I added io.swagger:swagger-core:1.5.3 it doesn't work. Seems like they can't work together & dropwizard-swagger is the culprit here...

[fehguy]

Got it. Then you can keep the current dependency and sumply add the @ApiParam annotation and all should be fine. There is probably an update to dropwizard swagger, or you can follow the sample in the swagger-samples project.

[wakandan]

👍 I will try and update this ticket later. Thanks

[fehguy]

great, let me know @wakandan

[wakandan]

@fehguy I confirm that in 1.5.3 the form for post body shows up with the use of @ApiParam. I'm creating pull-requests on the dropwizard-swagger side. Thanks for your help!

[fehguy]

great news, thanks for following up! And yes, perhaps you can reference the PR here for others

[wakandan]

@fehguy federecio/dropwizard-swagger#67

That pr would require this one as well (to resolve version conflicting) federecio/dropwizard-junit#7