XML Code Generator for Java
XML Data Binding
This 60 second overview shows you the basic concept of generating source code from an XML Schema using Liquid XML Data Binder.
What is XML Data Binding?
XML Data Binding enables you to load XML Documents into a strongly typed object model within your source code.
Meaning fewer coding errors, reduced development and testing time, increased conformance and coding reliability.
Liquid XML Data Binder Features
- Generates an easy to use class library for Java.
- Generated HTML documentation for your class library API.
- Supports Smart Device platforms Android and iOS.
- Supports W3C XML Schema XSD, XDR and DTD standards.
- Supports JSON serialization.
- Support for the most complex XML standards.
- Royalty free distribution of compiled code and runtime.
XML Code Generator for Java
Platform Support
The Java generated code compiles to a single jar using a provided ANT build script. The resulting code can be used on java 1.4, 1.5 (and above) and JME.
Ease of Use
Strongly Typed Code
Liquid XML Data Binder creates simple intuitive code from your XML Schema. The generated code library contains strongly typed classes, collections, and enumerations to create an intuitive custom API to code against. Allowing you to concentrate on writing your Business logic code.
Collections
Collections are strongly typed using the standard generics template.
Properties
The generated classes expose the values in the XML as simple properties (getters and setters) allowing values to be easily manipulated.
Customisable Code
The generated output may also be modified within special 'Hand Coded Blocks', changes inside these blocks are persisted when the library is re-generated, allowing the library to be customised to fit the projects needs.
A Simple XML Data Binding Example for JAVA
The following Java example we will use the Person.xsd, shown below to demonstrate how to read and write an XML document based on this schema.
<?xml version="1.0" encoding="utf-8" ?>
<!--Created with Liquid Studio -->
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xs:element name="Person">
<xs:complexType>
<xs:sequence>
<xs:element name="Name" type="xs:string" />
<xs:element name="DateOfBirth" type="xs:date" />
<xs:element minOccurs="0" name="Address">
<xs:complexType>
<xs:sequence>
<xs:element name="HouseNo" type="xs:int" />
<xs:element name="PostCode" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
<xs:element minOccurs="0" maxOccurs="unbounded" name="Car">
<xs:complexType>
<xs:sequence>
<xs:element name="Make" type="xs:string" />
<xs:element name="Model" type="xs:string" />
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
<?xml version="1.0" encoding="utf-8" ?>
<!--Created with Liquid Studio -->
<Person>
<Name>Fred</Name>
<DateOfBirth>1978-06-26</DateOfBirth>
<Address>
<HouseNo>7</HouseNo>
<PostCode>WV6 6JY</PostCode>
</Address>
<Car>
<Make>Escort</Make>
<Model>Ford</Model>
</Car>
<Car>
<Make>Elise</Make>
<Model>Lotus</Model>
</Car>
</Person>
Example Java code to create the PersonSample.xml document using the strongly typed XML Data Binding generated code:
// create the root item 'person'
Person person = new Person();
person.setName("Fred");
person.setDateOfBirth(new DateTime(1978, 6, 26));
// add 'address'
Address address = new Address();
person.setAddress(address);
address.setHouseNo(7);
address.setPostCode("WV6 6JY");
// add 'car1' cars to collection
Car car1 = new Car();
person.getCars().add(car1);
car1.setMake("Ford");
car1.setModel("Escort");
// add 'car2' cars to collection
Car car2 = new Car();
person.getCars().add(car2);
car2.setMake("Lotus");
car2.setModel("Elise");
// write xml document to string
System.out.println(person.toXml());
// write xml document to file
person.toXmlFile("SampleFile.xml");
The XML Data Binding code is much easier to read and more concise than equivalent code written using generic DOM technology.
The strongly typed API allows errors to be detected at compile time should the data model change as opposed to DOM code where any errors will only be picked up in testing.
Example Java code to read the PersonSample.xml document using XML Data Binding:
// create the root item 'person'
Person person = new Person();
// load the items into the model
person.fromXmlFile("SampleFile.xml");
// read items from the model
System.out.println(person.getName() +
" was born " + person.getDateOfBirth().toString()
+ ", and lives at " + person.getAddress().getHouseNo() + ", "
+ person.getAddress().getPostCode());
System.out.println("Cars Owned " + person.getCars().count());
for (int i = 0; i < person.getCars().count(); i++) {
Car car = person.getCars().getItem(i);
System.out.println(" " + car.getMake() + ", " + car.getModel());
}
The XML Data Binding code provides the majority of the parsing for you, so manipulating the XML objects is a simple task of dealing with collections of strongly typed objects.
This is much easier than using generic DOM code, where you need to continually check the data type of an item.
In Summary
Easier to Code
XML Data Binding makes it significantly easier to deal with XML documents from within your Java code, resulting in less code, which is simpler to read and maintain.
Easier to Test
As the generated class library is strongly typed, it forms a template for the developer, ensuring that the data created is valid and conforms to the underlying XML Schema.
Easier to Maintain
The maintenance phase of a project also befits as XML Data Binding allows any errors introduced because of changes in the data model to be caught early at compile time, unlike weakly typed DOM trees, which will give no indication of a problem until runtime. These kinds of changes can be a major cause of bugs which can only be caught in testing. Being able to identify these at compile time can save a significant amount of time and effort.
