45

I would like to introduce caching into an existing Spring project which uses JAXB to expose WebServices. Caching will be done on the level of end points. In order to do that classes generated from XSD using JAXB need to implement Serializable interface and override Object's toString() method.

How to instruct the xjc tool using XSD to generate source with needed properties?

JasonMArcher
  • 12,386
  • 20
  • 54
  • 51
Boris Pavlović
  • 58,387
  • 26
  • 115
  • 142

6 Answers6

77

Serializable

Use xjc:serializable in a custom bindings file to add the java.io.Serializable interface to your classes along with a serialVersionUID: 

<?xml version="1.0" encoding="UTF-8"?>
<bindings xmlns="http://java.sun.com/xml/ns/jaxb"
            xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance"
            xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
            xsi:schemaLocation="
http://java.sun.com/xml/ns/jaxb http://java.sun.com/xml/ns/jaxb/bindingschema_2_0.xsd"
version="2.1">
  <globalBindings>
    <serializable uid="1" />
  </globalBindings>
</bindings>

toString()

Use a superclass (see xjc:superClass) from which all your bound classes will inherit. This class won’t be generated by xjc so you are free to create it as you please (here with a toString() implementation): 

<?xml version="1.0" encoding="UTF-8"?>
<bindings xmlns="http://java.sun.com/xml/ns/jaxb"
                xmlns:xsi="http://www.w3.org/2000/10/XMLSchema-instance"
                xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc"
                xsi:schemaLocation="
http://java.sun.com/xml/ns/jaxb http://java.sun.com/xml/ns/jaxb/bindingschema_2_0.xsd"
    version="2.1">
    <globalBindings>
        <serializable uid="1" />
        <xjc:superClass name="the.package.to.my.XmlSuperClass" />
    </globalBindings>
