Skip to main content

Source code browse

Revision: 2100

update copyright
» Project Revision History

» Checkout URL

svn / trunk

FilenameAuthorRevisionModifiedLog Entry
Elliotte Harold 2066 over 6 years ago Upgrading version number to 1.2....
Elliotte Harold 2098 almost 4 years ago Change version to 1.2.10
Elliotte Harold 2097 almost 4 years ago Change version to 1.2.10
Elliotte Harold 2100 over 3 years ago update copyright
Elliotte Harold 1056 over 12 years ago Sticking JDK15XML1_)Parser ,.cla...
Elliotte Harold 2084 almost 6 years ago More test cases for proper handl...
Elliotte Harold 1809 over 11 years ago Assorted fixes to make this comp...
Elliotte Harold 2067 over 6 years ago Upgrading Jaxen to 1.1.3
Elliotte Harold 2095 about 4 years ago Upgrade to jaxen 1.1.6
Elliotte Harold 1271 about 12 years ago Bundling LGPL with distro
Elliotte Harold 2012 almost 8 years ago Repackaging Jaxen to avoid accid...
Elliotte Harold 1395 about 12 years ago Noting support for XPath
Elliotte Harold 2042 over 7 years ago xmlParserAPIs --> xml-apis
Elliotte Harold 2061 almost 7 years ago project.xml using the Maven 2 sy...
Elliotte Harold 2099 over 3 years ago Convert anonymous inner class to...
Elliotte Harold 970 over 12 years ago Working around bugs in JDK 1.5 b...
tigrisc 2 over 13 years ago Commit by Helm::Ccvs
Elliotte Harold 1200 about 12 years ago Omnigraffle class hierarchy diag...
XOM is a library. By itself, it doesn't do much of anything. It exists
only to be used by other programs. It requires Java 1.2 or later. 

To install it you'll need to place the XOM JAR archive somewhere in your
CLASSPATH. This archive is the file named something like xom-1.2.10.jar. 
(The version number may have changed if I've forgotten
to update this document.) You can either put it in your jre/lib/ext
directory, add xom-1.2.10.jar to your CLASSPATH environment variable, or
use the -classpath option when invoking javac and java.

To check your download you can run one of the sample programs found in
the xom-samples.jar file. For instance, nu.xom.samples.PrettyPrinter
class formats an XML document by inserting and removing white space
around element boundaries. In Java 1.4 and later you can run it from the
command line like this:

$ java -classpath xom-samples.jar:xom-1.2.10.jar nu.xom.samples.PrettyPrinter filename.xml

Java 1.3 and earlier do not have a built-in XML parser so in these environments 
you'll also need to install XOM's supporting libraries. 
These include xalan.jar, xercesImpl.jar, and xml-apis.jar, 
and are found in the lib directory. The versions shipped with XOM 
are quite a bit faster and less buggy than the ones bundled with the JDK, 
so you may well want to use them even in Java 1.4 and later. For example,

$ java -classpath xom-samples.jar:xom-1.2.10.jar:lib/xml-apis.jar:lib/xercesImpl.jar:lib/xalan.jar nu.xom.samples.PrettyPrinter filename.xml

You could leave out xalan.jar if you don't use any of the classes in
nu.xom.xslt. junit.jar is only used for testing, and is
not needed for normal operation of XOM.

If you want to build XOM from source, you'll need to have Apache Ant
installed. See Once Ant is installed, building
should be as simple as typing "ant compile" or "ant jar" in the xom
directory. Type "ant help" to see other possible options. Most of the
targets build in Ant 1.5 or later. However the betterdocs target
requires Ant 1.6.

XOM is Copyright 2004, 2005, 2009 Elliotte Rusty Harold
   This library is free software; you can redistribute it and/or modify
   it under the terms of version 2.1 of the GNU Lesser General Public 
   License as published by the Free Software Foundation.
   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   GNU Lesser General Public License for more details.
   You should have received a copy of the GNU Lesser General Public
   License along with this library; if not, write to the 
   Free Software Foundation, Inc., 59 Temple Place, Suite 330, 
   Boston, MA 02111-1307  USA
You can contact Elliotte Rusty Harold by sending e-mail to Please include the word "XOM" in the
subject line. For more information see 
or ask a question on the xom-interest mailing list.
Please Confirm