OpenAPI3RouterFactory (Vert.x RxJava API 4.0.0.Beta2 API)

java.lang.Object
- io.vertx.rxjava.ext.web.api.contract.openapi3.OpenAPI3RouterFactory

All Implemented Interfaces:

RouterFactory<io.swagger.v3.oas.models.OpenAPI>
```
public class OpenAPI3RouterFactory
extends Object
implements RouterFactory<io.swagger.v3.oas.models.OpenAPI>
```
Interface for OpenAPI3RouterFactory.
To add an handler, use addHandlerByOperationId(java.lang.String, io.vertx.core.Handler<io.vertx.rxjava.ext.web.RoutingContext>)
Usage example:
```
 OpenAPI3RouterFactory.create(vertx, "src/resources/spec.yaml", asyncResult -> {
  if (!asyncResult.succeeded()) {
     // IO failure or spec invalid else {
     OpenAPI3RouterFactory routerFactory = asyncResult.result();
     routerFactory.addHandlerByOperationId("operation_id", routingContext -> {
        // Do something
     }, routingContext -> {
        // Do something with failure handler
     });
     Router router = routerFactory.getRouter();
  }
 });
 }
 
```
Handlers are loaded in this order:
1. Body handler (Customizable with
2. Custom global handlers configurable with
3. Global security handlers defined in upper spec level
4. Operation specific security handlers
5. Generated validation handler
6. User handlers or "Not implemented" handler
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 and Description

static TypeArg<OpenAPI3RouterFactory> __TYPE_ARG

Fields
Modifier and Type	Field and Description
`static TypeArg<OpenAPI3RouterFactory>`	`__TYPE_ARG`

Constructor Summary

Constructors
Constructor and Description

OpenAPI3RouterFactory(Object delegate)

OpenAPI3RouterFactory(io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory delegate)

Constructors
Constructor and Description
`OpenAPI3RouterFactory(Object delegate)`
`OpenAPI3RouterFactory(io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory delegate)`

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`OpenAPI3RouterFactory`	`addFailureHandlerByOperationId(String operationId, io.vertx.core.Handler<RoutingContext> failureHandler)` Deprecated.
`RouterFactory`	`addGlobalHandler(io.vertx.core.Handler<RoutingContext> globalHandler)` Deprecated.
`OpenAPI3RouterFactory`	`addHandlerByOperationId(String operationId, io.vertx.core.Handler<RoutingContext> handler)` Deprecated.
`RouterFactory`	`addSecurityHandler(String securitySchemaName, io.vertx.core.Handler<RoutingContext> handler)` Deprecated.
`OpenAPI3RouterFactory`	`addSecuritySchemaScopeValidator(String securitySchemaName, String scopeName, io.vertx.core.Handler<RoutingContext> handler)` Deprecated.
`static void`	`create(Vertx vertx, String url)` Deprecated.
`static void`	`create(Vertx vertx, String url, io.vertx.core.Handler<io.vertx.core.AsyncResult<OpenAPI3RouterFactory>> handler)` Deprecated.
`static void`	`create(Vertx vertx, String url, List<io.vertx.core.json.JsonObject> auth)` Deprecated.
`static void`	`create(Vertx vertx, String url, List<io.vertx.core.json.JsonObject> auth, io.vertx.core.Handler<io.vertx.core.AsyncResult<OpenAPI3RouterFactory>> handler)` Deprecated.
`boolean`	`equals(Object o)`
`io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory`	`getDelegate()`
`io.vertx.ext.web.api.contract.RouterFactoryOptions`	`getOptions()` Deprecated.
`Router`	`getRouter()` Deprecated.
`io.vertx.core.Handler<RoutingContext>`	`getValidationFailureHandler()` Deprecated.
`int`	`hashCode()`
`OpenAPI3RouterFactory`	`mountOperationToEventBus(String operationId, String address)` Deprecated.
`OpenAPI3RouterFactory`	`mountServiceFromTag(String tag, String address)` Deprecated.
`OpenAPI3RouterFactory`	`mountServicesFromExtensions()` Deprecated.
`static OpenAPI3RouterFactory`	`newInstance(io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory arg)`
`static rx.Single<OpenAPI3RouterFactory>`	`rxCreate(Vertx vertx, String url)` Deprecated.
`static rx.Single<OpenAPI3RouterFactory>`	`rxCreate(Vertx vertx, String url, List<io.vertx.core.json.JsonObject> auth)` Deprecated.
`RouterFactory`	`setBodyHandler(BodyHandler bodyHandler)` Deprecated.
`RouterFactory`	`setExtraOperationContextPayloadMapper(Function<RoutingContext,io.vertx.core.json.JsonObject> extraOperationContextPayloadMapper)` Deprecated.
`RouterFactory`	`setNotImplementedFailureHandler(io.vertx.core.Handler<RoutingContext> notImplementedFailureHandler)` Deprecated.
`RouterFactory`	`setOptions(io.vertx.ext.web.api.contract.RouterFactoryOptions options)` Deprecated.
`RouterFactory`	`setValidationFailureHandler(io.vertx.core.Handler<RoutingContext> validationFailureHandler)` Deprecated.
`String`	`toString()`

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface io.vertx.rxjava.ext.web.api.contract.RouterFactory
newInstance, newInstance

- Field Detail
  - __TYPE_ARG
```
public static final TypeArg<OpenAPI3RouterFactory> __TYPE_ARG
```
- Constructor Detail
  - OpenAPI3RouterFactory
```
public OpenAPI3RouterFactory(io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory delegate)
```
  - OpenAPI3RouterFactory
```
public OpenAPI3RouterFactory(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 io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory getDelegate()
```
    Specified by:
    
    getDelegate in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
  - addSecurityHandler
```
@Deprecated
public RouterFactory addSecurityHandler(String securitySchemaName,
                                                    io.vertx.core.Handler<RoutingContext> handler)
```
    Deprecated.
    
    Mount to paths that have to follow a security schema a security handler
    
    Specified by:
    
    addSecurityHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    securitySchemaName -
    
    handler -
    
    Returns:
  - setOptions
```
@Deprecated
public RouterFactory setOptions(io.vertx.ext.web.api.contract.RouterFactoryOptions options)
```
    Deprecated.
    
    Set options of router factory. For more info
    
    Specified by:
    
    setOptions in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    options -
    
    Returns:
  - getOptions
```
@Deprecated
public io.vertx.ext.web.api.contract.RouterFactoryOptions getOptions()
```
    Deprecated.
    
    Get options of router factory. For more info
    
    Specified by:
    
    getOptions in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Returns:
  - getRouter
```
@Deprecated
public Router getRouter()
```
    Deprecated.
    
    Construct a new router based on spec. It will fail if you are trying to mount a spec with security schemes without assigned handlers
    Note: Router is constructed in this function, so it will be respected the path definition ordering.
    
    Specified by:
    
    getRouter in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Returns:
  - getValidationFailureHandler
```
@Deprecated
public io.vertx.core.Handler<RoutingContext> getValidationFailureHandler()
```
    Deprecated.
    
    Specified by:
    
    getValidationFailureHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Returns:
  - setValidationFailureHandler
```
@Deprecated
public RouterFactory setValidationFailureHandler(io.vertx.core.Handler<RoutingContext> validationFailureHandler)
```
    Deprecated.
    
    Set default validation failure handler. You can enable/disable this feature from
    
    Specified by:
    
    setValidationFailureHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    validationFailureHandler -
    
    Returns:
    
    this object
  - setNotImplementedFailureHandler
```
@Deprecated
public RouterFactory setNotImplementedFailureHandler(io.vertx.core.Handler<RoutingContext> notImplementedFailureHandler)
```
    Deprecated.
    
    Set not implemented failure handler. It's called when you don't define an handler for a specific operation. You can enable/disable this feature from
    
    Specified by:
    
    setNotImplementedFailureHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    notImplementedFailureHandler -
    
    Returns:
    
    this object
  - setBodyHandler
```
@Deprecated
public RouterFactory setBodyHandler(BodyHandler bodyHandler)
```
    Deprecated.
    
    Supply your own BodyHandler if you would like to control body limit, uploads directory and deletion of uploaded files
    
    Specified by:
    
    setBodyHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    bodyHandler -
    
    Returns:
    
    self
  - addGlobalHandler
```
@Deprecated
public RouterFactory addGlobalHandler(io.vertx.core.Handler<RoutingContext> globalHandler)
```
    Deprecated.
    
    Add global handler to be applied prior to Router being generated.
    Please note that you should not add a body handler inside that list. If you want to modify the body handler, please use
    
    Specified by:
    
    addGlobalHandler in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    globalHandler -
    
    Returns:
    
    this object
  - setExtraOperationContextPayloadMapper
```
@Deprecated
public RouterFactory setExtraOperationContextPayloadMapper(Function<RoutingContext,io.vertx.core.json.JsonObject> extraOperationContextPayloadMapper)
```
    Deprecated.
    
    When set, this function is called while creating the payload of OperationRequest
    
    Specified by:
    
    setExtraOperationContextPayloadMapper in interface RouterFactory<io.swagger.v3.oas.models.OpenAPI>
    
    Parameters:
    
    extraOperationContextPayloadMapper -
    
    Returns:
  - addSecuritySchemaScopeValidator
```
@Deprecated
public OpenAPI3RouterFactory addSecuritySchemaScopeValidator(String securitySchemaName,
                                                                         String scopeName,
                                                                         io.vertx.core.Handler<RoutingContext> handler)
```
    Deprecated.
    
    Add a particular scope validator. The main security schema will not be called if a specific scope validator is configured
    
    Parameters:
    
    securitySchemaName -
    
    scopeName -
    
    handler -
    
    Returns:
    
    this factory
  - addHandlerByOperationId
```
@Deprecated
public OpenAPI3RouterFactory addHandlerByOperationId(String operationId,
                                                                 io.vertx.core.Handler<RoutingContext> handler)
```
    Deprecated.
    
    Add an handler by operation_id field in Operation object
    
    Parameters:
    
    operationId -
    
    handler -
    
    Returns:
    
    this factory
  - addFailureHandlerByOperationId
```
@Deprecated
public OpenAPI3RouterFactory addFailureHandlerByOperationId(String operationId,
                                                                        io.vertx.core.Handler<RoutingContext> failureHandler)
```
    Deprecated.
    
    Add a failure handler by operation_id field in Operation object
    
    Parameters:
    
    operationId -
    
    failureHandler -
    
    Returns:
    
    this factory
  - mountOperationToEventBus
```
@Deprecated
public OpenAPI3RouterFactory mountOperationToEventBus(String operationId,
                                                                  String address)
```
    Deprecated.
    
    Specify to route an incoming request for specified operation id to a Web Api Service mounted at the specified address on event bus. Please give a look at vertx-web-api-service documentation for more informations
    
    Parameters:
    
    operationId -
    
    address -
    
    Returns:
    
    this factory
  - mountServiceFromTag
```
@Deprecated
public OpenAPI3RouterFactory mountServiceFromTag(String tag,
                                                             String address)
```
    Deprecated.
    
    Specify to route an incoming request for all operations that contains the specified tag to a Web Api Service mounted at the specified address on event bus. The request is handled by the method that matches the operation id. Please give a look at vertx-web-api-service documentation for more informations
    
    Parameters:
    
    tag -
    
    address -
    
    Returns:
    
    this factory
  - mountServicesFromExtensions
```
@Deprecated
public OpenAPI3RouterFactory mountServicesFromExtensions()
```
    Deprecated.
    
    Introspect the OpenAPI spec to mount handlers for all operations that specifies a x-vertx-event-bus annotation. Please give a look at vertx-web-api-service documentation for more informations
    
    Returns:
    
    this factory
  - create
```
@Deprecated
public static void create(Vertx vertx,
                                      String url,
                                      io.vertx.core.Handler<io.vertx.core.AsyncResult<OpenAPI3RouterFactory>> handler)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
    
    handler - When specification is loaded, this handler will be called with AsyncResult
  - create
```
@Deprecated
public static void create(Vertx vertx,
                                      String url)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
  - rxCreate
```
@Deprecated
public static rx.Single<OpenAPI3RouterFactory> rxCreate(Vertx vertx,
                                                                    String url)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
    
    Returns:
  - create
```
@Deprecated
public static void create(Vertx vertx,
                                      String url,
                                      List<io.vertx.core.json.JsonObject> auth,
                                      io.vertx.core.Handler<io.vertx.core.AsyncResult<OpenAPI3RouterFactory>> handler)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
    
    auth - list of authorization values needed to access the remote url. Each item should be json representation of an
    
    handler - When specification is loaded, this handler will be called with AsyncResult
  - create
```
@Deprecated
public static void create(Vertx vertx,
                                      String url,
                                      List<io.vertx.core.json.JsonObject> auth)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
    
    auth - list of authorization values needed to access the remote url. Each item should be json representation of an
  - rxCreate
```
@Deprecated
public static rx.Single<OpenAPI3RouterFactory> rxCreate(Vertx vertx,
                                                                    String url,
                                                                    List<io.vertx.core.json.JsonObject> auth)
```
    Deprecated.
    
    Create a new OpenAPI3RouterFactory
    
    Parameters:
    
    vertx -
    
    url - location of your spec. It can be an absolute path, a local path or remote url (with HTTP protocol)
    
    auth - list of authorization values needed to access the remote url. Each item should be json representation of an
    
    Returns:
  - newInstance
```
public static OpenAPI3RouterFactory newInstance(io.vertx.ext.web.api.contract.openapi3.OpenAPI3RouterFactory arg)
```

Class OpenAPI3RouterFactory

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Methods inherited from interface io.vertx.rxjava.ext.web.api.contract.RouterFactory

Field Detail

__TYPE_ARG

Constructor Detail

OpenAPI3RouterFactory

OpenAPI3RouterFactory

Method Detail

toString

equals

hashCode

getDelegate

addSecurityHandler

setOptions

getOptions

getRouter

getValidationFailureHandler

setValidationFailureHandler

setNotImplementedFailureHandler

setBodyHandler

addGlobalHandler

setExtraOperationContextPayloadMapper

addSecuritySchemaScopeValidator

addHandlerByOperationId

addFailureHandlerByOperationId

mountOperationToEventBus

mountServiceFromTag

mountServicesFromExtensions

create

create

rxCreate

create

create

rxCreate

newInstance