</bindings>
Pascal Thivent
  • 535,937
  • 127
  • 1,027
  • 1,106
  • 2
    Thanks for the great answer. Would you use apache commons lang ToStringBuilder's toString builder based on reflection? – Boris Pavlović Oct 05 '09 at 07:44
  • Yes, it's a good choice in your case (actually, I don't think you have many other options). – Pascal Thivent Oct 05 '09 at 09:47
  • Actually, there is: Pojomatic (http://pojomatic.sourceforge.net/pojomatic/index.html) – Boris Pavlović Apr 29 '10 at 15:50
  • @Pascal: I believe, in the example one need to say ``, as the default namespace is different from `xjc`. – dma_k Nov 04 '10 at 13:43
  • 4
    After applying `` I've got `@XmlValue is not allowed on a class that derives another class`. The solution is: add `@javax.xml.bind.annotation.XmlTransient` annotation to base class (see here: http://sites.google.com/site/codingkb/java-2/jaxb/jaxb-4) – dma_k Nov 04 '10 at 15:33
  • Is there a way to tell xjc that only some of the classes extend XMLSuperClass? – Chobicus Aug 08 '12 at 08:57
  • For more information about how to use a bindings file in maven, see http://stackoverflow.com/a/903629/496166. – kevinmrohr Oct 29 '12 at 16:42
  • I had to put the answer in a bindings.xml file and add `jaxb:` in front of the tags (e.g: `jaxb:bindings`) and `xjc:serializable` and ran this in the console: `xjc -extension -d out -b bindings.xml yourSchema.xsd` – Shehaaz Mar 07 '16 at 00:29
  • You don't need `extensionBindingPrefixes="xjc"`? – OrangeDog Jan 03 '17 at 16:26
8

This worked for me:

<?xml version="1.0" encoding="UTF-8"?>
<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc" jaxb:version="2.1">
    <jaxb:globalBindings>
        <xjc:serializable uid="1337"/>
    </jaxb:globalBindings>
</jaxb:bindings>
halfer
  • 18,701
  • 13
  • 79
  • 158
vikingsteve
  • 34,284
  • 19
  • 101
  • 142
5

Another way to generate toString() method - JAXB2 Basics Plugins. This way looks better because doesn't use reflection. Example how to do it with maven below.

<build>
    <plugins>
        <plugin>
            <groupId>org.jvnet.jaxb2.maven2</groupId>
            <artifactId>maven-jaxb2-plugin</artifactId>
            <version>0.8.2</version>
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <schemaDirectory>
                    ${project.basedir}/src/main/resources
                </schemaDirectory>
                <generateDirectory>
                    ${project.basedir}/src/main/java
                </generateDirectory>
                <extension>true</extension>
                <args>
                    <arg>-XtoString</arg>
                </args>
                <plugins>
                    <plugin>
                        <groupId>org.jvnet.jaxb2_commons</groupId>
                        <artifactId>jaxb2-basics</artifactId>
                        <version>0.6.4</version>
                    </plugin>
                </plugins>
            </configuration>
        </plugin>
    </plugins>
</build>

<dependencies>
    <dependency>
        <groupId>org.jvnet.jaxb2_commons</groupId>
        <artifactId>jaxb2-basics-runtime</artifactId>
        <version>0.6.4</version>
    </dependency>
</dependencies>

As the result you'll get such code.

public String toString() {
    final ToStringStrategy strategy = JAXBToStringStrategy.INSTANCE;
    final StringBuilder buffer = new StringBuilder();
    append(null, buffer, strategy);
    return buffer.toString();
}

public StringBuilder append(ObjectLocator locator, StringBuilder buffer, ToStringStrategy strategy) {
    strategy.appendStart(locator, this, buffer);
    appendFields(locator, buffer, strategy);
    strategy.appendEnd(locator, this, buffer);
    return buffer;
}

public StringBuilder appendFields(ObjectLocator locator, StringBuilder buffer, ToStringStrategy strategy) {
    {
        String theName;
        theName = this.getName();
        strategy.appendField(locator, this, "name", buffer, theName);
    }
    {
        String theBank;
        theBank = this.getBank();
        strategy.appendField(locator, this, "bank", buffer, theBank);
    }
    return buffer;
}
artspb
  • 1,001
  • 1
  • 12
  • 19
2

i use this code and is work for me

<?xml version="1.0" encoding="UTF-8"?>
<jaxb:bindings xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" xmlns:xjc="http://java.sun.com/xml/ns/jaxb/xjc" jaxb:version="2.1">
    <jaxb:globalBindings>
        <xjc:serializable uid="1"/><!--If you Forgot this line your class did not be serializable--!>
    </jaxb:globalBindings>
</jaxb:bindings>
BERGUIGA Mohamed Amine
  • 5,202
  • 3
  • 34
  • 32
1

in order to get interface Serializable add following binding information to the xsd-file:

<?xml version="1.0" encoding="UTF-8"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:jaxb="http://java.sun.com/xml/ns/jaxb" jaxb:version="2.0"> <xs:annotation> <xs:appinfo> <jaxb:globalBindings optionalProperty="primitive"> <jaxb:serializable/> </jaxb:globalBindings> </xs:appinfo> </xs:annotation> <xs:element name="myXsdElement"> ..... </xs:element> </xs:schema>

Gio
  • 611
  • 6
  • 10
1

And here is a sample using CXF 3.1.10. Remember to include compile group: 'org.apache.cxf.xjc-utils', name: 'cxf-xjc-runtime', version: '3.1.0'

<jxb:bindings 
xmlns:xs="http://www.w3.org/2001/XMLSchema"
xmlns:jxb="http://java.sun.com/xml/ns/jaxb"
version="2.1">

<jxb:bindings schemaLocation="META-INF/wsdl/xsd2.xsd">

        <jxb:globalBindings xmlns:jxb="http://java.sun.com/xml/ns/jaxb" xmlns:xs="http://www.w3.org/2001/XMLSchema">
                <jxb:serializable uid="1"/>
              </jxb:globalBindings>
Jacques Koorts
  • 1,655
  • 1
  • 14
  • 10