ORVE WS (Dynamic) (6) Sicres3.0 format (2). Binding files

0. Introduction

There are some things I do not like from the previous class generation.

  1. XML tags are not exactly copied to attribute names. Underscores are deleted.
  2. The class is too big
  3. There are static classes defined in the same file

1. Using binding files

In the last post, when generating java classes, Eclipse asked us for binding files. With binding files, we could vary the class generation process to get a more customized output.

2. Not omitting underscores in attributes.

In StackOverflow it is explained how to get underscores not deleted while generating classes from an xsd file. Here is a simple binding file for this purpose.


 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
<jaxb:bindings
   xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
   xmlns:xs="http://www.w3.org/2001/XMLSchema"
   version="2.1">
   <jaxb:globalBindings localScoping="toplevel"/>
   <jaxb:bindings schemaLocation="sicres3-0.xsd">
   
      <!-- To include underscores in class and attribute names -->
      <!-- See https://stackoverflow.com/a/38494625/7704658 -->
      <jaxb:globalBindings underscoreBinding="asCharInWord">
   
   </jaxb:bindings>
</jaxb:bindings>

3. Generating multiple class files instead of a single class


Blaise Doughan explains how to generate multiple classes.

The binding file ( sicres30jaxbinding.xml )that achieves this goal may be:


 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
<jaxb:bindings
   xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
   xmlns:xs="http://www.w3.org/2001/XMLSchema"
   version="2.1">
   <jaxb:globalBindings localScoping="toplevel"/>
   <jaxb:bindings schemaLocation="sicres30.xsd">
      <!-- To include underscores in class and attribute names -->
      <!-- See https://stackoverflow.com/a/38494625/7704658 -->
      <!-- jaxb:globalBindings underscoreBinding="asCharInWord"/ -->
      
      <!--  Not Static inner classes -->
      <!-- See http://blog.bdoughan.com/2011/07/jaxb-xjc-and-nested-classes.html -->
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Origen_o_Remitente']/xs:complexType">
         <jaxb:class name="DeOrigenORemitente"/>
      </jaxb:bindings>
      
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Destino']/xs:complexType">
         <jaxb:class name="DeDestino"/>
      </jaxb:bindings>
    
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Interesado']/xs:complexType">
         <jaxb:class name="DeInteresado"/>
      </jaxb:bindings>
      
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Asunto']/xs:complexType">
         <jaxb:class name="DeAsunto"/>
      </jaxb:bindings>
        
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Anexo']/xs:complexType">
         <jaxb:class name="De_Anexo"/>
      </jaxb:bindings>
      
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Internos_Control']/xs:complexType">
         <jaxb:class name="DeInternosControl"/>
      </jaxb:bindings>
          
      <jaxb:bindings node="//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Formulario_Generico']/xs:complexType">
         <jaxb:class name="DeFormularioGenerico"/>
      </jaxb:bindings>
               
   </jaxb:bindings>
   
</jaxb:bindings>

In this case, the first part that deals with underscore treatment has been commented.

Line 6 represents the xsd file to be used "sicres30.xsd"

For each class that has been generated in the general file as a static class,  a <jaxb:binding> tag has been used to specify that a separate class should be generated in another file.

For the field, "De_Origen_o_Remitente" the lines 13-15 are used and the explanation is:
To reference its node from the xsd file:


1
2
3
4
<xs:element name="Fichero_Intercambio_SICRES_3">
  <xs:complexType>
    <xs:sequence>
      <xs:element minOccurs="1" maxOccurs="1" name="De_Origen_o_Remitente">

and map it to the "DeOrigenORemitente" class, this node from the xsd file is referenced in the line

<jaxb:bindings node= 
 "//xs:element[@name='Fichero_Intercambio_SICRES_3']/xs:complexType/xs:sequence/xs:element[@name='De_Asunto']/xs:complexType">

The red elements try to reference the node from the xsd file.

Take into account that any small difference may cause a bad reference to the node!!!

To prevent locating the rest of the classes (DeDestino, DeInteresado, DeAsunto, De_Anexo, DeInternosControl and DeFormularioGenerioco) into the sale file, the inputs in the binding file should be provided (lines 17-39)

If now we right-click on the xsd file and select Generate - JAXB classes and provide the binding file
 as in the image



we get these classes

And as we said in the previous post, it is adviseable to delete "ObjectFactory.java" and "jaxb.properties" files from the package to avoid unmarshalling errors!!!




Comments

Post a Comment

Popular posts from this blog

ORVE WS (Dynamic) (4) Jackson XML mapper

0. Introduction I love Jackson parser as it is easy to use and can be used to with some data formats such as CSV ,  JSON , YAML and XML . Just define a wrapper and a class for marshalling/unmarshalling. Although JAXB is a standard, in the Java ecosystem exists many solutions. And my decision is to use Jackson. 1. Defining MAVEN dependencies To use Jackson XML it is required this dependency in Maven. Note that  ${jackson.version} represents a variable that contains preferably the latest Jackson version. 1 2 3 4 5 <dependency> <groupId> com.fasterxml.jackson.dataformat </groupId> <artifactId> jackson-dataformat-xml </artifactId> <version> ${jackson.version} </version> </dependency> But if you want to use CSV, JSON or YAML in the project, it is as easy as including these dependencies 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 <!-- Jackson for CSV --> <de...
Read more

AutoFirma ins and outs (4). Errors in tests in afirma-core, jmulticard-jse

Image
 1. The package org.xml.sax is accessible from more than one module: <unnamed>, java.xml and TestMIMEDetection failure This error is produced in the afirma-core project to solve the error in TestMIMEDetection . At fist to solve it, the " Apache xerces " dependecy is added to the build.gradle, In StackOverflow explains that a package is both in the Modulepath and in the Classpath . The ModulePath is the jdk or jre that is being used and the Classpath is formed by the libraries that are imported. Usually, the packages that begin with "java." or "javax." cannot be included in the Classpath as they should be in the jdk. In the menu option " Configure build path " you can see this option. The dependencies in the build.gradle are: api libs . jmimemagic api libs . xerces The library that has conflictive dependencies is "xerces".  To solve this problem in Gradle click on "Project and External Dependencies" to see th...
Read more

Creating a WS Client consumer

Image
Creating the client consumer I was expected to develop a client consumer of a WS. So I began to google out and find Apache CXF project. Here are the main steps: 1. Get the URL of the WDSL in my case was an intranet     http://xxx.xxx.xxx.xxx:8080/gexflow/ws/Registro_v2.0?wsdl     where xxx.xxx.xxx.xxx is the IP address (for instance 110.12.3.1) 2. Download Apache CXF. 3. Extract into a folder 3.1. Verify that you have set the variable JAVA_HOME to the folder where the java is installed, now you can use java >9. For instance, you can type in the terminal:     export JAVA_HOME=/usr/java/jdk-13.0.2 //in java version >13 doesn't work  using apache cxf 3.3.6 version, but java 17 works in csf version 3.5.4 3.2. Verify that the " bin" directory of the apache-cxf-xxxxx directory is available in the path.  For instance, you can type in the terminal:      export PATH=$PATH:/home/ximo/MyPrograms/apache-cxf-3.3.6/bi...
Read more