Xineo XIL

About

Xineo XIL (XML Import Langage) defines an XML language for transforming various record-based data sources into XML documents, and provides a fully functional XIL processing implementation. This implementation has built-in support for relational (via JDBC) and structured text (like CSV) sources, and is extensible thanks to its public API, allowing dynamic integration of new data source implementations.

Xineo XIL is published under the LGPL licence.

Files contained in this package

• doc/: documentation files, including :
  • This file.
  • The Xineo XIL tutorial.
  • The Xineo XIL built-in data sources reference.
  • The API documentation generated by javadoc.
• net/: source code.
• schema/: XML schemas.
• test/: demo source code.
• xineo-xil-[version].jar: java archive containg the pre-complied binaries.
• build.xml: Build file to be used with Ant.

Installation

Important note : The Xineo XIL processor needs a 1.4.0 or newer version of the Java virtual machine, which can be downloaded here.

If you downloaded the ".zip" distribution, just unzip the package at the place of your choice. If you downloaded the ".jar" distribution, place this file at the place of your choice.

To use Xineo XIL as a library, you just need to put xineo-xml-X.X.X.jar in your classpath in order to use it. To do so, you can modify your CLASSPATH environment variable, or mount the jar using your favorite Java IDE (please refer to appropriate documentation).

You also need to have a JAXP implementation available (at least the SAX-related part). If you use the 1.4 version of the JDK, you can use the built-in implementation. If you don't want to do so, or use a previous version of the JDK, you should consider using Xerces or Crimson, both available from the Apache XML Project.

To use JDBC sources, you need a suitable driver for the database server you wish to access. Please take a look at http://java.sun.com/jdbc for more information about available drivers.

Running Xineo XIL

The simpliest way to run Xineo XIL as a command-line tool is: "java -jar xineo-xil-X.X.X.jar <parameters>". You may also put the ".jar" in your CLASSPATH and run the "net.xineo.xml.xil.Main" class.

The usage is : [inputFile [outputFile [outputEncoding [property=value ...]]]]. Using "-" instead of "inputFile" or "outputFile" will use respectively the standard input and/or output. Default output encoding is UTF-8.