Package com.adaptris.core.http.apache5

Class BranchingHttpRequestService

java.lang.Object

com.adaptris.core.ServiceImp

com.adaptris.core.http.apache5.HttpRequestServiceImpl

com.adaptris.core.http.apache5.BranchingHttpRequestService

All Implemented Interfaces:

AdaptrisComponent, ComponentLifecycle, ComponentLifecycleExtension, MessageEventGenerator, Service, StateManagedComponent

@ComponentProfile(summary="Make a HTTP(s) request to a remote server using the Apache HTTP Client",
                  tag="service,http,https,branching",
                  branchSelector=true,
                  metadata="adphttpresponse",
                  author="Adaptris Ltd",
                  since="4.1.0")
public class BranchingHttpRequestService
extends HttpRequestServiceImpl

Branch support for HTTP via interrogation of the HTTP status.

This service allows you to branch based on the HTTP status code returned by the web server. Use a specific StatusEvaluator to determine the appropriate value for AdaptrisMessage.setNextServiceId(String). It differs from wrapping HttpRequestService with a BranchingServiceEnabler as it allows you more fine-grained control based on HTTP status codes.

Note that this service just wraps a ApacheHttpProducer instance but doesn't expose all the possible settings available for the normal ApacheHttpProducer. If you need those features, than continue using the producer wrapped as a StandaloneProducer or StandaloneRequestor.

String parameters in this service will use the InterlokMessage.resolve(String) which allows you to specify metadata values as part of a constant string e.g. setUrl("%message{http_url}") will use the metadata value associated with the key http_url.

In the adapter configuration file this class is aliased as branching-http-request-service which is the preferred alternative to the fully qualified classname when building your configuration.

Field Summary

Fields inherited from class com.adaptris.core.ServiceImp

log

Constructor Summary

Constructors

Constructor	Description
BranchingHttpRequestService()
BranchingHttpRequestService(java.lang.String url)

Method Summary

Modifier and Type	Method	Description
void	doService(AdaptrisMessage msg)
java.lang.String	getDefaultServiceId()	Set the default service-id in the event that no matches are found (optional).
@NonNull java.util.List<StatusEvaluator>	getStatusMatches()	Set the nextServiceId based on these evaluators.
boolean	isBranching()
void	prepare()
void	setDefaultServiceId(java.lang.String defaultServiceId)	Set the default service-id in the event that no matches are found (optional).
void	setStatusMatches(@NonNull java.util.List<StatusEvaluator> statusMatches)	Set the nextServiceId based on these evaluators.

Methods inherited from class com.adaptris.core.http.apache5.HttpRequestServiceImpl

buildProducer, clientConfig, closeService, getAuthenticator, getClientConfig, getContentType, getMethod, getRequestHeaderProvider, getResponseHeaderHandler, getUrl, initService, setAuthenticator, setClientConfig, setContentType, setMethod, setRequestHeaderProvider, setResponseHeaderHandler, setUrl

Methods inherited from class com.adaptris.core.ServiceImp

changeState, close, continueOnFailure, createName, createQualifier, getContinueOnFail, getIsTrackingEndpoint, getUniqueId, init, isTrackingEndpoint, requestClose, requestInit, requestStart, requestStop, retrieveComponentState, setContinueOnFail, setIsTrackingEndpoint, setUniqueId, start, stop

Methods inherited from class java.lang.Object

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

Constructor Detail

BranchingHttpRequestService

public BranchingHttpRequestService()

BranchingHttpRequestService

public BranchingHttpRequestService(java.lang.String url)

Method Detail

prepare

public void prepare()
             throws CoreException

Specified by:

prepare in interface ComponentLifecycleExtension

Overrides:

prepare in class HttpRequestServiceImpl

Throws:

CoreException

isBranching

public boolean isBranching()

Specified by:

isBranching in interface Service

Overrides:

isBranching in class ServiceImp

doService

public void doService(AdaptrisMessage msg)
               throws ServiceException

Throws:

ServiceException

getStatusMatches

@NonNull
public @NonNull java.util.List<StatusEvaluator> getStatusMatches()

Set the nextServiceId based on these evaluators.

setStatusMatches

public void setStatusMatches(@NonNull
                             @NonNull java.util.List<StatusEvaluator> statusMatches)

Set the nextServiceId based on these evaluators.

getDefaultServiceId

public java.lang.String getDefaultServiceId()

Set the default service-id in the event that no matches are found (optional).

setDefaultServiceId

public void setDefaultServiceId(java.lang.String defaultServiceId)

Set the default service-id in the event that no matches are found (optional).