com.helger.smpclient.bdxr2.IBDXR2ServiceMetadataProvider Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of peppol-smp-client Show documentation
Show all versions of peppol-smp-client Show documentation
Peppol and OASIS BDXR SMP client
/*
* Copyright (C) 2015-2024 Philip Helger
* philip[at]helger[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.helger.smpclient.bdxr2;
import java.security.cert.CertificateException;
import java.security.cert.X509Certificate;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import com.helger.commons.ValueEnforcer;
import com.helger.peppol.smp.ISMPTransportProfile;
import com.helger.peppolid.IDocumentTypeIdentifier;
import com.helger.peppolid.IParticipantIdentifier;
import com.helger.peppolid.IProcessIdentifier;
import com.helger.security.certificate.CertificateHelper;
import com.helger.smpclient.exception.SMPClientBadRequestException;
import com.helger.smpclient.exception.SMPClientException;
import com.helger.smpclient.exception.SMPClientUnauthorizedException;
import com.helger.xsds.bdxr.smp2.ServiceMetadataType;
import com.helger.xsds.bdxr.smp2.ac.EndpointType;
/**
* Abstract interface to retrieve a service metadata instance.
*
* @author Philip Helger
* @since 7.0.6
*/
public interface IBDXR2ServiceMetadataProvider
{
/**
* Gets a signed service metadata object given by its service group id and its
* document type.
* This is a specification compliant method.
*
* @param aServiceGroupID
* The ID of the service group to query. May not be null.
* @param aDocumentTypeID
* The document type of the service metadata to retrieve. May not be
* null.
* @return A service metadata object or null if no such
* registration is present.
* @throws SMPClientException
* in case something goes wrong
*/
@Nullable
ServiceMetadataType getServiceMetadataOrNull (@Nonnull IParticipantIdentifier aServiceGroupID,
@Nonnull IDocumentTypeIdentifier aDocumentTypeID) throws SMPClientException;
/**
* Retrieve the service metadata from the provided service group ID and
* document type ID. Than find the matching endpoint from the process ID and
* transport profile.
* This is a specification compliant method.
*
* @param aServiceGroupID
* The service group id of the service metadata to get. May not be
* null.
* @param aDocumentTypeID
* The document type of the service metadata to get. May not be
* null.
* @param aProcessID
* The process ID of the service metadata to get. May not be
* null.
* @param aTransportProfile
* The transport profile of the service metadata to get. May not be
* null.
* @return The endpoint from the signed service metadata object or
* null if no such registration is present.
* @throws SMPClientException
* in case something goes wrong
* @throws SMPClientUnauthorizedException
* A HTTP Forbidden was received, should not happen.
* @throws SMPClientBadRequestException
* The request was not well formed.
* @see #getServiceMetadataOrNull(IParticipantIdentifier,IDocumentTypeIdentifier)
*/
@Nullable
default EndpointType getEndpoint (@Nonnull final IParticipantIdentifier aServiceGroupID,
@Nonnull final IDocumentTypeIdentifier aDocumentTypeID,
@Nonnull final IProcessIdentifier aProcessID,
@Nonnull final ISMPTransportProfile aTransportProfile) throws SMPClientException
{
ValueEnforcer.notNull (aServiceGroupID, "ServiceGroupID");
ValueEnforcer.notNull (aDocumentTypeID, "DocumentTypeID");
ValueEnforcer.notNull (aProcessID, "ProcessID");
ValueEnforcer.notNull (aTransportProfile, "TransportProfile");
// Get meta data for participant/documentType
final ServiceMetadataType aSignedServiceMetadata = getServiceMetadataOrNull (aServiceGroupID, aDocumentTypeID);
return aSignedServiceMetadata == null ? null : BDXR2ClientReadOnly.getEndpoint (aSignedServiceMetadata, aProcessID, aTransportProfile);
}
/**
* Get the endpoint address URI from the specified endpoint.
* This is a specification compliant method.
*
* @param aServiceGroupID
* Service group ID. May not be null.
* @param aDocumentTypeID
* Document type ID. May not be null.
* @param aProcessID
* Process ID. May not be null.
* @param aTransportProfile
* Transport profile. May not be null.
* @return null if no such endpoint exists, or if the endpoint
* has no endpoint address URI
* @throws SMPClientException
* in case something goes wrong
* @throws SMPClientUnauthorizedException
* A HTTP Forbidden was received, should not happen.
* @throws SMPClientBadRequestException
* The request was not well formed.
*/
@Nullable
default String getEndpointAddress (@Nonnull final IParticipantIdentifier aServiceGroupID,
@Nonnull final IDocumentTypeIdentifier aDocumentTypeID,
@Nonnull final IProcessIdentifier aProcessID,
@Nonnull final ISMPTransportProfile aTransportProfile) throws SMPClientException
{
final EndpointType aEndpoint = getEndpoint (aServiceGroupID, aDocumentTypeID, aProcessID, aTransportProfile);
return BDXR2ClientReadOnly.getEndpointAddress (aEndpoint);
}
/**
* Get the certificate bytes from the specified endpoint.
*
* @param aServiceGroupID
* Service group ID. May not be null.
* @param aDocumentTypeID
* Document type ID. May not be null.
* @param aProcessID
* Process ID. May not be null.
* @param aTransportProfile
* Transport profile. May not be null.
* @return null if no such endpoint exists, or if the endpoint
* has no certificate
* @throws SMPClientException
* in case something goes wrong
* @throws SMPClientUnauthorizedException
* A HTTP Forbidden was received, should not happen.
* @throws SMPClientBadRequestException
* The request was not well formed.
*/
@Nullable
default byte [] getEndpointCertificateBytes (@Nonnull final IParticipantIdentifier aServiceGroupID,
@Nonnull final IDocumentTypeIdentifier aDocumentTypeID,
@Nonnull final IProcessIdentifier aProcessID,
@Nonnull final ISMPTransportProfile aTransportProfile) throws SMPClientException
{
final EndpointType aEndpoint = getEndpoint (aServiceGroupID, aDocumentTypeID, aProcessID, aTransportProfile);
return BDXR2ClientReadOnly.getEndpointCertificateBytes (aEndpoint);
}
/**
* Get the certificate from the specified endpoint.
*
* @param aServiceGroupID
* Service group ID. May not be null.
* @param aDocumentTypeID
* Document type ID. May not be null.
* @param aProcessID
* Process ID. May not be null.
* @param aTransportProfile
* Transport profile. May not be null.
* @return null if no such endpoint exists, or if the endpoint
* has no certificate
* @throws SMPClientException
* in case something goes wrong
* @throws SMPClientUnauthorizedException
* A HTTP Forbidden was received, should not happen.
* @throws SMPClientBadRequestException
* The request was not well formed.
* @throws CertificateException
* In case the conversion from byte to X509 certificate failed
*/
@Nullable
default X509Certificate getEndpointCertificate (@Nonnull final IParticipantIdentifier aServiceGroupID,
@Nonnull final IDocumentTypeIdentifier aDocumentTypeID,
@Nonnull final IProcessIdentifier aProcessID,
@Nonnull final ISMPTransportProfile aTransportProfile) throws SMPClientException,
CertificateException
{
final byte [] aCertBytes = getEndpointCertificateBytes (aServiceGroupID, aDocumentTypeID, aProcessID, aTransportProfile);
return CertificateHelper.convertByteArrayToCertficateDirect (aCertBytes);
}
}
© 2015 - 2024 Weber Informatics LLC | Privacy Policy