Introduction

The gitb-types library is a supporting resource for the GITB test bed software and specifications. It encapsulates the WSDLs of the service APIs foreseen by the GITB specifications as well as the XSD type definitions. This library contains the set of prebuilt Java classes corresponding to these WSDLs and XSDs to be used as-is in the development of the GITB test bed software and GITB-compliant services.

The project is designed to build four artefact types as follows:

• gitb-types-parent (POM): The parent POM for all modules containing common settings.
• gitb-types (JAR): The library including Java types, using javax API annotations (JAXB, JAX-WS) for the GITB type definitions and service APIs.
• gitb-types-jakarta (JAR): The library including Java types, using Jakarta API annotations (JAXB, JAX-WS) for the GITB type definitions and service APIs.
• gitb-types-specs (JAR): The library including only the XSDs and WSDLs defining the GITB specifications.

Most users would use either gitb-types or gitb-types-jakarta as dependencies. If you are using a Jakarta EE project select gitb-types-jakarta, otherwise for a pre-Jakarta EE project use gitb-types. Using the wrong type of library depending on your setup would result in a JAXB API and implementation mismatch, as well as undetected service operations.

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 and specifically the Interoperability Test Bed Action of the Interoperable EU initiative.

Build instructions

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

mvn clean install

To easily update all modules' version number issue:

mvn versions:set -DnewVersion=X.Y.Z -DprocessAllModules -DgenerateBackupPoms=false

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 module artefacts.
• Generation of Javadocs.
• PGP signatures 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.
• Deployment to the Central repository's staging environment and automatic promotion of the release.

Licence

This software is shared using the European Union Public Licence (EUPL) version 1.2.

Legal notice

The authors of this library waive any and all liability linked to its usage either directly or as a dependency in other software.

Contact

For feedback or questions regarding this library you are invited to post issues in the current repository. In addition, feel free to contact the Test Bed team via email at DIGIT-ITB@ec.europa.eu.

See also

The gitb-types libraries encapsulate the key artefacts and classes foreseen by the GITB specifications. For more information on these you may refer to:

• The GITB Test Description Language (TDL), for authoring conformance test cases.
• The GITB test services, for extension services (e.g. validators).

The gitb-types libraries are key dependencies used by the Test Bed software and its reusable validators. For more information on these you may refer to:

• The GITB Test Bed software, providing a full platform for scenario-based conformance testing.
• The Test Bed's validators for XML, RDF, JSON and CSV, used as standalone services or as conformance testing building blocks.

For general information on all aspects of the Interoperability Test Bed you may refer to its Joinup space.