Copyright © 2001, 2002, 2003, 2008 Thai Open Source Software Center Ltd
See the file copying.html for copying permission.
This version of Jing implements
Jing also has experimental support for schema languages other than RELAX NG; specifically
A separate document describes this support in more detail.
Jing has a command-line user interface. It has no graphical user interface.
Jing is available for download as the file jing-20081028.zip, which contains binaries, source code and documentation. It requires a Java runtime compatible with the Java 2 Platform, Standard Edition (J2SE) version 1.4 (or any later version), such as the Java Runtime Environment (JRE), which can be downloaded here.
The latest version of Jing will always be available in the Downloads section of the project site.
Once you have installed a suitable Java runtime, you can run Jing by using the command:
java -jar jing.jar options schema XMLfile...
schema is the name of the file
containing the schema, and
XMLfile... are the
names of one or more XML files to be validated against this schema,
options are zero or more
schema is correct, and
XMLfile... is valid with respect to
schema, then Jing will generate no output.
Otherwise, it will generate one or more error messages.
The following options are available:
encto read the schema.
attributeelement in an
optionalelement and then validating against the transformed schema. This option may be useful while a document is still under construction. This option also disables checking that for every IDREF there is a corresponding ID.
When you use
jing.jar with the
option, any jar files that have the same names as the jar files
included with the Jing download and are in the same directory
jing.jar will be used automatically (i.e. they will be
added to the classpath), specifically:
Note that, when using the
-jar option, the JRE will
ignore any additional class path entries specified by
-classpath options or by
CLASSPATH environment variable.
If you do not want use the
-jar option (perhaps
because you want to use some other
.jar files not
included with with Jing), then you must explicitly include all the
.jar files with a
-classpath option or with the
environment variable, and specify the main class name as
com.thaiopensource.relaxng.util.Driver. For example,
on Linux you could do you could do:
java -classpath path-to-dist/jing-20081028/bin/jing.jar com.thaiopensource.relaxng.util.Driver file.rng file.xml
This would use just
jing.jar and the standard Java
Jing uses a vendor-independent pluggable datatypes API that allows datatype libraries to be added at runtime and be interoperable with Java-based RELAX NG implementation that supports the API.
Jing also includes an implementation of a datatype library for the W3C XML Schema Part 2 datatypes. There is a separate document describing this implementation and how to use it.
If you wish to use Jing in your programs, you have a choice.
There is a Jing task that allows Jing to be invoked by the Ant build tool.
Development of Jing, together with Trang, takes place in the jing-trang project, which is hosted on Google Code.
If you find a bug or would like to request an enhancement, please create a new issue in the Issues section of the project site. You can talk with other users of Jing on the rng-users mailing list.
If you want to make changes to Jing, you should check out the source code from the project's Subversion repository. (The source code included in the Jing download is for reference purposes, and doesn't contain the supporting files, such as build scripts and test cases, that are needed for working conveniently with the source code.)James Clark