SDMX Training SDMX IT JAVA Student Book Customer CE – EUROSTAT / B / B5 Contract reference ESTAT/B5 60402.2008.001-2009.692 Author Borja LÁZARO HERRERO Release 1.0 Status Final Reference 2010-11-22 [GUI] (SDMX IT JAVA v1.0) F.doc Organisation Diffusion EUROSTAT-B5 Adam WRONSKI AWR EUROSTAT-B5 Marco PELLEGRINO MPE EUROSTAT-B5 Bengt-Ake LINDBLAD BAL SOGETI LUXEMBOURG Borja LÁZARO HERRERO BLH SOGETI LUXEMBOURG Fabien JACQUET FJA SOGETI LUXEMBOURG Johan PIEDIGROSSO JPI Track Change Organization Author Date Version SOGETI Borja LÁZARO HERRERO 2010/10/07 v1.0 Table of contents TRACK CHANGE ....................................................................................................................................... 2 1 THE SDMX STANDARD .................................................................................................................... 6 1.1 INTRODUCTION TO SDMX STANDARD ............................................................................................. 6 1.2 SDMX INFORMATION MODEL ......................................................................................................... 7 1.2.1 Base Package .......................................................................................................................... 8 1.2.1.1 Identification, Versioning & Maintenance ......................................................................................... 8 1.2.1.2 Inheritance Relationship ..................................................................................................................... 9 1.2.2 DSD’s and Datasets .............................................................................................................. 10 1.2.2.1 Coded / Uncoded Components ......................................................................................................... 11 1.2.3 Data Constraints and Provisioning ...................................................................................... 12 1.3 EVALUATION ................................................................................................................................. 14 2 SDMX-ML .......................................................................................................................................... 15 2.1 BUILDING XML FROM SDMX IM ................................................................................................. 15 2.2 SDMX STRUCTURES ..................................................................................................................... 15 2.2.1 DSD’s, Concept Schemes and Code List .............................................................................. 16 2.2.1.1 Concept Schema ............................................................................................................................... 16 2.2.1.2 Codelist Schema ............................................................................................................................... 17 2.2.1.3 DSD´s ............................................................................................................................................... 19 2.2.1.4 Short Term Statsitics. (Time Series) ................................................................................................. 19 2.2.1.5 Demography. (Cross-Sectional) ....................................................................................................... 22 2.2.1.6 Data Structure Wizard ...................................................................................................................... 24 2.3 SDMX-ML MESSAGES ................................................................................................................. 25 2.3.1 Generic, Compact, Utility and Cross-Sectional .................................................................... 25 2.3.1.1 Generic ............................................................................................................................................. 25 2.3.1.2 Compact ........................................................................................................................................... 27 2.3.1.3 Utility ............................................................................................................................................... 29 2.3.1.4 Cross-Sectional ................................................................................................................................ 31 2.3.2 Conversion between types ..................................................................................................... 33 2.3.2.1 SDMX Converter ............................................................................................................................. 33 2.4 EVALUATION ................................................................................................................................. 34 3 INTRODUCTION TO ECLIPSE/JAVA .......................................................................................... 35 3.1 PROGRAMMING USING JAVA .......................................................................................................... 35 3.2 THE ECLIPSE IDE .......................................................................................................................... 35 3.2.1 Workspace............................................................................................................................. 36 3.2.2 Views ..................................................................................................................................... 36 3.2.3 Perspectives .......................................................................................................................... 36 4 DESIGNING SOFTWARE TO MANAGE SDMX-ML .................................................................. 36 4.1 XML PARSING AND WRITING ......................................................................................................... 36 4.1.1 XML Data Binding ................................................................................................................ 37 4.1.2 DOM Interface ...................................................................................................................... 37 4.1.3 SAX Interface ........................................................................................................................ 38 4.1.4 StAX Interface ....................................................................................................................... 38 4.1.5 XML Beans ........................................................................................................................... 39 4.1.6 Digester ................................................................................................................................ 39 4.1.7 JDOM ................................................................................................................................... 40 4.1.8 JAXP ..................................................................................................................................... 40 4.2 THE NEED FOR AN SDMX-ML API ............................................................................................... 41 4.3 EVALUATION ................................................................................................................................. 41 5 SDMX WEB SERVICES ................................................................................................................... 42 5.1 INTRODUCTION TO WEB SERVICES ................................................................................................ 42 5.1.1 RPC Document Style ............................................................................................................. 43 5.1.2 Message Document Style ...................................................................................................... 45 5.1.3 WSDL (Web Service Descriptor Language) ......................................................................... 46 5.1.4 Restful ................................................................................................................................... 46 5.2 SDMX WEB SERVICES .................................................................................................................. 47 5.2.1 Messaging – SDMX Guideline .............................................................................................. 47 5.2.2 Sample SDMX Queries ......................................................................................................... 47 5.2.3 Implementation ..................................................................................................................... 48 5.3 EVALUATION ................................................................................................................................. 48 6 SDMX WEB SERVICES - ANNEX .................................................................................................. 49 6.1 SDMX REGISTRY .......................................................................................................................... 49 6.1.1 WSDL .................................................................................................................................... 49 6.1.2 SOAP Message...................................................................................................................... 53 6.2 EVALUATION ................................................................................................................................