Package io.helidon.openapi

Class SEOpenAPISupportBuilder

java.lang.Object

io.helidon.openapi.OpenAPISupport.Builder

io.helidon.openapi.SEOpenAPISupportBuilder

All Implemented Interfaces:

Builder<OpenAPISupport>, Supplier<OpenAPISupport>

public final class SEOpenAPISupportBuilder
extends OpenAPISupport.Builder

Builds OpenAPISupport in a Helidon SE environment.

The builder mostly delegates to an instance of Helidon's OpenAPIConfigImpl.Builder which in turn prepares a smallrye OpenApiConfig which is what the smallrye implementation uses to control its behavior.

Field Summary

Fields inherited from class io.helidon.openapi.OpenAPISupport.Builder

CONFIG_KEY

Constructor Summary

Constructors

Constructor	Description
SEOpenAPISupportBuilder()

Method Summary

Modifier and Type	Method	Description
SEOpenAPISupportBuilder	addOperationServer(String operationID, String operationServer)	Adds an operation server for a given operation ID.
SEOpenAPISupportBuilder	addPathServer(String path, String pathServer)	Adds a path server for a given path.
SEOpenAPISupportBuilder	config(Config config)	Set various builder attributes from the specified openapi Config object.
SEOpenAPISupportBuilder	filter(String className)	Set the app-provided OpenAPI model filter class.
SEOpenAPISupportBuilder	helidonConfig(Config config)	Deprecated.
org.jboss.jandex.IndexView	indexView()	Returns the Jandex IndexView containing annotated endpoint classes.
SEOpenAPISupportBuilder	modelReader(String className)	Sets the app-provided model reader class.
io.smallrye.openapi.api.OpenApiConfig	openAPIConfig()	Returns the smallrye OpenApiConfig instance describing the set-up that will govern the smallrye OpenAPI behavior.
SEOpenAPISupportBuilder	servers(String serverList)	Sets the servers which offer the endpoints in the OpenAPI document.

Methods inherited from class io.helidon.openapi.OpenAPISupport.Builder

build, staticFile, validate, webContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.helidon.common.Builder

get

Constructor Detail

SEOpenAPISupportBuilder

public SEOpenAPISupportBuilder()

Method Detail

helidonConfig

@Deprecated
public SEOpenAPISupportBuilder helidonConfig(Config config)

Deprecated.

Set various builder attributes from the specified Config object.

The Config object can specify "openapi".web-context and "openapi".static-file in addition to settings supported by OpenAPIConfigImpl.Builder.

Overrides:

helidonConfig in class OpenAPISupport.Builder

Parameters:

config - the Config object possibly containing settings

Returns:

updated builder instance

Throws:

NullPointerException - if the provided Config is null

config

public SEOpenAPISupportBuilder config(Config config)

Set various builder attributes from the specified openapi Config object.

The Config object can specify web-context and static-file in addition to settings supported by OpenAPIConfigImpl.Builder.

Overrides:

config in class OpenAPISupport.Builder

Parameters:

config - the openapi Config object possibly containing settings

Returns:

updated builder instance

Throws:

NullPointerException - if the provided Config is null

openAPIConfig

public io.smallrye.openapi.api.OpenApiConfig openAPIConfig()

Description copied from class: OpenAPISupport.Builder

Returns the smallrye OpenApiConfig instance describing the set-up that will govern the smallrye OpenAPI behavior.

Specified by:

openAPIConfig in class OpenAPISupport.Builder

Returns:

OpenApiConfig conveying how OpenAPI should behave

indexView

public org.jboss.jandex.IndexView indexView()

Description copied from class: OpenAPISupport.Builder

Returns the Jandex IndexView containing annotated endpoint classes.

Specified by:

indexView in class OpenAPISupport.Builder

Returns:

IndexView containing endpoint classes

modelReader

public SEOpenAPISupportBuilder modelReader(String className)

Sets the app-provided model reader class.

Parameters:

className - name of the model reader class

Returns:

updated builder instance

filter

public SEOpenAPISupportBuilder filter(String className)

Set the app-provided OpenAPI model filter class.

Parameters:

className - name of the filter class

Returns:

updated builder instance

servers

public SEOpenAPISupportBuilder servers(String serverList)

Sets the servers which offer the endpoints in the OpenAPI document.

Parameters:

serverList - comma-separated list of servers

Returns:

updated builder instance

addOperationServer

public SEOpenAPISupportBuilder addOperationServer(String operationID,
                                                  String operationServer)

Adds an operation server for a given operation ID.

Parameters:

operationID - operation ID to which the server corresponds

operationServer - name of the server to add for this operation

Returns:

updated builder instance

addPathServer

public SEOpenAPISupportBuilder addPathServer(String path,
                                             String pathServer)

Adds a path server for a given path.

Parameters:

path - path to which the server corresponds

pathServer - name of the server to add for this path

Returns:

updated builder instance