Package io.vertx.reactivex.ext.web.openapi.router

Class RouterBuilder

java.lang.Object

io.vertx.reactivex.ext.web.openapi.router.RouterBuilder

public class RouterBuilder
extends Object

Interface to build a Vert.x Web from an OpenAPI 3 contract.

The router is mounting its handlers in the following order:

1. RootHandler
in the order the root handlers were added to the RouterBuilder.
2. ValidationHandler
This handler is implementing the marker interface InputTrustHandler. Because of this, all handlers of type PLATFORM, SECURITY_POLICY, BODY and AUTHENTICATION must be mounted as root handlers if required.
3. UserHandler
The custom user handlers defined in the OpenAPIRoute in the same order as they are added to the route.
4. FailureHandler
The failure handlers defined in the OpenAPIRoute in the same order as they are added to the route.

NOTE: This class has been automatically generated from the original non RX-ified interface using Vert.x codegen.

Field Summary

Fields

Modifier and Type	Field	Description
static io.vertx.lang.rx.TypeArg<RouterBuilder>	__TYPE_ARG
static String	KEY_META_DATA_OPERATION
static String	KEY_META_DATA_VALIDATED_REQUEST

Constructor Summary

Constructors

Constructor	Description
RouterBuilder(RouterBuilder delegate)
RouterBuilder(Object delegate)

Method Summary

Modifier and Type	Method	Description
static RouterBuilder	create(Vertx vertx, OpenAPIContract contract)	Create a new RouterBuilder.
static RouterBuilder	create(Vertx vertx, OpenAPIContract contract, RequestExtractor extractor)	Create a new RouterBuilder.
Router	createRouter()	Construct a new router based on the related OpenAPI contract.
boolean	equals(Object o)
RouterBuilder	getDelegate()
OpenAPIRoute	getRoute(String operationId)	Access to a route defined in the contract with operationId
List<OpenAPIRoute>	getRoutes()
int	hashCode()
static RouterBuilder	newInstance(RouterBuilder arg)
RouterBuilder	rootHandler(Handler<RoutingContext> rootHandler)	Add global handler to be applied prior to being generated.
Security	security(String securitySchemeName)	Creates a new security scheme for the required .
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

__TYPE_ARG

public static final io.vertx.lang.rx.TypeArg<RouterBuilder> __TYPE_ARG

KEY_META_DATA_OPERATION

public static final String KEY_META_DATA_OPERATION

See Also:

Constant Field Values

KEY_META_DATA_VALIDATED_REQUEST

public static final String KEY_META_DATA_VALIDATED_REQUEST

See Also:

Constant Field Values

Constructor Detail

RouterBuilder

public RouterBuilder(RouterBuilder delegate)

RouterBuilder

public RouterBuilder(Object delegate)

Method Detail

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

getDelegate

public RouterBuilder getDelegate()

create

public static RouterBuilder create(Vertx vertx,
                                   OpenAPIContract contract)

Create a new RouterBuilder. Like create(io.vertx.reactivex.core.Vertx, io.vertx.reactivex.openapi.contract.OpenAPIContract) but uses a default implementation for the extractor.

Parameters:

vertx - the related Vert.x instance

contract - the contract that describes the endpoint

Returns:

an instance of RouterBuilder

create

public static RouterBuilder create(Vertx vertx,
                                   OpenAPIContract contract,
                                   RequestExtractor extractor)

Create a new RouterBuilder.

Parameters:

vertx - the related Vert.x instance

contract - the contract that describes the endpoint

extractor - the extractor is used to extract and transform the parameters and body of the related request in a format that can be validated by the RequestValidator.

Returns:

an instance of RouterBuilder

getRoute

public OpenAPIRoute getRoute(String operationId)

Access to a route defined in the contract with operationId

Parameters:

operationId - the id of the operation

Returns:

the requested route, or null if the passed operationId doesn't exist.

getRoutes

public List<OpenAPIRoute> getRoutes()

Returns:

all routes defined in the contract

rootHandler

public RouterBuilder rootHandler(Handler<RoutingContext> rootHandler)

Add global handler to be applied prior to being generated.

Parameters:

rootHandler - the root handler to add

Returns:

self

security

public Security security(String securitySchemeName)

Creates a new security scheme for the required .

Parameters:

securitySchemeName -

Returns:

a security scheme.

createRouter

public Router createRouter()

Construct a new router based on the related OpenAPI contract.

Returns:

a Router based on the related OpenAPI contract.

newInstance

public static RouterBuilder newInstance(RouterBuilder arg)