How to get the body payload?

I am hoping this is a defect against documentation.

I am unable to retrieve the body payload for a POST operation.

Using the Swagger-Petstore sample, the POST to /pet has a body parameter defined as:

{
  "in": "body",
  "name": "body",
  "description": "Pet object that needs to be added to the store",
  "required": true,
  "schema": {
     "$ref": "#\/definitions\/Pet"
  }
}

Here is my sample code:

import io.swagger.models.Operation;
import io.swagger.models.Path;
import io.swagger.models.Swagger;
import io.swagger.models.parameters.Parameter;
import io.swagger.parser.SwaggerParser;

public class PetPostBody {

    public static void main(String[] args) {
	Swagger swagger = new SwaggerParser().read("http://petstore.swagger.io/v2/swagger.json");

	Path pet = swagger.getPath("/pet");
	Operation post = pet.getPost();
	Parameter body = null;
	for (Parameter param : post.getParameters()) {
	    if (param.getIn().equals("body"))
		body = param;
	}
	body.get???
    }
}

How do I retrieve the payload?

The only things that I can see (in debugger) for body is schema but that is access protected(?), and under that is genericRef (access private) that points to the definitions.

What am I missing?

[benken-parasoft]

Forgive me if I misunderstand your question but in case this helps . . . In swagger-parser 1, I use io.swagger.models.parameters.BodyParameter.getSchema()

List<Parameter> parameters = operation.getParameters();
if (parameters != null) {
    for (Parameter parameter: parameters) {
        if (parameter instanceof BodyParameter) {
            BodyParameter bp = (BodyParameter) parameter;
            Model schema = bp.getSchema();

In swagger-parser 2, I use io.swagger.oas.models.media.MediaType.getSchema()

RequestBody bodyParam = operation.getRequestBody();
if (bodyParam != null) {
    Content content = bodyParam.getContent();
    if (content != null) {
        for (Map.Entry<String, MediaType> request : content.entrySet()) {
            MediaType mediaType = request.getValue();
            Schema<?> schema = mediaType.getSchema()

[SiKing]

Looks like schema.get$ref() and schema.getReference() get you the same thing … at least in my case. So the approach I posted above is the correct way forward?

Our development has decided to use an API framework that only generates OAI2, and only partially at that. I do not have any say in that.