kenai_tools 0.0.7

data/spec/fixtures/data/sax2/src/SAXTest.java

@@ -0,0 +1,351 @@
+// SAXTest.java - test application for SAX2
+
+import java.io.IOException;
+
+import java.net.MalformedURLException;
+import java.net.URL;
+
+import org.xml.sax.Attributes;
+import org.xml.sax.ContentHandler;
+import org.xml.sax.ErrorHandler;
+import org.xml.sax.Locator;
+import org.xml.sax.SAXException;
+import org.xml.sax.SAXNotRecognizedException;
+import org.xml.sax.SAXNotSupportedException;
+import org.xml.sax.SAXParseException;
+import org.xml.sax.XMLReader;
+
+import org.xml.sax.helpers.XMLReaderFactory;
+
+
+/**
+ * Test class for SAX2.
+ */
+public class SAXTest implements ContentHandler, ErrorHandler
+{
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Main app.
+    ////////////////////////////////////////////////////////////////////
+
+
+    /**
+     * Main application entry point.
+     */
+    public static void main (String args[])
+    {
+
+	System.out.println("************************************" +
+			   "************************************");
+	System.out.println("* Testing SAX2");
+	System.out.println("************************************" +
+			   "************************************");
+	System.out.print("\n");
+
+	//
+	// Figure out the XML reader
+	//
+
+	String driverName =
+	    System.getProperty("org.xml.sax.driver",
+			       "org.apache.xerces.parsers.SAXParser");
+	System.out.println("SAX driver class: " +
+			   driverName +
+			   "\n  (you can specify a different one using the " +
+			   "org.xml.sax.driver property)");
+	System.out.print("\n");
+
+
+	//
+	// Create the XML reader
+	//
+
+	System.out.println("Now, we'll try to create an instance of the " +
+			   "driver, using XMLReaderFactory");
+	XMLReader reader = null;
+	try {
+	    reader = XMLReaderFactory.createXMLReader(driverName);
+	} catch (SAXException e) {
+	    System.out.println("Failed to create XMLReader: " +
+			       e.getMessage() +
+			       "\nMake sure that the class actually " +
+			       "exists and is present on your CLASSPATH" +
+			       "\nor specify a different class using the " +
+			       "org.xml.sax.driver property");
+	    System.exit(1);
+	}
+	System.out.println("XMLReader created successfully\n");
+
+
+	//
+	// Check features.
+	//
+	System.out.println("Checking defaults for some well-known features:");
+	checkFeature(reader, "http://xml.org/sax/features/namespaces");
+	checkFeature(reader, "http://xml.org/sax/features/namespace-prefixes");
+	checkFeature(reader, "http://xml.org/sax/features/string-interning");
+	checkFeature(reader, "http://xml.org/sax/features/validation");
+	checkFeature(reader,
+		     "http://xml.org/sax/features/external-general-entities");
+	checkFeature(reader,
+		     "http://xml.org/sax/features/external-parameter-entities");
+	System.out.print("\n");
+
+	
+	//
+	// Assign handlers.
+	//
+	System.out.println("Creating and assigning handlers\n");
+	SAXTest handler = new SAXTest();
+	reader.setContentHandler(handler);
+	reader.setErrorHandler(handler);
+
+	//
+	// Parse documents.
+	//
+	if (args.length > 0) {
+	    for (int i = 0; i < args.length; i++) {
+		String systemId = makeAbsoluteURL(args[i]);
+		System.out.println("Trying file " + systemId);
+		try {
+		    reader.parse(systemId);
+		} catch (SAXException e1) {
+		    System.out.println(systemId +
+				       " failed with XML error: " +
+				       e1.getMessage());
+		} catch (IOException e2) {
+		    System.out.println(systemId +
+				       " failed with I/O error: " +
+				       e2.getMessage());
+		}
+		System.out.print("\n");
+	    }
+	} else {
+	    System.out.println("No documents supplied on command line; " +
+			       "parsing skipped.");
+	}
+
+
+	//
+	// Done.
+	//
+	System.out.println("SAX2 test finished.");
+    }
+
+
+    /**
+     * Check and display the value of a feature.
+     */
+    private static void checkFeature (XMLReader reader, String name)
+    {
+	try {
+	    System.out.println("  " +
+			       name +
+			       " = " +
+			       reader.getFeature(name));
+	} catch (SAXNotRecognizedException e) {
+	    System.out.println("XMLReader does not recognize feature " +
+			       name);
+	} catch (SAXNotSupportedException e) {
+	    System.out.println("XMLReader recognizes feature " +
+			       name +
+			       " but does not support checking its value");
+	}
+    }
+
+
+    /**
+     * Construct an absolute URL if necessary.
+     *
+     * This method is useful for relative file paths on a command
+     * line; it converts them to absolute file: URLs, using the
+     * correct path separator.  This method is based on an
+     * original suggestion by James Clark.
+     *
+     * @param url The (possibly relative) URL.
+     * @return An absolute URL of some sort.
+     */
+    private static String makeAbsoluteURL (String url)
+    {
+	URL baseURL;
+	
+	String currentDirectory = System.getProperty("user.dir");
+	String fileSep = System.getProperty("file.separator");
+	String file = currentDirectory.replace(fileSep.charAt(0), '/') + '/';
+	
+	if (file.charAt(0) != '/') {
+	    file = "/" + file;
+	}
+
+	try {
+	    baseURL = new URL("file", null, file);
+	    return new URL(baseURL, url).toString();
+	} catch (MalformedURLException e) {
+	    System.err.println(url + ": " + e.getMessage());
+	    return url;
+	}
+    }
+
+    private static String makeNSName (String uri, String localName,
+				      String qName)
+    {
+	if (uri.equals("")) 
+	    uri = "[none]";
+	if (localName.equals(""))
+	    localName = "[none]";
+	if (qName.equals(""))
+	    qName = "[none]";
+	return uri + '/' + localName + '/' + qName;
+    }
+
+    private static String escapeData (char ch[], int start, int length)
+    {
+	StringBuffer buf = new StringBuffer();
+	for (int i = start; i < start + length; i++) {
+	    switch(ch[i]) {
+	    case '\n':
+		buf.append("\\n");
+		break;
+	    case '\t':
+		buf.append("\\t");
+		break;
+	    case '\r':
+		buf.append("\\r");
+		break;
+	    default:
+		buf.append(ch[i]);
+		break;
+	    }
+	}
+	return buf.toString();
+    }
+
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Implementation of org.xml.sax.ContentHandler.
+    ////////////////////////////////////////////////////////////////////
+
+    public void setDocumentLocator (Locator locator)
+    {
+	System.out.println("  EVENT: setDocumentLocator");
+    }
+
+    public void startDocument ()
+	throws SAXException
+    {
+	System.out.println("  EVENT: startDocument");
+    }
+
+    public void endDocument ()
+	throws SAXException
+    {
+	System.out.println("  EVENT: endDocument");
+    }
+
+    public void startPrefixMapping (String prefix, String uri)
+	throws SAXException
+    {
+	System.out.println("  EVENT: startPrefixMapping " +
+			   prefix + " = " + uri);
+    }
+
+    public void endPrefixMapping (String prefix)
+	throws SAXException
+    {
+	System.out.println("  EVENT: endPrefixMapping " + prefix);
+    }
+
+    public void startElement (String namespaceURI, String localName,
+			      String qName, Attributes atts)
+	throws SAXException
+    {
+	System.out.println("  EVENT: startElement " +
+			   makeNSName(namespaceURI, localName, qName));
+	int attLen = atts.getLength();
+	for (int i = 0; i < attLen; i++) {
+	    char ch[] = atts.getValue(i).toCharArray();
+	    System.out.println("    Attribute " +
+			       makeNSName(atts.getURI(i),
+					  atts.getLocalName(i),
+					  atts.getQName(i)) +
+			       '=' +
+			       escapeData(ch, 0, ch.length));
+	}
+    }
+
+    public void endElement (String namespaceURI, String localName,
+			    String qName)
+	throws SAXException
+    {
+	System.out.println("  EVENT: endElement " +
+			   makeNSName(namespaceURI, localName, qName));
+    }
+
+    public void characters (char ch[], int start, int length)
+	throws SAXException
+    {
+	System.out.println("  EVENT: characters " +
+			   escapeData(ch, start, length));
+    }
+
+    public void ignorableWhitespace (char ch[], int start, int length)
+	throws SAXException
+    {
+	System.out.println("  EVENT: ignorableWhitespace " +
+			   escapeData(ch, start, length));
+    }
+
+    public void processingInstruction (String target, String data)
+	throws SAXException
+    {
+	System.out.println("  EVENT: processingInstruction " +
+			   target + ' ' + data);
+    }
+
+    public void skippedEntity (String name)
+	throws SAXException
+    {
+	System.out.println("  EVENT: skippedEntity " + name);
+    }
+
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Implementation of org.xml.sax.ErrorHandler.
+    ////////////////////////////////////////////////////////////////////
+
+    public void warning (SAXParseException e)
+	throws SAXException
+    {
+	System.out.println("  EVENT: warning " +
+			   e.getMessage() + ' ' +
+			   e.getSystemId() + ' ' +
+			   e.getLineNumber() + ' ' +
+			   e.getColumnNumber());
+    }
+
+    public void error (SAXParseException e)
+	throws SAXException
+    {
+	System.out.println("  EVENT: error " +
+			   e.getMessage() + ' ' +
+			   e.getSystemId() + ' ' +
+			   e.getLineNumber() + ' ' +
+			   e.getColumnNumber());
+    }
+
+    public void fatalError (SAXParseException e)
+	throws SAXException
+    {
+	System.out.println("  EVENT: fatal error " +
+			   e.getMessage() + ' ' +
+			   e.getSystemId() + ' ' +
+			   e.getLineNumber() + ' ' +
+			   e.getColumnNumber());
+    }
+
+}
+
+// end of SAXTest.java

