com.helger.phase4.eudamed.Phase4EudamedSender Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of phase4-eudamed-client Show documentation
Show all versions of phase4-eudamed-client Show documentation
EUDAMED AS4 client for outgoing transmissions
/*
* Copyright (C) 2022-2024 Philip Helger (www.helger.com)
* 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.phase4.eudamed;
import java.security.cert.X509Certificate;
import java.util.function.Consumer;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.OverridingMethodsMustInvokeSuper;
import javax.annotation.concurrent.Immutable;
import javax.annotation.concurrent.NotThreadSafe;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.helger.commons.annotation.Nonempty;
import com.helger.commons.state.ESuccess;
import com.helger.commons.string.StringHelper;
import com.helger.peppolid.IDocumentTypeIdentifier;
import com.helger.peppolid.IParticipantIdentifier;
import com.helger.peppolid.IProcessIdentifier;
import com.helger.peppolid.factory.SimpleIdentifierFactory;
import com.helger.peppolid.simple.participant.SimpleParticipantIdentifier;
import com.helger.phase4.CAS4;
import com.helger.phase4.dynamicdiscovery.AS4EndpointDetailProviderConstant;
import com.helger.phase4.dynamicdiscovery.IAS4EndpointDetailProvider;
import com.helger.phase4.model.MessageProperty;
import com.helger.phase4.profile.cef.AS4CEFProfileRegistarSPI;
import com.helger.phase4.sender.AbstractAS4UserMessageBuilderMIMEPayload;
import com.helger.phase4.util.Phase4Exception;
import com.helger.smpclient.url.BDXLURLProvider;
import com.helger.smpclient.url.IBDXLURLProvider;
/**
* This class contains all the specifics to send AS4 messages with the CEF
* profile. See sendAS4Message as the main method to trigger the
* sending, with all potential customization.
*
* @author Philip Helger
* @since 1.4.2
*/
@Immutable
public final class Phase4EudamedSender
{
public static final SimpleIdentifierFactory IF = SimpleIdentifierFactory.INSTANCE;
public static final IBDXLURLProvider URL_PROVIDER = BDXLURLProvider.INSTANCE;
private static final Logger LOGGER = LoggerFactory.getLogger (Phase4EudamedSender.class);
private Phase4EudamedSender ()
{}
/**
* @return Create a new Builder for AS4 messages if the payload is present.
* Never null.
*/
@Nonnull
public static EudamedUserMessageBuilder builder ()
{
return new EudamedUserMessageBuilder ();
}
/**
* Abstract EUDAMED UserMessage builder class with sanity methods
*
* @author Philip Helger
* @param
* The implementation type
*/
@NotThreadSafe
public abstract static class AbstractEudamedUserMessageBuilder >
extends
AbstractAS4UserMessageBuilderMIMEPayload
{
protected String m_sSenderID;
protected String m_sReceiverID;
protected IDocumentTypeIdentifier m_aDocTypeID;
protected IProcessIdentifier m_aProcessID;
protected IAS4EndpointDetailProvider m_aEndpointDetailProvider;
protected Consumer m_aCertificateConsumer;
protected Consumer m_aAPEndointURLConsumer;
protected AbstractEudamedUserMessageBuilder ()
{
// Override default values
try
{
as4ProfileID (AS4CEFProfileRegistarSPI.AS4_PROFILE_ID_FOUR_CORNER);
httpClientFactory (new Phase4EudamedHttpClientSettings ());
}
catch (final Exception ex)
{
throw new IllegalStateException ("Failed to init AS4 Client builder", ex);
}
}
/**
* Set the sender participant ID of the message. The participant ID must be
* provided prior to sending. This ends up in the "originalSender"
* UserMessage property.
*
* @param s
* The sender participant ID. May not be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE senderParticipantID (@Nullable final String s)
{
m_sSenderID = s;
return thisAsT ();
}
/**
* Set the receiver participant ID of the message. The participant ID must
* be provided prior to sending. This ends up in the "finalRecipient"
* UserMessage property.
*
* @param s
* The receiver participant ID. May not be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE receiverParticipantID (@Nullable final String s)
{
m_sReceiverID = s;
return thisAsT ();
}
/**
* Set the document type ID to be send. The document type must be provided
* prior to sending.
*
* @param a
* The document type ID to be used. May not be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE documentTypeID (@Nullable final IDocumentTypeIdentifier a)
{
m_aDocTypeID = a;
return action (a == null ? null : a.getURIEncoded ());
}
/**
* Set the process ID to be send. The process ID must be provided prior to
* sending.
*
* @param a
* The process ID to be used. May not be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE processID (@Nullable final IProcessIdentifier a)
{
m_aProcessID = a;
return service (a == null ? null : a.getScheme (), a == null ? null : a.getValue ());
}
/**
* Set the "from party ID". This is mandatory
*
* @param a
* The from party ID. May be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE fromPartyID (@Nullable final IParticipantIdentifier a)
{
return fromPartyIDType (a == null ? null : a.getScheme ()).fromPartyID (a == null ? null : a.getValue ());
}
/**
* Set the "to party ID". This is mandatory
*
* @param a
* The to party ID. May be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE toPartyID (@Nullable final IParticipantIdentifier a)
{
return toPartyIDType (a == null ? null : a.getScheme ()).toPartyID (a == null ? null : a.getValue ());
}
/**
* Set the abstract endpoint detail provider to be used. This can be an SMP
* lookup routine or in certain test cases a predefined certificate and
* endpoint URL.
*
* @param a
* The endpoint detail provider to be used. May be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE endpointDetailProvider (@Nullable final IAS4EndpointDetailProvider a)
{
m_aEndpointDetailProvider = a;
return thisAsT ();
}
@Nonnull
public final IMPLTYPE receiverEndpointDetails (@Nonnull final X509Certificate aCert,
@Nonnull @Nonempty final String sDestURL)
{
return endpointDetailProvider (new AS4EndpointDetailProviderConstant (aCert, sDestURL));
}
/**
* Set an optional Consumer for the retrieved certificate, independent of
* its usability.
*
* @param a
* The consumer to be used. May be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE certificateConsumer (@Nullable final Consumer a)
{
m_aCertificateConsumer = a;
return thisAsT ();
}
/**
* Set an optional Consumer for the destination AP address, independent of
* its usability.
*
* @param a
* The consumer to be used. May be null.
* @return this for chaining
*/
@Nonnull
public final IMPLTYPE endointURLConsumer (@Nullable final Consumer a)
{
m_aAPEndointURLConsumer = a;
return thisAsT ();
}
protected final boolean isEndpointDetailProviderUsable ()
{
if (m_aEndpointDetailProvider instanceof AS4EndpointDetailProviderConstant)
return true;
// Sender ID doesn't matter here
if (StringHelper.hasNoText (m_sReceiverID))
return false;
if (m_aDocTypeID == null)
return false;
if (m_aProcessID == null)
return false;
if (m_aEndpointDetailProvider == null)
return false;
return true;
}
@Override
@OverridingMethodsMustInvokeSuper
protected ESuccess finishFields () throws Phase4Exception
{
if (!isEndpointDetailProviderUsable ())
{
LOGGER.error ("At least one mandatory field for endpoint discovery is not set and therefore the AS4 message cannot be send.");
return ESuccess.FAILURE;
}
// e.g. SMP lookup (may throw an exception)
m_aEndpointDetailProvider.init (m_aDocTypeID,
m_aProcessID,
new SimpleParticipantIdentifier (null, m_sReceiverID));
// Certificate from e.g. SMP lookup (may throw an exception)
final X509Certificate aReceiverCert = m_aEndpointDetailProvider.getReceiverAPCertificate ();
if (m_aCertificateConsumer != null)
m_aCertificateConsumer.accept (aReceiverCert);
receiverCertificate (aReceiverCert);
// URL from e.g. SMP lookup (may throw an exception)
final String sReceiverEndpointURL = m_aEndpointDetailProvider.getReceiverAPEndpointURL ();
if (m_aAPEndointURLConsumer != null)
m_aAPEndointURLConsumer.accept (sReceiverEndpointURL);
endpointURL (sReceiverEndpointURL);
// Call at the end
return super.finishFields ();
}
@Override
@OverridingMethodsMustInvokeSuper
public boolean isEveryRequiredFieldSet ()
{
if (!super.isEveryRequiredFieldSet ())
return false;
if (m_aPayload == null)
{
LOGGER.warn ("The field 'payload' is not set");
return false;
}
if (StringHelper.hasNoText (m_sSenderID))
{
LOGGER.warn ("The field 'senderID' is not set");
return false;
}
if (StringHelper.hasNoText (m_sReceiverID))
{
LOGGER.warn ("The field 'receiverID' is not set");
return false;
}
if (m_aDocTypeID == null && StringHelper.hasNoText (m_sAction))
{
LOGGER.warn ("Neither the field 'docTypeID' nor the field 'action' is set");
return false;
}
if (m_aProcessID == null && StringHelper.hasNoText (m_sService))
{
LOGGER.warn ("Neither the field 'processID' nor the field 'service' is set");
return false;
}
if (m_aEndpointDetailProvider == null)
{
LOGGER.warn ("The field 'endpointDetailProvider' is not set");
return false;
}
// m_aCertificateConsumer is optional
// m_aAPEndointURLConsumer is optional
return true;
}
@Override
protected void customizeBeforeSending () throws Phase4Exception
{
// Add mandatory properties
addMessageProperty (MessageProperty.builder ().name (CAS4.ORIGINAL_SENDER).value (m_sSenderID));
addMessageProperty (MessageProperty.builder ().name (CAS4.FINAL_RECIPIENT).value (m_sReceiverID));
}
}
/**
* The builder class for sending AS4 messages using EUDAMED profile specifics.
* Use {@link #sendMessage()} or {@link #sendMessageAndCheckForReceipt()} to
* trigger the main transmission.
*
* @author Philip Helger
*/
@NotThreadSafe
public static class EudamedUserMessageBuilder extends AbstractEudamedUserMessageBuilder
{
public EudamedUserMessageBuilder ()
{}
}
}