Package com.helger.smpclient.bdxr2

Class BDXR2Client

java.lang.Object

com.helger.smpclient.httpclient.AbstractGenericSMPClient<BDXR2ClientReadOnly>

com.helger.smpclient.bdxr2.BDXR2ClientReadOnly

com.helger.smpclient.bdxr2.BDXR2Client

All Implemented Interfaces:

com.helger.commons.traits.IGenericImplTrait<BDXR2ClientReadOnly>, IBDXR2ServiceGroupProvider, IBDXR2ServiceMetadataProvider

public class BDXR2Client
extends BDXR2ClientReadOnly

This class is used for calling the OASIS BDXR SMP v2 REST interface. This particular class also contains the non-standard writing methods. It inherits all reading methods from BDXR2ClientReadOnly.

Note: this class is also licensed under Apache 2 license, as it was not part of the original implementation

Author:

Philip Helger

Field Summary

Fields inherited from class com.helger.smpclient.bdxr2.BDXR2ClientReadOnly

PATH_OASIS_BDXR_SMP_2, URL_PART_SERVICES

Fields inherited from class com.helger.smpclient.httpclient.AbstractGenericSMPClient

CONTENT_TYPE_TEXT_XML, DEFAULT_FOLLOW_REDIRECTS, DEFAULT_XML_SCHEMA_VALIDATION

Constructor Summary

Constructors

Constructor	Description
BDXR2Client(ISMPURLProvider aURLProvider, com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier, com.helger.peppol.sml.ISMLInfo aSMLInfo)	Constructor with SML lookup
BDXR2Client(ISMPURLProvider aURLProvider, com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier, String sSMLZoneName)	Constructor with SML lookup
BDXR2Client(URI aSMPHost)	Constructor with a direct SMP URL. Remember: must be HTTP and using port 80 only!

Method Summary

