Installation

XML Manager is packaged in three forms:

• .jar installer
• .zip file
• .tgz file

.jar Installer

This is a self-extracting Java program. To install, double click on the .jar file and the installer will start. Follow the installer instructions to complete the installation. Alternatively, you can run the installer by executing the following command:

java -jar xml-s-sd-1-1.jar

.zip and .tgz Files

If you have downloaded XML Manager as a .zip or .tgz file, then unpack the files using Winzip on Windows or

tar -xzf xml-s-sd-1-1.tgz

Integration

XML Manager is a Java component supplied as a jar file. In order to access the component from your application, make sure that the lib/xmlman.jar file is in your Java CLASSPATH. Then you will be able to use the XmlManager class by placing the following import statement in your Java source code:

import com.ricebridge.xmlman.*;

Here are two possible ways of setting your CLASSPATH: for the command prompt and for your IDE.

Command Prompt

On Windows, open the System applet from the Control Panel, and set the CLASSPATH as an environment variable. On UNIX systems such as Linux, you will need to edit a shell startup script such as .bash_profile, and add or edit the line export CLASSPATH=/path/to/xmlman.jar. For more information, see the Sun Microsystems documentation on setting your CLASSPATH, for Windows, and for UNIX.

Eclipse and Other IDEs

In general, you have to specify the CLASSPATH for each project that you have created. For example, in Eclipse, open the project properties by right-clicking on the project name and go to the Java Build Path settings. Add xmlman.jar as a Library jar. For other IDEs, you will have to perform a similar operation. Please refer to the documentation for your IDE.

After installation, the first thing you should do is read the Getting Started Guide, which will show you the basics of loading and saving XML files.