data/spec/fixtures/data/sax2/src/org/xml/sax/Attributes.java

@@ -0,0 +1,257 @@
+// Attributes.java - attribute list with Namespace support
+// http://www.saxproject.org
+// Written by David Megginson
+// NO WARRANTY!  This class is in the public domain.
+// $Id: Attributes.java,v 1.13 2004/03/18 12:28:05 dmegginson Exp $
+
+package org.xml.sax;
+
+
+/**
+ * Interface for a list of XML attributes.
+ *
+ * <blockquote>
+ * <em>This module, both source code and documentation, is in the
+ * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
+ * See <a href='http://www.saxproject.org'>http://www.saxproject.org</a>
+ * for further information.
+ * </blockquote>
+ *
+ * <p>This interface allows access to a list of attributes in
+ * three different ways:</p>
+ *
+ * <ol>
+ * <li>by attribute index;</li>
+ * <li>by Namespace-qualified name; or</li>
+ * <li>by qualified (prefixed) name.</li>
+ * </ol>
+ *
+ * <p>The list will not contain attributes that were declared
+ * #IMPLIED but not specified in the start tag.  It will also not
+ * contain attributes used as Namespace declarations (xmlns*) unless
+ * the <code>http://xml.org/sax/features/namespace-prefixes</code> 
+ * feature is set to <var>true</var> (it is <var>false</var> by 
+ * default).
+ * Because SAX2 conforms to the original "Namespaces in XML"
+ * recommendation, it normally does not
+ * give namespace declaration attributes a namespace URI.
+ * </p>
+ *
+ * <p>Some SAX2 parsers may support using an optional feature flag
+ * (<code>http://xml.org/sax/features/xmlns-uris</code>) to request
+ * that those attributes be given URIs, conforming to a later
+ * backwards-incompatible revision of that recommendation.  (The
+ * attribute's "local name" will be the prefix, or "xmlns" when
+ * defining a default element namespace.)  For portability, handler
+ * code should always resolve that conflict, rather than requiring
+ * parsers that can change the setting of that feature flag.  </p>
+ *
+ * <p>If the namespace-prefixes feature (see above) is
+ * <var>false</var>, access by qualified name may not be available; if
+ * the <code>http://xml.org/sax/features/namespaces</code> feature is
+ * <var>false</var>, access by Namespace-qualified names may not be
+ * available.</p>
+ *
+ * <p>This interface replaces the now-deprecated SAX1 {@link
+ * org.xml.sax.AttributeList AttributeList} interface, which does not 
+ * contain Namespace support.  In addition to Namespace support, it 
+ * adds the <var>getIndex</var> methods (below).</p>
+ *
+ * <p>The order of attributes in the list is unspecified, and will
+ * vary from implementation to implementation.</p>
+ *
+ * @since SAX 2.0
+ * @author David Megginson
+ * @version 2.0.1 (sax2r2)
+ * @see org.xml.sax.helpers.AttributesImpl
+ * @see org.xml.sax.ext.DeclHandler#attributeDecl
+ */
+public interface Attributes
+{
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Indexed access.
+    ////////////////////////////////////////////////////////////////////
+
+
+    /**
+     * Return the number of attributes in the list.
+     *
+     * <p>Once you know the number of attributes, you can iterate
+     * through the list.</p>
+     *
+     * @return The number of attributes in the list.
+     * @see #getURI(int)
+     * @see #getLocalName(int)
+     * @see #getQName(int)
+     * @see #getType(int)
+     * @see #getValue(int)
+     */
+    public abstract int getLength ();
+
+
+    /**
+     * Look up an attribute's Namespace URI by index.
+     *
+     * @param index The attribute index (zero-based).
+     * @return The Namespace URI, or the empty string if none
+     *         is available, or null if the index is out of
+     *         range.
+     * @see #getLength
+     */
+    public abstract String getURI (int index);
+
+
+    /**
+     * Look up an attribute's local name by index.
+     *
+     * @param index The attribute index (zero-based).
+     * @return The local name, or the empty string if Namespace
+     *         processing is not being performed, or null
+     *         if the index is out of range.
+     * @see #getLength
+     */
+    public abstract String getLocalName (int index);
+
+
+    /**
+     * Look up an attribute's XML qualified (prefixed) name by index.
+     *
+     * @param index The attribute index (zero-based).
+     * @return The XML qualified name, or the empty string
+     *         if none is available, or null if the index
+     *         is out of range.
+     * @see #getLength
+     */
+    public abstract String getQName (int index);
+
+
+    /**
+     * Look up an attribute's type by index.
+     *
+     * <p>The attribute type is one of the strings "CDATA", "ID",
+     * "IDREF", "IDREFS", "NMTOKEN", "NMTOKENS", "ENTITY", "ENTITIES",
+     * or "NOTATION" (always in upper case).</p>
+     *
+     * <p>If the parser has not read a declaration for the attribute,
+     * or if the parser does not report attribute types, then it must
+     * return the value "CDATA" as stated in the XML 1.0 Recommendation
+     * (clause 3.3.3, "Attribute-Value Normalization").</p>
+     *
+     * <p>For an enumerated attribute that is not a notation, the
+     * parser will report the type as "NMTOKEN".</p>
+     *
+     * @param index The attribute index (zero-based).
+     * @return The attribute's type as a string, or null if the
+     *         index is out of range.
+     * @see #getLength
+     */
+    public abstract String getType (int index);
+
+
+    /**
+     * Look up an attribute's value by index.
+     *
+     * <p>If the attribute value is a list of tokens (IDREFS,
+     * ENTITIES, or NMTOKENS), the tokens will be concatenated
+     * into a single string with each token separated by a
+     * single space.</p>
+     *
+     * @param index The attribute index (zero-based).
+     * @return The attribute's value as a string, or null if the
+     *         index is out of range.
+     * @see #getLength
+     */
+    public abstract String getValue (int index);
+
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Name-based query.
+    ////////////////////////////////////////////////////////////////////
+
+
+    /**
+     * Look up the index of an attribute by Namespace name.
+     *
+     * @param uri The Namespace URI, or the empty string if
+     *        the name has no Namespace URI.
+     * @param localName The attribute's local name.
+     * @return The index of the attribute, or -1 if it does not
+     *         appear in the list.
+     */
+    public int getIndex (String uri, String localName);
+
+
+    /**
+     * Look up the index of an attribute by XML qualified (prefixed) name.
+     *
+     * @param qName The qualified (prefixed) name.
+     * @return The index of the attribute, or -1 if it does not
+     *         appear in the list.
+     */
+    public int getIndex (String qName);
+
+
+    /**
+     * Look up an attribute's type by Namespace name.
+     *
+     * <p>See {@link #getType(int) getType(int)} for a description
+     * of the possible types.</p>
+     *
+     * @param uri The Namespace URI, or the empty String if the
+     *        name has no Namespace URI.
+     * @param localName The local name of the attribute.
+     * @return The attribute type as a string, or null if the
+     *         attribute is not in the list or if Namespace
+     *         processing is not being performed.
+     */
+    public abstract String getType (String uri, String localName);
+
+
+    /**
+     * Look up an attribute's type by XML qualified (prefixed) name.
+     *
+     * <p>See {@link #getType(int) getType(int)} for a description
+     * of the possible types.</p>
+     *
+     * @param qName The XML qualified name.
+     * @return The attribute type as a string, or null if the
+     *         attribute is not in the list or if qualified names
+     *         are not available.
+     */
+    public abstract String getType (String qName);
+
+
+    /**
+     * Look up an attribute's value by Namespace name.
+     *
+     * <p>See {@link #getValue(int) getValue(int)} for a description
+     * of the possible values.</p>
+     *
+     * @param uri The Namespace URI, or the empty String if the
+     *        name has no Namespace URI.
+     * @param localName The local name of the attribute.
+     * @return The attribute value as a string, or null if the
+     *         attribute is not in the list.
+     */
+    public abstract String getValue (String uri, String localName);
+
+
+    /**
+     * Look up an attribute's value by XML qualified (prefixed) name.
+     *
+     * <p>See {@link #getValue(int) getValue(int)} for a description
+     * of the possible values.</p>
+     *
+     * @param qName The XML qualified name.
+     * @return The attribute value as a string, or null if the
+     *         attribute is not in the list or if qualified names
+     *         are not available.
+     */
+    public abstract String getValue (String qName);
+
+}
+
+// end of Attributes.java