de.iip_ecosphere.platform.transport

Class TransportFactory

java.lang.Object

de.iip_ecosphere.platform.transport.TransportFactory

public class TransportFactory
extends Object

A factory for creating transport connector instances. This factory shall ensure that the entire platform runs with the same connector instances, however, provides at the same time the flexibility to exchange the creation process. As there is no default connector in this artifact anymore, the factory must be configured by instances of TransportFactory.ConnectorCreator before use.

Author:

Holger Eichelberger, SSE

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	TransportFactory.ConnectorCreator Defines an internal factory implementation to create connectors.

Field Summary

Fields

Modifier and Type	Field and Description
private static TransportFactory.ConnectorCreator	dmCreator
private static boolean	initialized
private static TransportFactory.ConnectorCreator	ipcCreator
private static TransportFactory.ConnectorCreator	mainCreator

Constructor Summary

Constructors

Constructor and Description
TransportFactory()

Method Summary

Modifier and Type	Method and Description
static TransportConnector	createConnector() Creates a connector instance.
static TransportConnector	createDirectMemoryConnector() Creates a direct memory transfer connector instance.
static TransportConnector	createIpcConnector() Creates an inter-process connector.
static String	getConnectorName() Returns the descriptive name of the main connector.
private static TransportFactory.ConnectorCreator	getCreator(TransportFactory.ConnectorCreator creator, TransportFactory.ConnectorCreator dflt) Returns either creator if not null or dflt.
private static void	initialize() Initializes the factory if not already done.
static TransportFactory.ConnectorCreator	setDmImplementation(TransportFactory.ConnectorCreator inst) Changes the direct memory factory implementation.
static TransportFactory.ConnectorCreator	setIpcImplementation(TransportFactory.ConnectorCreator inst) Changes the inter-process factory implementation.
static TransportFactory.ConnectorCreator	setMainImplementation(TransportFactory.ConnectorCreator inst) Changes the main factory implementation.

Methods inherited from class java.lang.Object

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

Field Detail

mainCreator

private static TransportFactory.ConnectorCreator mainCreator

ipcCreator

private static TransportFactory.ConnectorCreator ipcCreator

dmCreator

private static TransportFactory.ConnectorCreator dmCreator

initialized

private static boolean initialized

Constructor Detail

TransportFactory

public TransportFactory()

Method Detail

setMainImplementation

public static TransportFactory.ConnectorCreator setMainImplementation(TransportFactory.ConnectorCreator inst)

Changes the main factory implementation. May be replaced by an injection-based mechanism, so far required for testing.

Parameters:

inst - the factory implementation instance (ignored if null)

Returns:

the factory implementation instance before calling this method

setIpcImplementation

public static TransportFactory.ConnectorCreator setIpcImplementation(TransportFactory.ConnectorCreator inst)

Changes the inter-process factory implementation. May be replaced by an injection-based mechanism, so far required for testing.

Parameters:

inst - the factory implementation instance (ignored if null)

Returns:

the factory implementation instance before calling this method

setDmImplementation

public static TransportFactory.ConnectorCreator setDmImplementation(TransportFactory.ConnectorCreator inst)

Changes the direct memory factory implementation. May be replaced by an injection-based mechanism, so far required for testing.

Parameters:

inst - the factory implementation instance (ignored if null)

Returns:

the factory implementation instance before calling this method

initialize

private static void initialize()

Initializes the factory if not already done.

getCreator

private static TransportFactory.ConnectorCreator getCreator(TransportFactory.ConnectorCreator creator,
                                                            TransportFactory.ConnectorCreator dflt)

Returns either creator if not null or dflt.

Parameters:

creator - the primary creator to return (if not null)

dflt - the default creator to return if the primary creator is not present

Returns:

the creator, either creator or dflt

createConnector

public static TransportConnector createConnector()

Creates a connector instance.

Returns:

the created connector instance

createIpcConnector

public static TransportConnector createIpcConnector()

Creates an inter-process connector.

Returns:

the created connector instance

createDirectMemoryConnector

public static TransportConnector createDirectMemoryConnector()

Creates a direct memory transfer connector instance.

Returns:

the direct memory connector instance

getConnectorName

public static String getConnectorName()

Returns the descriptive name of the main connector.

Returns:

the descriptive name