Package io.helidon.openapi

Class OpenAPISupport

java.lang.Object

io.helidon.openapi.OpenAPISupport

All Implemented Interfaces:

Service

public class OpenAPISupport
extends Object
implements Service

Provides an endpoint and supporting logic for returning an OpenAPI document that describes the endpoints handled by the server.

The server can use the OpenAPISupport.Builder to set OpenAPI-related attributes. If the server uses none of these builder methods and does not provide a static openapi file, then the /openapi endpoint responds with a nearly-empty OpenAPI document.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	OpenAPISupport.Builder	Fluent API builder for OpenAPISupport.

Field Summary

Fields

Modifier and Type	Field	Description
static MediaType	DEFAULT_RESPONSE_MEDIA_TYPE	Default media type used in responses in absence of incoming Accept header.
static String	DEFAULT_WEB_CONTEXT	Default path for serving the OpenAPI document.

Method Summary

Modifier and Type	Method	Description
static OpenAPISupport.Builder	builder()	Creates a new OpenAPISupport.Builder for OpenAPISupport using defaults.
void	configureEndpoint(Routing.Rules rules)	Sets up the OpenAPI endpoint by adding routing to the specified rules set.
static OpenAPISupport	create()	Creates a new OpenAPISupport instance using defaults.
static OpenAPISupport	create(Config config)	Creates a new OpenAPISupport instance using the 'openapi' portion of the provided Config object.
void	update(Routing.Rules rules)	Updates Routing.Rules with handlers representing this service.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_WEB_CONTEXT

public static final String DEFAULT_WEB_CONTEXT

Default path for serving the OpenAPI document.

See Also:

Constant Field Values

DEFAULT_RESPONSE_MEDIA_TYPE

public static final MediaType DEFAULT_RESPONSE_MEDIA_TYPE

Default media type used in responses in absence of incoming Accept header.

Method Detail

update

public void update(Routing.Rules rules)

Description copied from interface: Service

Updates Routing.Rules with handlers representing this service.

Specified by:

update in interface Service

Parameters:

rules - a routing rules to update

configureEndpoint

public void configureEndpoint(Routing.Rules rules)

Sets up the OpenAPI endpoint by adding routing to the specified rules set.

Parameters:

rules - routing rules to be augmented with OpenAPI endpoint

builder

public static OpenAPISupport.Builder builder()

Creates a new OpenAPISupport.Builder for OpenAPISupport using defaults.

Returns:

new Builder

create

public static OpenAPISupport create()

Creates a new OpenAPISupport instance using defaults.

Returns:

new OpenAPISUpport

create

public static OpenAPISupport create(Config config)

Creates a new OpenAPISupport instance using the 'openapi' portion of the provided Config object.

Parameters:

config - Config object containing OpenAPI-related settings

Returns:

new OpenAPISupport instance created using the helidonConfig settings