Note

As of release 1.22.0 you should use the template-test-service archetype to generate test services. This archetype allows you to create one or more service endpoints in a single app with additional configuration options.

For more information see the template services documentation.

Introduction

The template-messaging-service is a Maven Archetype acting as a supporting resource for the GITB test bed software and specifications. It can be used as template from which to build a fully working GITB-compliant messaging service to be used through the GITB test bed for sending and receiving messages in an arbitrary manner.

The GITB specifications are the result of the CEN Global eBusiness Interoperability Test bed (GITB) Workshop Agreement. Evolutive maintenance of the GITB specifications and software is now performed by the European Commission's DIGIT under the Interoperable Europe initiative. For more information please check the Interoperability Test Bed's site on Joinup.

Build instructions

This Archetype is developed in Java and is built using Maven 3+, To build issue the following:

mvn clean install

To perform a release and deploy to the Central Repository the profile release needs to be specified:

mvn clean deploy -P release

This profile triggers in addition the following:

• Generation of the source JAR.
• Generation of the Javadocs.
• PGP signature of all artefacts. To do this you need a GPG local installation. In addition if multiple keys are defined you can specify the appropriate one using the gpg.keyname system property. Furthermore, the passphrase entry mode is set to use system property gpg.passphrase. These properties can be provided either on the command line or in Maven's settings.xml by means of a profile.
• Deploy to the Central repository's staging environment and automatically promote the release.

Using the Archetype to generate a new project is through Maven's Archetype Plugin. To use it issue (replacing VERSION with the version you want to use):

mvn archetype:generate -DarchetypeGroupId=eu.europa.ec.itb -DarchetypeArtifactId=template-messaging-service -DarchetypeVersion=VERSION