org.apache.camel.component.rest.swagger

Class RestSwaggerComponent

java.lang.Object

org.apache.camel.support.ServiceSupport

org.apache.camel.impl.DefaultComponent

org.apache.camel.component.rest.swagger.RestSwaggerComponent

All Implemented Interfaces:

org.apache.camel.CamelContextAware, org.apache.camel.Component, org.apache.camel.Service, org.apache.camel.ShutdownableService, org.apache.camel.StatefulService, org.apache.camel.SuspendableService

public final class RestSwaggerComponent
extends org.apache.camel.impl.DefaultComponent

An awesome REST component backed by Swagger specifications. Creates endpoints that connect to REST APIs defined by Swagger specification. This component delegates to other RestProducerFactory components to act as REST clients, but it configures them from Swagger specification. Client needs to point to operation that it wants to invoke via REST, provide any additional HTTP headers as headers in the Camel message, and any payload as the body of the incoming message.

Example usage using Java DSL:

 from(...).to("rest-swagger:http://petstore.swagger.io/v2/swagger.json#getPetById")
 

This relies on only one RestProducerFactory component being available to Camel, you can use specific, for instance preconfigured component by using the componentName endpoint property. For example using Undertow component in Java DSL:

 Component undertow = new UndertowComponent();
 undertow.setSslContextParameters(...);
 //...
 camelContext.addComponent("myUndertow", undertow);

 from(...).to("rest-swagger:http://petstore.swagger.io/v2/swagger.json#getPetById?componentName=myUndertow")
 

The most concise way of using this component would be to define it in the Camel context under a meaningful name, for example:

 Component petstore = new RestSwaggerComponent();
 petstore.setSpecificationUri("http://petstore.swagger.io/v2/swagger.json");
 petstore.setComponentName("undertow");
 //...
 camelContext.addComponent("petstore", petstore);

 from(...).to("petstore:getPetById")
 

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_BASE_PATH

Fields inherited from class org.apache.camel.support.ServiceSupport

shutdown, shuttingdown, started, starting, stopped, stopping, suspended, suspending

Constructor Summary

Constructors

Constructor and Description
RestSwaggerComponent()
RestSwaggerComponent(org.apache.camel.CamelContext context)

Method Summary

Modifier and Type	Method and Description
protected org.apache.camel.Endpoint	createEndpoint(String uri, String remaining, Map<String,Object> parameters)
String	getBasePath()
String	getComponentName()
String	getConsumes()
String	getHost()
String	getProduces()
URI	getSpecificationUri()
void	setBasePath(String basePath)
void	setComponentName(String componentName)
void	setConsumes(String consumes)
void	setHost(String host)
void	setProduces(String produces)
void	setSpecificationUri(URI specificationUri)

Methods inherited from class org.apache.camel.impl.DefaultComponent

afterConfiguration, createComponentConfiguration, createConfiguration, createEndpoint, doStart, doStop, getAndRemoveOrResolveReferenceParameter, getAndRemoveOrResolveReferenceParameter, getAndRemoveParameter, getAndRemoveParameter, getCamelContext, getExtension, getSupportedExtensions, ifStartsWithReturnRemainder, isResolvePropertyPlaceholders, preProcessUri, registerExtension, registerExtension, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceListParameter, resolveAndRemoveReferenceParameter, resolveAndRemoveReferenceParameter, setCamelContext, setProperties, setProperties, setResolvePropertyPlaceholders, useIntrospectionOnEndpoint, useRawUri, validateParameters, validateURI

Methods inherited from class org.apache.camel.support.ServiceSupport

doResume, doShutdown, doSuspend, getStatus, getVersion, isRunAllowed, isStarted, isStarting, isStopped, isStopping, isStoppingOrStopped, isSuspended, isSuspending, isSuspendingOrSuspended, resume, shutdown, start, stop, suspend

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_BASE_PATH

public static final String DEFAULT_BASE_PATH

See Also:

Constant Field Values

Constructor Detail

RestSwaggerComponent

public RestSwaggerComponent()

RestSwaggerComponent

public RestSwaggerComponent(org.apache.camel.CamelContext context)

Method Detail

getBasePath

public String getBasePath()

getComponentName

public String getComponentName()

getConsumes

public String getConsumes()

getHost

public String getHost()

getProduces

public String getProduces()

getSpecificationUri

public URI getSpecificationUri()

setBasePath

public void setBasePath(String basePath)

setComponentName

public void setComponentName(String componentName)

setConsumes

public void setConsumes(String consumes)

setHost

public void setHost(String host)

setProduces

public void setProduces(String produces)

setSpecificationUri

public void setSpecificationUri(URI specificationUri)

createEndpoint

protected org.apache.camel.Endpoint createEndpoint(String uri,
                                                   String remaining,
                                                   Map<String,Object> parameters)
                                            throws Exception

Specified by:

createEndpoint in class org.apache.camel.impl.DefaultComponent

Throws:

Exception