org.wildfly.swarm.microprofile.openapi.runtime.util

Class ModelUtil

java.lang.Object

org.wildfly.swarm.microprofile.openapi.runtime.util.ModelUtil

public class ModelUtil
extends Object

Class with some convenience methods useful for working with the OAI data model.

Author:

eric.wittmann@gmail.com

Method Summary

Modifier and Type	Method and Description
static org.eclipse.microprofile.openapi.models.Components	components(org.eclipse.microprofile.openapi.models.OpenAPI openApi) Gets the Components from the OAI model.
static String	nameFromRef(String ref) Returns the name component of the ref.
static boolean	operationHasParameter(org.eclipse.microprofile.openapi.models.Operation operation, String name) Returns true if the given operation has a parameter with the given name.
static boolean	parameterHasSchema(org.eclipse.microprofile.openapi.models.parameters.Parameter parameter) Returns true only if the given Parameter has a schema defined for it.
static org.eclipse.microprofile.openapi.models.Paths	paths(OpenAPIImpl openApi) Gets the Paths from the OAI model.
static boolean	requestBodyHasSchema(org.eclipse.microprofile.openapi.models.parameters.RequestBody requestBody) Returns true only if the given RequestBody has a schema defined for it.
static org.eclipse.microprofile.openapi.models.responses.APIResponses	responses(org.eclipse.microprofile.openapi.models.Operation operation) Gets the APIResponses child model from the given operation.
static void	setParameterSchema(org.eclipse.microprofile.openapi.models.parameters.Parameter parameter, org.eclipse.microprofile.openapi.models.media.Schema schema) Sets the given Schema on the given Parameter.
static void	setRequestBodySchema(org.eclipse.microprofile.openapi.models.parameters.RequestBody requestBody, org.eclipse.microprofile.openapi.models.media.Schema schema, String[] mediaTypes) Sets the given Schema on the given RequestBody.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

components

public static org.eclipse.microprofile.openapi.models.Components components(org.eclipse.microprofile.openapi.models.OpenAPI openApi)

Gets the Components from the OAI model. If it doesn't exist, creates it.

Parameters:

openApi -

paths

public static org.eclipse.microprofile.openapi.models.Paths paths(OpenAPIImpl openApi)

Gets the Paths from the OAI model. If it doesn't exist, creates it.

Parameters:

openApi -

responses

public static org.eclipse.microprofile.openapi.models.responses.APIResponses responses(org.eclipse.microprofile.openapi.models.Operation operation)

Gets the APIResponses child model from the given operation. If it's null then it will be created and returned.

Parameters:

operation -

parameterHasSchema

public static boolean parameterHasSchema(org.eclipse.microprofile.openapi.models.parameters.Parameter parameter)

Returns true only if the given Parameter has a schema defined for it. A schema can be defined either via the parameter's "schema" property, or any "content.*.schema" property.

Parameters:

parameter -

setParameterSchema

public static void setParameterSchema(org.eclipse.microprofile.openapi.models.parameters.Parameter parameter,
                                      org.eclipse.microprofile.openapi.models.media.Schema schema)

Sets the given Schema on the given Parameter. This is tricky because the paramater may EITHER have a schema property or it may have a Content child which itself has zero or more MediaType children which will contain the Schema. The OpenAPI specification requires that a parameter have *either* a schema or a content, but not both.

Parameters:

parameter -

schema -

requestBodyHasSchema

public static boolean requestBodyHasSchema(org.eclipse.microprofile.openapi.models.parameters.RequestBody requestBody)

Returns true only if the given RequestBody has a schema defined for it. A schema would be found within the request body's Content/MediaType children.

Parameters:

requestBody -

setRequestBodySchema

public static void setRequestBodySchema(org.eclipse.microprofile.openapi.models.parameters.RequestBody requestBody,
                                        org.eclipse.microprofile.openapi.models.media.Schema schema,
                                        String[] mediaTypes)

Sets the given Schema on the given RequestBody.

Parameters:

requestBody -

schema -

mediaTypes -

operationHasParameter

public static boolean operationHasParameter(org.eclipse.microprofile.openapi.models.Operation operation,
                                            String name)

Returns true if the given operation has a parameter with the given name.

Parameters:

operation -

name -

nameFromRef

public static String nameFromRef(String ref)

Returns the name component of the ref.

Parameters:

ref -