Package com.helger.smpclient.peppol

Class SMPClient

java.lang.Object

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

com.helger.smpclient.peppol.SMPClientReadOnly

com.helger.smpclient.peppol.SMPClient

All Implemented Interfaces:

com.helger.commons.traits.IGenericImplTrait<SMPClientReadOnly>, ISMPExtendedServiceMetadataProvider, ISMPServiceGroupProvider, ISMPServiceMetadataProvider

public class SMPClient
extends SMPClientReadOnly

This class is used for calling the Peppol SMP REST interface. This particular class contains the writing methods. It inherits all reading methods from SMPClientReadOnly.

Author:

Philip Helger

Field Summary

Fields inherited from class com.helger.smpclient.peppol.SMPClientReadOnly

URL_PART_COMPLETE, URL_PART_LIST, 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
SMPClient(ISMPURLProvider aURLProvider, com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier, com.helger.peppol.sml.ISMLInfo aSMLInfo)	Constructor with SML lookup
SMPClient(ISMPURLProvider aURLProvider, com.helger.peppolid.IParticipantIdentifier aParticipantIdentifier, String sSMLZoneName)	Constructor with SML lookup
SMPClient(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.
com.helger.xsds.peppol.smp1.ServiceGroupType	saveServiceGroup(com.helger.peppolid.IParticipantIdentifier aParticipantID, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service group.
void	saveServiceGroup(com.helger.xsds.peppol.smp1.ServiceGroupType aServiceGroup, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service group.
void	saveServiceInformation(com.helger.xsds.peppol.smp1.ServiceInformationType aServiceInformation, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a service information data object.
void	saveServiceRedirect(com.helger.peppolid.IParticipantIdentifier aServiceGroupID, com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID, com.helger.xsds.peppol.smp1.RedirectType aRedirect, com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)	Saves a redirect data object.

Methods inherited from class com.helger.smpclient.peppol.SMPClientReadOnly

getAllDocumentTypes, getAllDocumentTypes, getEndpoint, getEndpoint, getEndpointAddress, getEndpointAt, getEndpointAt, getEndpointCertificate, getEndpointCertificateString, getSchemeSpecificServiceMetadata, getSchemeSpecificServiceMetadataOrNull, getServiceGroup, getServiceGroupByDNS, getServiceGroupOrNull, getServiceMetadata, getServiceMetadataOrNull, getServiceRegistrationByDNS, getWildcardServiceMetadataOrNull, getWildcardServiceMetadataOrNull, isEndpointValidAt

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.commons.traits.IGenericImplTrait

thisAsT

Methods inherited from interface com.helger.smpclient.peppol.ISMPExtendedServiceMetadataProvider

getEndpoint, getEndpointAddress, getEndpointAddressAt, getEndpointAt, getEndpointCertificate, getEndpointCertificateAt, getEndpointCertificateString, getEndpointCertificateStringAt

Constructor Details

SMPClient

public SMPClient(@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)

SMPClient

public SMPClient(@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)

SMPClient

public SMPClient(@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.peppol.smp1.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.peppol.smp1.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.

saveServiceInformation

public void saveServiceInformation(@Nonnull
 com.helger.xsds.peppol.smp1.ServiceInformationType aServiceInformation,
 @Nonnull
 com.helger.http.basicauth.BasicAuthClientCredentials aCredentials)
                            throws SMPClientException

Saves a service information data object.

Parameters:

aServiceInformation - The service information object 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.

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(IParticipantIdentifier, IDocumentTypeIdentifier, RedirectType, BasicAuthClientCredentials)

saveServiceRedirect

public void saveServiceRedirect(@Nonnull
 com.helger.peppolid.IParticipantIdentifier aServiceGroupID,
 @Nonnull
 com.helger.peppolid.IDocumentTypeIdentifier aDocumentTypeID,
 @Nonnull
 com.helger.xsds.peppol.smp1.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:

• saveServiceInformation(ServiceInformationType, 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.