http://xml.apache.org/http://www.apache.org/http://www.w3.org/

Readme
Installation

API Docs
Samples
Schema

Properties
Features
FAQs

Releases
Caveats
Feedback

Y2K Compliance

Questions
 

Answers
 
Which version of Swing is required?
 

This release uses Swing 1.1 (JFC 1.1). Swing is only used by the sample programs and is not required by the parser itself.


How do I recompile the source files?
 

To build Xerces on Windows, you need a copy of Cygnus's Cygwin. See http://sourceware.cygnus.com/cygwin. Once Cygwin is installed, you need to set two environment variables. Edit the batch file BuildAll.bat to set these variables. Execute BuildAll.bat, and then set your classpath to point to the src and samples directories in the Xerces distribution. You can then go to the top of the Xerces tree and type 'make'.

To build Xerces Java on UNIX, you need to set an environment variable. Edit the shell script BuildAll to set this variables. Execute BuildAll, and then set your classpath to point to the src and samples directories in the Xerces distribution. You can then go to the top of the Xerces tree and type 'make'.


How do I regenerate the api documentation?
 

To regenerate the api documentation, you need to set up your environment to build Xerces. Instead of typing 'make', you type 'make apidocs'.


How do I import Xerces into Visual Age for Java
 
  • Why does VisualAge for Java 2.0 report problems when I import the Xerces parser?
    The current version of the Xerces parser uses Swing 1.1, while VisualAge for Java 2.0 comes with Swing 1.0.2. The free update for the Professional version of VisualAge for Java 2.0 installs Swing 1.0.3. The most important difference between Swing 1.0.2 - 1.0.3 and 1.1 is the Java package was changed from com.sun.java.swing.* to javax.swing.*.
    To fix the errors, you must download the Java Foundation Classes 1.1 with Swing 1.1 from Sun's Java home page and import the "swingall.jar" file into VisualAge for Java 2.0. The Swing 1.1 package can be found at the following URL:
    http://java.sun.com/products/jfc/index.html
    Refer to the VisualAge for Java 2.0 documentation for information about how to import a JAR file into the repository and add that code to your workspace.
  • Are there any other tips for importing the Xerces parser into VisualAge for Java 2.0?
    The most useful tip applies to *any* updated code that you import into the VisualAge for Java 2.0 product. Before updating code, do the following:
    1. version the old code
    2. delete it from your workspace
    3. import the new code
    Deleting code from your workspace does not actually delete the code permanently -- the versioned code is moved to the repository where it can be retrieved later. Be aware, though, that removing code from your workspace will cause problems with all of the other classes that use that code. VisualAge for Java 2.0 will flag them as errors but this situation is temporary. When you import the new code, the errors found when deleting the old code will be fixed.
    If you are unsure as to how to perform any of these steps, refer to the VisualAge for Java 2.0 documentation.

Is this Xerces version 100% pure Java compliant?
 

blah


How do I get Xerces to run on the Mac under MRJ?
 

Prerequisites (available from http://developer.apple.com/java/):

  • MRJ 2.1 (this is the most recent version of the JVM)
  • MRJ SDK 2.1 (this is the most recent version of the Java developer tools)

Instructions (other variations would work also):

  1. Download the .tar.gz file containing Xerces.
  2. Use Stuffit Expander(tm), Suntar, or some other Macintosh tool that
    supports the .tar.gz format to expand the downloaded file.
  3. JBindery, part of MRJ SDK 2.1, is used to create a double-clickable Java application with the necessary configuration information built in. It is analogous to writing a .bat or .sh script.
  4. To run the dom.DOMWriter example:
    1. Double click on JBindery to start it up.
    2. Click on the Classpath panel.
    3. Click on the "Add .zip File" button and add both the "Xerces-J.jar" and "Xerces-JSamples.jar" files.
    4. Click on the Command panel.
    5. Enter "dom.DOMWriter" as the Class name. Enter "data/personal.xml" in the Optional parameters box.
    6. Click on Save Settings button, pick a name such as "Run dom.DOMWriter" for the file, and be sure that "Save as Application" is selected (this is the default) and save the file.
    7. Quit JBindery.
    8. You can now double click on the file you created in step f to run the XJParse example.

Why do I get ArrayIndexOutOfBoundsException in the Symantec Visual Cafe debugger?
 

Visual Cafe's debugger is set to trap ArrayIndexOutOfBoundsException's by default. Xerces uses ArrayIndexOutOfBoundsException internally to signal exceptional, but not erroneous conditions. In order to run Xerces2 inside Visual Cafe's debugger, you need to turn off the trapping of these exceptions.

To do this:

  1. Select the "Options" item in the "Project" menu.
  2. Select the "Debugger" tab in the dialog which appears.
  3. Select "Exceptions" from the popup menu.
  4. Remove the check from the checkbox for java.lang.ArrayIndexOutOfBoundsException.



Copyright © 1999 The Apache Software Foundation. All Rights Reserved.