Modifier and Type	Method	Description
void	deleteServiceGroup(com.helger.peppolid.IParticipantIdentifier aServiceGroupID, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Deletes a service group given by its service group id.
void	deleteServiceRegistration(com.helger.peppolid.IParticipantIdentifier aServiceGroupID, com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Deletes a service meta data object given by its service group id and its document type.
void	saveServiceEndpoints(com.helger.xsds.bdxr.smp2.bc.ParticipantIDType aServiceGroupID, com.helger.xsds.bdxr.smp2.bc.IDType aDocumentTypeID, List<com.helger.xsds.bdxr.smp2.ac.EndpointType> aEndpoints, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service information data object.
com.helger.xsds.bdxr.smp2.ServiceGroupType	saveServiceGroup(com.helger.peppolid.IParticipantIdentifier aParticipantID, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service group.
void	saveServiceGroup(com.helger.xsds.bdxr.smp2.ServiceGroupType aServiceGroup, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service group.
void	saveServiceRedirect(com.helger.xsds.bdxr.smp2.bc.ParticipantIDType aServiceGroupID, com.helger.xsds.bdxr.smp2.bc.IDType aDocumentTypeID, com.helger.xsds.bdxr.smp2.ac.RedirectType aRedirect, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a redirect data object.

Methods inherited from class com.helger.smpclient.bdxr2.BDXR2ClientReadOnly

getAllDocumentTypes, getEndpoint, getEndpointAddress, getEndpointCertificate, getEndpointCertificateBytes, getServiceGroup, getServiceGroupByDNS, getServiceGroupOrNull, getServiceMetadata, getServiceMetadataOrNull, getServiceRegistrationByDNS

Methods inherited from class com.helger.smpclient.httpclient.AbstractGenericSMPClient

containsRedirectSubject, createHttpContext, customizeMarshaller, executeGenericRequest, executeRequest, getConvertedException, getMarshallerCustomizer, getSMPHostURI, getTrustStore, httpClientSettings, isFollowSMPRedirects, isSecureValidation, isVerifySignature, isXMLSchemaValidation, setFollowSMPRedirects, setMarshallerCustomizer, setSecureValidation, setTrustStore, setVerifySignature, setXMLSchemaValidation, toString, withHttpClientSettings

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.helger.smpclient.bdxr2.IBDXR2ServiceMetadataProvider

getEndpoint, getEndpointAddress, getEndpointCertificate, getEndpointCertificateBytes

Methods inherited from interface com.helger.commons.traits.IGenericImplTrait

thisAsT

Constructor Details

BDXR2Client

public BDXR2Client(@Nonnull
 ISMPURLProvider aURLProvider,
 @Nonnull
 com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier,
 @Nonnull
 com.helger.peppol.sml.ISMLInfo aSMLInfo)
            throws SMPDNSResolutionException

Constructor with SML lookup

Parameters:

aURLProvider - The URL provider to be used. May not be null.

aParticipantIdentifier - The participant identifier to be used. Required to build the SMP access URI.

aSMLInfo - The SML to be used. Required to build the SMP access URI.

Throws:

SMPDNSResolutionException - if DNS resolution fails

See Also:

• ISMPURLProvider.getSMPURIOfParticipant(IParticipantIdentifier, ISMLInfo)

BDXR2Client

public BDXR2Client(@Nonnull
 ISMPURLProvider aURLProvider,
 @Nonnull
 com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier,
 @Nonnull @Nonempty
 String sSMLZoneName)
            throws SMPDNSResolutionException

Constructor with SML lookup

Parameters:

aURLProvider - The URL provider to be used. May not be null.

aParticipantIdentifier - The participant identifier to be used. Required to build the SMP access URI.

sSMLZoneName - The SML DNS zone name to be used. Required to build the SMP access URI. Must end with a trailing dot (".") and may neither be null nor empty to build a correct URL. May not start with "http://". Example: sml.peppolcentral.org.

Throws:

SMPDNSResolutionException - if DNS resolution fails

See Also:

• ISMPURLProvider.getSMPURIOfParticipant(IParticipantIdentifier, String)

BDXR2Client

public BDXR2Client(@Nonnull
 URI aSMPHost)

Constructor with a direct SMP URL.
Remember: must be HTTP and using port 80 only!

Parameters:

aSMPHost - The address of the SMP service. Must be port 80 and basic http only (no https!). Example: http://smpcompany.company.org

Method Details

saveServiceGroup

public void saveServiceGroup(@Nonnull
 com.helger.xsds.bdxr.smp2.ServiceGroupType aServiceGroup,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                      throws SMPClientException

Saves a service group. The meta data references should not be set and are not used.

Parameters:

aServiceGroup - The service group to save. May not be null.

aCredentials - The user name and password to use as credentials. May not be null.

Throws:

SMPClientException - in case something goes wrong

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientNotFoundException - A HTTP Not Found was received. This can happen if the service was not found.

SMPClientBadRequestException - The request was not well formed.

saveServiceGroup

@Nonnull
public com.helger.xsds.bdxr.smp2.ServiceGroupType saveServiceGroup(@Nonnull
 com.helger.peppolid.IParticipantIdentifier aParticipantID,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                                                            throws SMPClientException

Saves a service group. The meta data references should not be set and are not used.

Parameters:

aParticipantID - The participant identifier for which the service group is to save.

aCredentials - The user name and password to use as credentials.

Returns:

The created ServiceGroupType object.

Throws:

SMPClientException - in case something goes wrong

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientNotFoundException - A HTTP Not Found was received. This can happen if the service was not found.

SMPClientBadRequestException - The request was not well formed.

deleteServiceGroup

public void deleteServiceGroup(@Nonnull
 com.helger.peppolid.IParticipantIdentifier aServiceGroupID,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                        throws SMPClientException

Deletes a service group given by its service group id.

Parameters:

aServiceGroupID - The service group id of the service group to delete. May not be null.

aCredentials - The user name and password to use as credentials. May not be null.

Throws:

SMPClientException - in case something goes wrong

SMPClientParticipantNotFoundException - The service group id does not exist in the network.

SMPClientNotFoundException - The service group id or document types did not exist.

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientBadRequestException - The request was not well formed.

saveServiceEndpoints

public void saveServiceEndpoints(@Nonnull
 com.helger.xsds.bdxr.smp2.bc.ParticipantIDType aServiceGroupID,
 @Nonnull
 com.helger.xsds.bdxr.smp2.bc.IDType aDocumentTypeID,
 @Nonnull
 List<com.helger.xsds.bdxr.smp2.ac.EndpointType> aEndpoints,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                          throws SMPClientException

Saves a service information data object.

Parameters:

aServiceGroupID - The service group ID to use. May not be null.

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

aEndpoints - The endpoints to the created or updated. May not be null.

aCredentials - The user name and password to use as credentials. May not be null.

Throws:

SMPClientException - in case something goes wrong

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientParticipantNotFoundException - The service group id does not exist in the network.

SMPClientNotFoundException - The service group id or document types did not exist.

SMPClientBadRequestException - The request was not well formed.

See Also:

• saveServiceRedirect(ParticipantIDType, IDType, RedirectType, BasicAuthClientCredentials)

saveServiceRedirect

public void saveServiceRedirect(@Nonnull
 com.helger.xsds.bdxr.smp2.bc.ParticipantIDType aServiceGroupID,
 @Nonnull
 com.helger.xsds.bdxr.smp2.bc.IDType aDocumentTypeID,
 @Nonnull
 com.helger.xsds.bdxr.smp2.ac.RedirectType aRedirect,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                         throws SMPClientException

Saves a redirect data object.

Parameters:

aServiceGroupID - The service group ID to use. May not be null.

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

aRedirect - The redirect to be saved. May not be null.

aCredentials - The user name and password to use as credentials. May not be null.

Throws:

SMPClientException - in case something goes wrong

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientParticipantNotFoundException - The service group id does not exist in the network.

SMPClientNotFoundException - The service group id or document types did not exist.

SMPClientBadRequestException - The request was not well formed.

See Also:

• saveServiceEndpoints(ParticipantIDType, IDType, List, BasicAuthClientCredentials)

deleteServiceRegistration

public void deleteServiceRegistration(@Nonnull
 com.helger.peppolid.IParticipantIdentifier aServiceGroupID,
 @Nonnull
 com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                               throws SMPClientException

Deletes a service meta data object given by its service group id and its document type.

Parameters:

aServiceGroupID - The service group id of the service meta data to delete. May not be null.

aDocumentTypeID - The document type of the service meta data to delete. May not be null.

aCredentials - The user name and password to use as credentials. May not be null.

Throws:

SMPClientException - in case something goes wrong

SMPClientUnauthorizedException - The user name or password was not correct.

SMPClientParticipantNotFoundException - The service group id does not exist in the network.

SMPClientNotFoundException - The service group id or document types did not exist.

SMPClientBadRequestException - The request was not well formed.