com.helger.as2lib.session

Class AS2Session

java.lang.Object

com.helger.as2lib.session.AS2Session

All Implemented Interfaces:

IAS2Session, Serializable

@NotThreadSafe
public class AS2Session
extends Object
implements IAS2Session

Default implementation of IAS2Session

Author:

Philip Helger

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_ID_CERTIFICATE_FACTORY
static String	COMPONENT_ID_MESSAGE_PROCESSOR
static String	COMPONENT_ID_PARTNERSHIP_FACTORY
static boolean	DEFAULT_CRYPTO_SIGN_INCLUDE_CERTIFICATE_IN_BODY_PART
static boolean	DEFAULT_CRYPTO_VERIFY_USE_CERTIFICATE_IN_BODY_PART

Constructor Summary

Constructors

Constructor and Description
AS2Session() Constructor

Method Summary

Modifier and Type	Method and Description
void	addComponent(String sComponentID, IDynamicComponent aComponent) Registers a component to a specified ID.
com.helger.commons.collection.impl.ICommonsMap<String,IDynamicComponent>	getAllComponents() Return a map of component ID's to Component objects.
ICertificateFactory	getCertificateFactory() Short-cut method to retrieve a certificate factory.
IDynamicComponent	getComponent(String sComponentID) Gets the Component currently registered with an ID
Proxy	getHttpProxy() Get the optional HTTP/HTTPS proxy settings to be used for sending AS2 messages and asynchronous MDNs.
IMessageProcessor	getMessageProcessor() Short-cut method to retrieve a processor.
IPartnershipFactory	getPartnershipFactory() Short-cut method to retrieve a partner factory.
boolean	isCryptoSignIncludeCertificateInBodyPart()
boolean	isCryptoVerifyUseCertificateInBodyPart()
void	setCertificateFactory(ICertificateFactory aCertFactory)
void	setCryptoSignIncludeCertificateInBodyPart(boolean bCryptoSignIncludeCertificateInBodyPart) Settings flag, whether a the signing certificate should be included in the signed MIME body part or not.
void	setCryptoVerifyUseCertificateInBodyPart(boolean bCryptoVerifyUseCertificateInBodyPart) Settings flag, whether a contained certificate is used for message verification.
void	setHttpProxy(Proxy aHttpProxy) Set the optional HTTP/HTTPS proxy settings to be used for sending AS2 messages and asynchronous MDNs.
void	setMessageProcessor(IMessageProcessor aMsgProcessor)
void	setPartnershipFactory(IPartnershipFactory aPartnershipFactory)
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

COMPONENT_ID_CERTIFICATE_FACTORY

public static final String COMPONENT_ID_CERTIFICATE_FACTORY

See Also:

Constant Field Values

COMPONENT_ID_PARTNERSHIP_FACTORY

public static final String COMPONENT_ID_PARTNERSHIP_FACTORY

See Also:

Constant Field Values

COMPONENT_ID_MESSAGE_PROCESSOR

public static final String COMPONENT_ID_MESSAGE_PROCESSOR

See Also:

Constant Field Values

DEFAULT_CRYPTO_SIGN_INCLUDE_CERTIFICATE_IN_BODY_PART

public static final boolean DEFAULT_CRYPTO_SIGN_INCLUDE_CERTIFICATE_IN_BODY_PART

See Also:

Constant Field Values

DEFAULT_CRYPTO_VERIFY_USE_CERTIFICATE_IN_BODY_PART

public static final boolean DEFAULT_CRYPTO_VERIFY_USE_CERTIFICATE_IN_BODY_PART

See Also:

Constant Field Values

Constructor Detail

AS2Session

public AS2Session()

Constructor

Method Detail

addComponent

public final void addComponent(@Nonnull @Nonempty
                               String sComponentID,
                               @Nonnull
                               IDynamicComponent aComponent)
                        throws ComponentDuplicateException

Description copied from interface: IAS2Session

Registers a component to a specified ID.

Specified by:

addComponent in interface IAS2Session

Parameters:

sComponentID - registers the component to this ID

aComponent - component to register

Throws:

ComponentDuplicateException - In case a component with the same ID is already present

See Also:

IDynamicComponent

setCertificateFactory

public void setCertificateFactory(@Nonnull
                                  ICertificateFactory aCertFactory)
                           throws ComponentDuplicateException

Throws:

ComponentDuplicateException

setPartnershipFactory

public void setPartnershipFactory(@Nonnull
                                  IPartnershipFactory aPartnershipFactory)
                           throws ComponentDuplicateException

Throws:

ComponentDuplicateException

setMessageProcessor

public void setMessageProcessor(@Nonnull
                                IMessageProcessor aMsgProcessor)
                         throws ComponentDuplicateException

Throws:

ComponentDuplicateException

getComponent

@Nonnull
public final IDynamicComponent getComponent(@Nonnull @Nonempty
                                                      String sComponentID)
                                               throws ComponentNotFoundException

Description copied from interface: IAS2Session

