JAL-3541 selectively merged build.gradle and gradle.properties
[jalview.git] / unused / xml / sax / ext / Attributes2Impl.java
diff --git a/unused/xml/sax/ext/Attributes2Impl.java b/unused/xml/sax/ext/Attributes2Impl.java
new file mode 100644 (file)
index 0000000..ad24c78
--- /dev/null
@@ -0,0 +1,310 @@
+// Attributes2Impl.java - extended AttributesImpl
+// http://www.saxproject.org
+// Public Domain: no warranty.
+// $Id: Attributes2Impl.java,v 1.5 2004/03/08 13:01:01 dmegginson Exp $
+
+package org.xml.sax.ext;
+
+import org.xml.sax.Attributes;
+import org.xml.sax.helpers.AttributesImpl;
+
+
+/**
+ * SAX2 extension helper for additional Attributes information,
+ * implementing the {@link Attributes2} interface.
+ *
+ * <blockquote>
+ * <em>This module, both source code and documentation, is in the
+ * Public Domain, and comes with <strong>NO WARRANTY</strong>.</em>
+ * </blockquote>
+ *
+ * <p>This is not part of core-only SAX2 distributions.</p>
+ *
+ * <p>The <em>specified</em> flag for each attribute will always
+ * be true, unless it has been set to false in the copy constructor
+ * or using {@link #setSpecified}.
+ * Similarly, the <em>declared</em> flag for each attribute will
+ * always be false, except for defaulted attributes (<em>specified</em>
+ * is false), non-CDATA attributes, or when it is set to true using
+ * {@link #setDeclared}.
+ * If you change an attribute's type by hand, you may need to modify
+ * its <em>declared</em> flag to match. 
+ * </p>
+ *
+ * @since SAX 2.0 (extensions 1.1 alpha)
+ * @author David Brownell
+ * @version TBS
+ */
+public class Attributes2Impl extends AttributesImpl implements Attributes2
+{
+    private boolean    declared [];
+    private boolean    specified [];
+
+
+    /**
+     * Construct a new, empty Attributes2Impl object.
+     */
+    public Attributes2Impl () { }
+
+
+    /**
+     * Copy an existing Attributes or Attributes2 object.
+     * If the object implements Attributes2, values of the
+     * <em>specified</em> and <em>declared</em> flags for each
+     * attribute are copied.
+     * Otherwise the flag values are defaulted to assume no DTD was used,
+     * unless there is evidence to the contrary (such as attributes with
+     * type other than CDATA, which must have been <em>declared</em>).
+     *
+     * <p>This constructor is especially useful inside a
+     * {@link org.xml.sax.ContentHandler#startElement startElement} event.</p>
+     *
+     * @param atts The existing Attributes object.
+     */
+    public Attributes2Impl (Attributes atts)
+    {
+       super (atts);
+    }
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Implementation of Attributes2
+    ////////////////////////////////////////////////////////////////////
+
+
+    /**
+     * Returns the current value of the attribute's "declared" flag.
+     */
+    // javadoc mostly from interface
+    @Override
+               public boolean isDeclared (int index)
+    {
+       if (index < 0 || index >= getLength ())
+           throw new ArrayIndexOutOfBoundsException (
+               "No attribute at index: " + index);
+       return declared [index];
+    }
+
+
+    /**
+     * Returns the current value of the attribute's "declared" flag.
+     */
+    // javadoc mostly from interface
+    @Override
+               public boolean isDeclared (String uri, String localName)
+    {
+       int index = getIndex (uri, localName);
+
+       if (index < 0)
+           throw new IllegalArgumentException (
+               "No such attribute: local=" + localName
+               + ", namespace=" + uri);
+       return declared [index];
+    }
+
+
+    /**
+     * Returns the current value of the attribute's "declared" flag.
+     */
+    // javadoc mostly from interface
+    @Override
+               public boolean isDeclared (String qName)
+    {
+       int index = getIndex (qName);
+
+       if (index < 0)
+           throw new IllegalArgumentException (
+               "No such attribute: " + qName);
+       return declared [index];
+    }
+
+
+    /**
+     * Returns the current value of an attribute's "specified" flag.
+     *
+     * @param index The attribute index (zero-based).
+     * @return current flag value
+     * @exception java.lang.ArrayIndexOutOfBoundsException When the
+     *            supplied index does not identify an attribute.
+     */
+    @Override
+               public boolean isSpecified (int index)
+    {
+       if (index < 0 || index >= getLength ())
+           throw new ArrayIndexOutOfBoundsException (
+               "No attribute at index: " + index);
+       return specified [index];
+    }
+
+
+    /**
+     * Returns the current value of an attribute's "specified" flag.
+     *
+     * @param uri The Namespace URI, or the empty string if
+     *        the name has no Namespace URI.
+     * @param localName The attribute's local name.
+     * @return current flag value
+     * @exception java.lang.IllegalArgumentException When the
+     *            supplied names do not identify an attribute.
+     */
+    @Override
+               public boolean isSpecified (String uri, String localName)
+    {
+       int index = getIndex (uri, localName);
+
+       if (index < 0)
+           throw new IllegalArgumentException (
+               "No such attribute: local=" + localName
+               + ", namespace=" + uri);
+       return specified [index];
+    }
+
+
+    /**
+     * Returns the current value of an attribute's "specified" flag.
+     *
+     * @param qName The XML qualified (prefixed) name.
+     * @return current flag value
+     * @exception java.lang.IllegalArgumentException When the
+     *            supplied name does not identify an attribute.
+     */
+    @Override
+               public boolean isSpecified (String qName)
+    {
+       int index = getIndex (qName);
+
+       if (index < 0)
+           throw new IllegalArgumentException (
+               "No such attribute: " + qName);
+       return specified [index];
+    }
+
+
+    ////////////////////////////////////////////////////////////////////
+    // Manipulators
+    ////////////////////////////////////////////////////////////////////
+
+
+    /**
+     * Copy an entire Attributes object.  The "specified" flags are
+     * assigned as true, and "declared" flags as false (except when
+     * an attribute's type is not CDATA),
+     * unless the object is an Attributes2 object.
+     * In that case those flag values are all copied.
+     *
+     * @see AttributesImpl#setAttributes
+     */
+    @Override
+               public void setAttributes (Attributes atts)
+    {
+       int length = atts.getLength ();
+
+       super.setAttributes (atts);
+       declared = new boolean [length];
+       specified = new boolean [length];
+
+       if (atts instanceof Attributes2) {
+           Attributes2 a2 = (Attributes2) atts;
+           for (int i = 0; i < length; i++) {
+               declared [i] = a2.isDeclared (i);
+               specified [i] = a2.isSpecified (i);
+           }
+       } else {
+           for (int i = 0; i < length; i++) {
+               declared [i] = !"CDATA".equals (atts.getType (i));
+               specified [i] = true;
+           }
+       }
+    }
+
+
+    /**
+     * Add an attribute to the end of the list, setting its
+     * "specified" flag to true.  To set that flag's value
+     * to false, use {@link #setSpecified}.
+     *
+     * <p>Unless the attribute <em>type</em> is CDATA, this attribute
+     * is marked as being declared in the DTD.  To set that flag's value
+     * to true for CDATA attributes, use {@link #setDeclared}.
+     *
+     * @see AttributesImpl#addAttribute
+     */
+    @Override
+               public void addAttribute (String uri, String localName, String qName,
+                             String type, String value)
+    {
+       super.addAttribute (uri, localName, qName, type, value);
+
+       int length = getLength ();
+
+       if (length < specified.length) {
+           boolean     newFlags [];
+
+           newFlags = new boolean [length];
+           System.arraycopy (declared, 0, newFlags, 0, declared.length);
+           declared = newFlags;
+
+           newFlags = new boolean [length];
+           System.arraycopy (specified, 0, newFlags, 0, specified.length);
+           specified = newFlags;
+       }
+
+       specified [length - 1] = true;
+       declared [length - 1] = !"CDATA".equals (type);
+    }
+
+
+    // javadoc entirely from superclass
+    @Override
+               public void removeAttribute (int index)
+    {
+       int origMax = getLength () - 1;
+
+       super.removeAttribute (index);
+       if (index != origMax) {
+           System.arraycopy (declared, index + 1, declared, index,
+                   origMax - index);
+           System.arraycopy (specified, index + 1, specified, index,
+                   origMax - index);
+       }
+    }
+
+
+    /**
+     * Assign a value to the "declared" flag of a specific attribute.
+     * This is normally needed only for attributes of type CDATA,
+     * including attributes whose type is changed to or from CDATA.
+     *
+     * @param index The index of the attribute (zero-based).
+     * @param value The desired flag value.
+     * @exception java.lang.ArrayIndexOutOfBoundsException When the
+     *            supplied index does not identify an attribute.
+     * @see #setType
+     */
+    public void setDeclared (int index, boolean value)
+    {
+       if (index < 0 || index >= getLength ())
+           throw new ArrayIndexOutOfBoundsException (
+               "No attribute at index: " + index);
+       declared [index] = value;
+    }
+
+
+    /**
+     * Assign a value to the "specified" flag of a specific attribute.
+     * This is the only way this flag can be cleared, except clearing
+     * by initialization with the copy constructor.
+     *
+     * @param index The index of the attribute (zero-based).
+     * @param value The desired flag value.
+     * @exception java.lang.ArrayIndexOutOfBoundsException When the
+     *            supplied index does not identify an attribute.
+     */
+    public void setSpecified (int index, boolean value)
+    {
+       if (index < 0 || index >= getLength ())
+           throw new ArrayIndexOutOfBoundsException (
+               "No attribute at index: " + index);
+       specified [index] = value;
+    }
+}