AS4 profiles overview

public interface IAS4Profile extends IHasID<String>, IHasDisplayName {

    // Returns the profile's unique string identifier (e.g. "peppol", "cef")
    String getID();

    // Returns the human-readable display name (e.g. "Peppol", "CEF (four corner)")
    String getDisplayName();

    // Returns an optional compatibility validator, or null if no validation is performed
    IAS4ProfileValidator getValidator();

    // Creates a PMode template for the given parties and address.
    // The returned PMode is NOT registered in the manager yet.
    PMode createPModeTemplate(
        String sInitiatorID,
        String sResponderID,
        String sAddress         // nullable
    );

    // Returns the PMode ID provider for this profile
    IPModeIDProvider getPModeIDProvider();

    // Returns true if this profile is deprecated
    boolean isDeprecated();

    // Returns true if Ping messages should be passed to the SPI handler
    boolean isInvokeSPIForPingMessage();
}

// IAS4ProfileRegistrarSPI — implemented once per profile module
public interface IAS4ProfileRegistrarSPI {
    void registerAS4Profile(IAS4ProfileRegistrar aRegistrar);
}

public final class MyProfileRegistarSPI implements IAS4ProfileRegistrarSPI {

    public static final String AS4_PROFILE_ID = "my-custom-profile";
    public static final String AS4_PROFILE_NAME = "My Custom Profile";

    @Override
    public void registerAS4Profile(@NonNull final IAS4ProfileRegistrar aRegistrar) {
        final IAS4ProfilePModeProvider pModeProvider =
            (initiatorID, responderID, address) ->
                MyCustomPMode.createPMode(initiatorID, responderID, address);

        aRegistrar.registerProfile(
            new AS4Profile(
                AS4_PROFILE_ID,
                AS4_PROFILE_NAME,
                MyCompatibilityValidator::new,
                pModeProvider,
                IPModeIDProvider.DEFAULT_DYNAMIC,
                false,  // not deprecated
                false   // do not invoke SPI for ping messages
            )
        );
    }
}

# src/main/resources/META-INF/services/com.helger.phase4.profile.IAS4ProfileRegistrarSPI
com.example.MyProfileRegistarSPI

// Access the global profile manager
IAS4ProfileManager profileMgr = MetaAS4Manager.getProfileMgr();

// List all registered profiles
ICommonsList<IAS4Profile> profiles = profileMgr.getAllProfiles();

// Look up a specific profile by ID
IAS4Profile peppolProfile = profileMgr.getProfileOfID("peppol");

// Get the count of registered profiles
int count = profileMgr.getProfileCount();

// Create a PMode template from a profile (not yet registered)
PMode template = peppolProfile.createPModeTemplate(
    "sender-id",
    "receiver-id",
    "https://receiver.example.com/as4"
);

# application.properties or phase4.properties
phase4.default.profile=peppol

String defaultProfileId = AS4Configuration.getDefaultAS4ProfileID();