Gets the Component currently registered with an ID

Specified by:

getComponent in interface IAS2Session

Parameters:

sComponentID - ID to search for

Returns:

the component registered to the ID and never null.

Throws:

ComponentNotFoundException - If a component is not registered with the ID

getAllComponents

@Nonnull
 @ReturnsMutableCopy
public final com.helger.commons.collection.impl.ICommonsMap<String,IDynamicComponent> getAllComponents()

Description copied from interface: IAS2Session

Return a map of component ID's to Component objects.

Specified by:

getAllComponents in interface IAS2Session

Returns:

all registered components, mapped by ID

getCertificateFactory

@Nonnull
public final ICertificateFactory getCertificateFactory()
                                                          throws ComponentNotFoundException

Description copied from interface: IAS2Session

Short-cut method to retrieve a certificate factory.

Specified by:

getCertificateFactory in interface IAS2Session

Returns:

the currently registered CertificateFactory component

Throws:

ComponentNotFoundException - If a CertificateFactory component has not been registered

See Also:

ICertificateFactory, IDynamicComponent

getPartnershipFactory

@Nonnull
public final IPartnershipFactory getPartnershipFactory()
                                                          throws ComponentNotFoundException

Description copied from interface: IAS2Session

Short-cut method to retrieve a partner factory.

Specified by:

getPartnershipFactory in interface IAS2Session

Returns:

the currently registered PartnerFactory component

Throws:

ComponentNotFoundException - If a PartnerFactory component has not been registered

See Also:

IPartnershipFactory, IDynamicComponent

getMessageProcessor

@Nonnull
public final IMessageProcessor getMessageProcessor()
                                                      throws ComponentNotFoundException

Description copied from interface: IAS2Session

Short-cut method to retrieve a processor.

Specified by:

getMessageProcessor in interface IAS2Session

Returns:

the currently registered Processor component

Throws:

ComponentNotFoundException - If a Processor component has not been registered

See Also:

IMessageProcessor, IDynamicComponent

isCryptoSignIncludeCertificateInBodyPart

public boolean isCryptoSignIncludeCertificateInBodyPart()

Specified by:

isCryptoSignIncludeCertificateInBodyPart in interface IAS2Session

Returns:

true if the certificate used for signing a message should be included in the signed MIME body part or not. Defaults to true.

See Also:

IAS2Session.setCryptoSignIncludeCertificateInBodyPart(boolean)

setCryptoSignIncludeCertificateInBodyPart

public void setCryptoSignIncludeCertificateInBodyPart(boolean bCryptoSignIncludeCertificateInBodyPart)

Description copied from interface: IAS2Session

Settings flag, whether a the signing certificate should be included in the signed MIME body part or not.

Specified by:

setCryptoSignIncludeCertificateInBodyPart in interface IAS2Session

Parameters:

bCryptoSignIncludeCertificateInBodyPart - true to include the signing certificate in the signed MIME body part, false to not do so.

See Also:

IAS2Session.isCryptoSignIncludeCertificateInBodyPart()

isCryptoVerifyUseCertificateInBodyPart

public boolean isCryptoVerifyUseCertificateInBodyPart()

Specified by:

isCryptoVerifyUseCertificateInBodyPart in interface IAS2Session

Returns:

true if any certificate passed in a message body is used for certificate verification or false if only the certificate present in the partnership factory is to be used. Defaults to true.

See Also:

IAS2Session.setCryptoVerifyUseCertificateInBodyPart(boolean)

setCryptoVerifyUseCertificateInBodyPart

public void setCryptoVerifyUseCertificateInBodyPart(boolean bCryptoVerifyUseCertificateInBodyPart)

Description copied from interface: IAS2Session

Settings flag, whether a contained certificate is used for message verification.

Specified by:

setCryptoVerifyUseCertificateInBodyPart in interface IAS2Session

Parameters:

bCryptoVerifyUseCertificateInBodyPart - true if any certificate passed in a message body is used for certificate verification or false if only the certificate present in the partnership factory is to be used.

See Also:

IAS2Session.isCryptoVerifyUseCertificateInBodyPart()

getHttpProxy

@Nullable
public Proxy getHttpProxy()

Description copied from interface: IAS2Session

Get the optional HTTP/HTTPS proxy settings to be used for sending AS2 messages and asynchronous MDNs.

Specified by:

getHttpProxy in interface IAS2Session

Returns:

The HTTP/HTTPS proxy object to be used. May be null.

See Also:

IAS2Session.setHttpProxy(Proxy)

setHttpProxy

public void setHttpProxy(@Nullable
                         Proxy aHttpProxy)

Description copied from interface: IAS2Session

Set the optional HTTP/HTTPS proxy settings to be used for sending AS2 messages and asynchronous MDNs.

Specified by:

setHttpProxy in interface IAS2Session

Parameters:

aHttpProxy - The HTTP/HTTPS proxy object to be used. May be null.

See Also:

IAS2Session.getHttpProxy()

toString

public String toString()

Overrides:

toString in class Object