eu.toop.connector.app.r2d2

Class R2D2Client

java.lang.Object

eu.toop.connector.app.r2d2.R2D2Client

@Immutable
public class R2D2Client
extends Object

Helper class to easily perform the multi participant lookup of the Resilient Registry-based Dynamic Discovery

Author:

Philip Helger, BRZ, AT

Method Summary

Modifier and Type

Method and Description

static com.helger.commons.collection.impl.ICommonsList<eu.toop.connector.api.r2d2.IR2D2Endpoint>

getParticipantIDsAndEndpoints(String sLogPrefix, String sCountryCode, com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID, eu.toop.connector.api.r2d2.IR2D2ParticipantIDProvider aParticipantIDProvider, com.helger.peppolid.IProcessIdentifier aProcessID, String sTransportProfileID, eu.toop.connector.api.r2d2.IR2D2EndpointProvider aEndpointProvider, eu.toop.connector.api.r2d2.IR2D2ErrorHandler aErrorHandler) Get a list of all endpoints that match the specified requirements.

Methods inherited from class java.lang.Object

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

Method Detail

getParticipantIDsAndEndpoints

@Nonnull
 @ReturnsMutableCopy
public static com.helger.commons.collection.impl.ICommonsList<eu.toop.connector.api.r2d2.IR2D2Endpoint> getParticipantIDsAndEndpoints(@Nonnull
                                                                                                                                                                      String sLogPrefix,
                                                                                                                                                                      @Nonnull @Nonempty
                                                                                                                                                                      String sCountryCode,
                                                                                                                                                                      @Nonnull
                                                                                                                                                                      com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID,
                                                                                                                                                                      @Nonnull
                                                                                                                                                                      eu.toop.connector.api.r2d2.IR2D2ParticipantIDProvider aParticipantIDProvider,
                                                                                                                                                                      @Nonnull
                                                                                                                                                                      com.helger.peppolid.IProcessIdentifier aProcessID,
                                                                                                                                                                      @Nonnull @Nonempty
                                                                                                                                                                      String sTransportProfileID,
                                                                                                                                                                      @Nonnull
                                                                                                                                                                      eu.toop.connector.api.r2d2.IR2D2EndpointProvider aEndpointProvider,
                                                                                                                                                                      @Nonnull
                                                                                                                                                                      eu.toop.connector.api.r2d2.IR2D2ErrorHandler aErrorHandler)

Get a list of all endpoints that match the specified requirements. This is the API that is to be invoked in the case, where ServiceGroup IDs of the receiver are unknown and an additional PEPPOL Directory query needs to be performed.
Internally country code and document type are queried against the correct TOOP Directory instance (depending on the production or test flag). The SMPs of the resulting service group IDs are than queried in a loop for all matching endpoints (of participant ID and document type ID) which are parsed and converted to simpler R2D2Endpoint instances.

Parameters:

sLogPrefix - Log prefix to use. May not be null but maybe empty.

sCountryCode - The country code to be queried. Must be a 2-char string. May not be null.

aDocumentTypeID - The document type ID to be queried. May not be null.

aParticipantIDProvider - The participant ID provider that uses country code and document type ID to determine the set of matching participant identifiers. May not be null.

aProcessID - The process ID to be queried. May not be null.

sTransportProfileID - The transport profile ID to be used. May neither be null nor empty.

aEndpointProvider - The R2D2 endpoint ID provider to be used. May not be null.

aErrorHandler - The error handler to be used. May not be null.

Returns:

A non-null but maybe empty list of all matching endpoints.