Skip to content

SDMX Connector library for JAVA

Jump to bottom
Attilio Mattiocco edited this page Aug 9, 2024 · 5 revisions

The SDMX java library contains all the code for SDMX query building, data and metadata parsing and web services interaction. It has initially been developed for handling SOAP SDMX 2.0 web services and lately modified to support SDMX 2.1 REST web services.

Custom providers (e.g. sdmx v2.0) are supported implementing specific classes. The class diagram below clarifies the role of the most important classes.

SDMX Class Diagram

How to build it

The java sources are in the JAVA subtree of the project. We describe the steps for building by means of the ant tool. You can nevertheless use your favourite ide or tools for accomplishing this task.

  1. To clean the subtree, type:
    ant clean

  2. To build the java library, type:
    ant dist

This will also copy the generated jar file in the dist subdir and in the correct library directories of each connector.

How to use it

The java library can be used:

  • inside the specific connector (see wiki pages for each of them)
  • as a Java component in hosting Java projects
  • as a standalone java application, for command line interactions

Examples for the last use case:

java -classpath SDMX.jar it.bancaditalia.oss.sdmx.util.GetTimeSeries ECB EXR/A.USD.EUR.SP00.A

java -jar SDMX.jar

The last line will open the SDMX Helper tool, a nice GUI that helps browsing the provider contents and builds sdmx queries.

On Windows the helper can be also started by double clicking the jar file. (Only if the jar file type is associated to java)

SDMX Helper

Clone this wiki locally