Package com.helger.as2lib.processor.receiver.net

Class AS2MDNReceiverHandler

java.lang.Object

com.helger.as2lib.processor.receiver.net.AbstractReceiverHandler

com.helger.as2lib.processor.receiver.net.AS2MDNReceiverHandler

All Implemented Interfaces:

INetModuleHandler

public class AS2MDNReceiverHandler
extends AbstractReceiverHandler

The main handler for receiving AS2 async MDN messages.

Author:

Philip Helger

Constructor Summary

Constructors

Constructor	Description
AS2MDNReceiverHandler(AS2MDNReceiverModule aModule)

Method Summary

Modifier and Type	Method	Description
boolean	checkAsyncMDN(AS2Message aMsg)	verify if the mic is matched.
protected com.helger.commons.state.ESuccess	deletePendingFile(AS2Message aMsg, String sPendingFilename)	Delete the pending file itself.
protected com.helger.commons.state.ESuccess	deletePendingInfoStream(AS2Message aMsg)	Delete the pending info file.
final IAS2IncomingMDNCallback	getIncomingMDNCallback()
final IMICMatchingHandler	getMICMatchingHandler()
final AS2MDNReceiverModule	getModule()
protected File	getPendingInfoFile(AS2Message aMsg)	Get the pending info file itself.
void	handle(AbstractActiveNetModule aOwner, Socket aSocket)
void	handleIncomingMessage(String sClientInfo, jakarta.activation.DataSource aMsgData, AS2Message aMsg, IAS2HttpResponseHandler aResponseHandler)
protected InputStream	openPendingInfoStreamForReading(AS2Message aMsg)	Delete the pending info file for reading.
protected final void	receiveMDN(AS2Message aMsg, byte[] aData, IAS2HttpResponseHandler aResponseHandler, AS2ResourceHelper aResHelper)	method for receiving and processing Async MDN sent from receiver.
void	reparse(AS2Message aMsg, AS2HttpClient aHttpClient, IHTTPIncomingDumper aIncomingDumper)
final void	setIncomingMDNCallback(IAS2IncomingMDNCallback aIMC)	Set the incoming MDN callback that is invoked for each received MDN.
final void	setMICMatchingHandler(IMICMatchingHandler aMICMatchingHandler)	Set the MIC matching handler to used.

Methods inherited from class com.helger.as2lib.processor.receiver.net.AbstractReceiverHandler

getClientInfo, getEffectiveHttpIncomingDumper, getHttpIncomingDumper, getVerificationCertificateConsumer, setHttpIncomingDumper, setVerificationCertificateConsumer

Methods inherited from class java.lang.Object

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

Constructor Details

AS2MDNReceiverHandler

public AS2MDNReceiverHandler(@Nonnull
 AS2MDNReceiverModule aModule)

Parameters:

aModule - The receiver module for attributes, session etc. May not be null.

Method Details

getModule

@Nonnull
public final AS2MDNReceiverModule getModule()

Returns:

The receiver module passed in the constructor. Never null.

getMICMatchingHandler

@Nonnull
public final IMICMatchingHandler getMICMatchingHandler()

Returns:

The current MIC matching handler. Never null.

Since:

4.4.0

setMICMatchingHandler

public final void setMICMatchingHandler(@Nonnull
 IMICMatchingHandler aMICMatchingHandler)

Set the MIC matching handler to used.

Parameters:

aMICMatchingHandler - The new handler. May not be null.

Since:

4.4.0

getIncomingMDNCallback

@Nullable
public final IAS2IncomingMDNCallback getIncomingMDNCallback()

Returns:

The incoming MDN callback. May be null.

Since:

v4.7.1

setIncomingMDNCallback

public final void setIncomingMDNCallback(@Nullable
 IAS2IncomingMDNCallback aIMC)

Set the incoming MDN callback that is invoked for each received MDN.

Parameters:

aIMC - The callback to be invoked. May be null.

Since:

v4.7.1

getPendingInfoFile

@Nullable
protected File getPendingInfoFile(@Nonnull
 AS2Message aMsg)
                           throws AS2Exception

Get the pending info file itself.

Parameters:

aMsg - Source message. Never null.

Returns:

The file.

Throws:

AS2Exception - In case of error

Since:

4.10.2

openPendingInfoStreamForReading

@Nullable
@OverrideOnDemand
protected InputStream openPendingInfoStreamForReading(@Nonnull
 AS2Message aMsg)
                                               throws AS2Exception

Delete the pending info file for reading.

Parameters:

aMsg - Source message. Never null.

Returns:

null if open failed.

Throws:

AS2Exception - In case of error

Since:

4.10.2

deletePendingInfoStream

@OverrideOnDemand
protected com.helger.commons.state.ESuccess deletePendingInfoStream(@Nonnull
 AS2Message aMsg)
                                                             throws AS2Exception

Delete the pending info file.

Parameters:

aMsg - Source message. Never null.

Returns:

ESuccess

Throws:

AS2Exception - In case of error

Since:

4.10.2

deletePendingFile

@OverrideOnDemand
protected com.helger.commons.state.ESuccess deletePendingFile(@Nonnull
 AS2Message aMsg,
 @Nonnull
 String sPendingFilename)
                                                       throws AS2Exception

Delete the pending file itself.

Parameters:

aMsg - Source message. Never null.

sPendingFilename - Pending filename

Returns:

ESuccess

Throws:

AS2Exception - In case of error

Since:

4.10.2

checkAsyncMDN

public boolean checkAsyncMDN(@Nonnull
 AS2Message aMsg)
                      throws AS2Exception

verify if the mic is matched.

Parameters:

aMsg - Message

Returns:

true if the MDN was processed, false e.g. on MIC mismatch

Throws:

AS2Exception - In case of error; e.g. MIC mismatch

receiveMDN

protected final void receiveMDN(@Nonnull
 AS2Message aMsg,
 byte[] aData,
 @Nonnull
 IAS2HttpResponseHandler aResponseHandler,
 @Nonnull
 AS2ResourceHelper aResHelper)
                         throws AS2Exception,
IOException

method for receiving and processing Async MDN sent from receiver.

Parameters:

aMsg - The MDN message

aData - The MDN content

aResponseHandler - The HTTP response handler for setting the correct HTTP response code

aResHelper - Resource helper

Throws:

AS2Exception - In case of error

IOException - In case of IO error

reparse

public void reparse(@Nonnull
 AS2Message aMsg,
 @Nonnull
 AS2HttpClient aHttpClient,
 @Nullable
 IHTTPIncomingDumper aIncomingDumper)
             throws AS2Exception

Throws:

AS2Exception

handleIncomingMessage

public void handleIncomingMessage(@Nonnull @Nonempty
 String sClientInfo,
 @Nonnull
 jakarta.activation.DataSource aMsgData,
 @Nonnull
 AS2Message aMsg,
 @Nonnull
 IAS2HttpResponseHandler aResponseHandler)

handle

public void handle(@Nonnull
 AbstractActiveNetModule aOwner,
 @Nonnull
 Socket aSocket)