Package com.adaptris.core.sap.jco3.rfc.services

Class RfcServiceList

java.lang.Object

java.util.AbstractCollection<Service>

com.adaptris.core.ServiceCollectionImp

com.adaptris.core.ServiceListBase

com.adaptris.core.ServiceList

com.adaptris.core.sap.jco3.rfc.services.RfcServiceList

All Implemented Interfaces:

AdaptrisComponent, ComponentLifecycle, ComponentLifecycleExtension, ConfigComment, ConnectedService, EventHandlerAware, com.adaptris.core.licensing.LicensedComponent, MessageEventGenerator, Service, ServiceCollection, StateManagedComponent, Iterable<Service>, Collection<Service>, List<Service>

@ComponentProfile(summary="Wrap a RFC Connection for use by embedded services",
                  tag="service,sap,rfc",
                  recommended={ConfiguredRfcConnection.class,DynamicRfcConnection.class})
public class RfcServiceList
extends ServiceList
implements com.adaptris.core.licensing.LicensedComponent, ConnectedService

Implementation of ServiceCollection that creates a JCoDestination instance at the start of the execution of the service list and stores it in object metadata.

Other than the creation of the JCoDestination at the start of execution, all other behaviour is the same as ServiceList which this class extends.

The rationale behind this service collection implementation is to allow multiple producers that share the same underlying RFC configuration. Embedded StandaloneProducer and StandaloneRequestor implementations do not need to have RfcConnections associated with them as they will be able to use the JCoDestination from metadata. For a stateful RFC call sequence you can then configure the first and last services in this service list to be StatefulSessionStart and StatefulSessionEnd respectively. Between StatefulSessionStart and StatefulSessionEnd the same underlying connection will be used for all function calls.

See Also:

• RfcConstants.OBJ_METADATA_DESTINATION_KEY
• StatefulSessionStart
• StatefulSessionEnd

In the adapter configuration file this class is aliased as sapjco3-rfc-service-list which is the preferred alternative to the fully qualified classname when building your configuration.

License Required: ENTERPRISE

Field Summary

Fields inherited from class com.adaptris.core.ServiceCollectionImp

eventHandler, log

Constructor Summary

Constructors

Constructor	Description
RfcServiceList()
RfcServiceList(Collection<Service> serviceList)

Method Summary

Modifier and Type	Method	Description
protected void	applyServices(AdaptrisMessage msg)
protected void	doClose()
protected void	doInit()
protected void	doStart()
protected void	doStop()
AdaptrisConnection	getConnection()
boolean	isEnabled(com.adaptris.core.licensing.License license)
void	prepare()
void	setConnection(AdaptrisConnection c)	Set the connection that will be used by all RfcProducer instances in this service list.

Methods inherited from class com.adaptris.core.ServiceList

getAllowForwardSearch, setAllowForwardSearch

Methods inherited from class com.adaptris.core.ServiceListBase

haltProcessing

Methods inherited from class com.adaptris.core.ServiceCollectionImp

add, add, addAll, addAll, addService, changeState, clear, close, continueOnFailure, createName, createQualifier, doService, enabled, enforceRequirements, enforceRequirements, get, getComments, getContinueOnFail, getEnabled, getIsTrackingEndpoint, getOutOfStateHandler, getRestartAffectedServiceOnException, getServices, getUniqueId, handleException, indexOf, init, isBranching, isTrackingEndpoint, iterator, lastIndexOf, listIterator, listIterator, registerEventHandler, remove, requestClose, requestInit, requestStart, requestStop, retrieveComponentState, set, setComments, setContinueOnFail, setEnabled, setIsTrackingEndpoint, setOutOfStateHandler, setRestartAffectedServiceOnException, setServices, setUniqueId, size, start, stop, subList, withServices

Methods inherited from class java.util.AbstractCollection

contains, containsAll, isEmpty, remove, removeAll, retainAll, toArray, toArray, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.adaptris.core.AdaptrisComponent

getUniqueId

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface com.adaptris.core.ComponentLifecycle

close, init, start, stop

Methods inherited from interface com.adaptris.core.ConfigComment

getComments, setComments

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

contains, containsAll, equals, hashCode, isEmpty, remove, removeAll, replaceAll, retainAll, sort, spliterator, toArray, toArray

Methods inherited from interface com.adaptris.core.MessageEventGenerator

createName, createQualifier, isTrackingEndpoint

Methods inherited from interface com.adaptris.core.Service

continueOnFailure, doService, enabled, isBranching, setUniqueId

Methods inherited from interface com.adaptris.core.StateManagedComponent

changeState, requestClose, requestInit, requestStart, requestStop, retrieveComponentState

Constructor Details

RfcServiceList

public RfcServiceList()

RfcServiceList

public RfcServiceList(Collection<Service> serviceList)

Method Details

applyServices

protected void applyServices(AdaptrisMessage msg)
                      throws ServiceException

Overrides:

applyServices in class ServiceList

Throws:

ServiceException

doInit

protected void doInit()
               throws CoreException

Overrides:

doInit in class ServiceList

Throws:

CoreException

doStart

protected void doStart()
                throws CoreException

Overrides:

doStart in class ServiceListBase

Throws:

CoreException

doStop

protected void doStop()

Overrides:

doStop in class ServiceListBase

doClose

protected void doClose()

Overrides:

doClose in class ServiceListBase

prepare

public void prepare()
             throws CoreException

Specified by:

prepare in interface ComponentLifecycleExtension

Overrides:

prepare in class ServiceCollectionImp

Throws:

CoreException

isEnabled

public boolean isEnabled(com.adaptris.core.licensing.License license)

Specified by:

isEnabled in interface com.adaptris.core.licensing.LicensedComponent

getConnection

public AdaptrisConnection getConnection()

Specified by:

getConnection in interface ConnectedService

setConnection

public void setConnection(AdaptrisConnection c)

Set the connection that will be used by all RfcProducer instances in this service list.

So that we can use SharedConnection, this is marked as a standard AdaptrisConnection, however you should only use a concrete RfcConnection instance or a SharedConnection.

*

Specified by:

setConnection in interface ConnectedService