431 lines
15 KiB
Java
431 lines
15 KiB
Java
/*
|
|
* Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
|
|
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
|
|
*
|
|
* This code is free software; you can redistribute it and/or modify it
|
|
* under the terms of the GNU General Public License version 2 only, as
|
|
* published by the Free Software Foundation. Oracle designates this
|
|
* particular file as subject to the "Classpath" exception as provided
|
|
* by Oracle in the LICENSE file that accompanied this code.
|
|
*
|
|
* This code is distributed in the hope that it will be useful, but WITHOUT
|
|
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
|
|
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
* version 2 for more details (a copy is included in the LICENSE file that
|
|
* accompanied this code).
|
|
*
|
|
* You should have received a copy of the GNU General Public License version
|
|
* 2 along with this work; if not, write to the Free Software Foundation,
|
|
* Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
*
|
|
* Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
|
|
* or visit www.oracle.com if you need additional information or have any
|
|
* questions.
|
|
*/
|
|
|
|
package jdk.internal.util.xml.impl;
|
|
|
|
import jdk.internal.org.xml.sax.Attributes;
|
|
|
|
public class Attrs implements Attributes {
|
|
|
|
/**
|
|
* Attributes string array. Each individual attribute is represented by four
|
|
* strings: namespace URL(+0), qname(+1), local name(+2), value(+3),
|
|
* type(+4), declared["d"] and default["D"](+5). In order to find attribute
|
|
* by the attrubute index, the attribute index MUST be multiplied by 8. The
|
|
* result will point to the attribute namespace URL.
|
|
*/
|
|
/* pkg */ String[] mItems;
|
|
/**
|
|
* Number of attributes in the attributes string array.
|
|
*/
|
|
private char mLength;
|
|
/**
|
|
* current index
|
|
*/
|
|
private char mAttrIdx = 0;
|
|
|
|
/**
|
|
* Constructor.
|
|
*/
|
|
public Attrs() {
|
|
// The default number of attributies capacity is 8.
|
|
mItems = new String[(8 << 3)];
|
|
}
|
|
|
|
/**
|
|
* Sets up the number of attributes and ensure the capacity of the attribute
|
|
* string array.
|
|
*
|
|
* @param length The number of attributes in the object.
|
|
*/
|
|
public void setLength(char length) {
|
|
if (length > ((char) (mItems.length >> 3))) {
|
|
mItems = new String[length << 3];
|
|
}
|
|
mLength = length;
|
|
}
|
|
|
|
/**
|
|
* 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 int getLength() {
|
|
return mLength;
|
|
}
|
|
|
|
/**
|
|
* 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 String getURI(int index) {
|
|
return ((index >= 0) && (index < mLength))
|
|
? (mItems[index << 3])
|
|
: null;
|
|
}
|
|
|
|
/**
|
|
* 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 String getLocalName(int index) {
|
|
return ((index >= 0) && (index < mLength))
|
|
? (mItems[(index << 3) + 2])
|
|
: null;
|
|
}
|
|
|
|
/**
|
|
* Look up an attribute's XML 1.0 qualified name by index.
|
|
*
|
|
* @param index The attribute index (zero-based).
|
|
* @return The XML 1.0 qualified name, or the empty string if none is
|
|
* available, or null if the index is out of range.
|
|
* @see #getLength
|
|
*/
|
|
public String getQName(int index) {
|
|
if ((index < 0) || (index >= mLength)) {
|
|
return null;
|
|
}
|
|
return mItems[(index << 3) + 1];
|
|
}
|
|
|
|
/**
|
|
* 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 Recommentation (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 String getType(int index) {
|
|
return ((index >= 0) && (index < (mItems.length >> 3)))
|
|
? (mItems[(index << 3) + 4])
|
|
: null;
|
|
}
|
|
|
|
/**
|
|
* 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 String getValue(int index) {
|
|
return ((index >= 0) && (index < mLength))
|
|
? (mItems[(index << 3) + 3])
|
|
: null;
|
|
}
|
|
|
|
/**
|
|
* 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) {
|
|
char len = mLength;
|
|
for (char idx = 0; idx < len; idx++) {
|
|
if ((mItems[idx << 3]).equals(uri)
|
|
&& mItems[(idx << 3) + 2].equals(localName)) {
|
|
return idx;
|
|
}
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
/**
|
|
* 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. <code>null</code> value enforce the search by the local
|
|
* name only.
|
|
* @param localName The attribute's local name.
|
|
* @return The index of the attribute, or -1 if it does not appear in the
|
|
* list.
|
|
*/
|
|
/* pkg */ int getIndexNullNS(String uri, String localName) {
|
|
char len = mLength;
|
|
if (uri != null) {
|
|
for (char idx = 0; idx < len; idx++) {
|
|
if ((mItems[idx << 3]).equals(uri)
|
|
&& mItems[(idx << 3) + 2].equals(localName)) {
|
|
return idx;
|
|
}
|
|
}
|
|
} else {
|
|
for (char idx = 0; idx < len; idx++) {
|
|
if (mItems[(idx << 3) + 2].equals(localName)) {
|
|
return idx;
|
|
}
|
|
}
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
/**
|
|
* Look up the index of an attribute by XML 1.0 qualified 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) {
|
|
char len = mLength;
|
|
for (char idx = 0; idx < len; idx++) {
|
|
if (mItems[(idx << 3) + 1].equals(qName)) {
|
|
return idx;
|
|
}
|
|
}
|
|
return -1;
|
|
}
|
|
|
|
/**
|
|
* 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 String getType(String uri, String localName) {
|
|
int idx = getIndex(uri, localName);
|
|
return (idx >= 0) ? (mItems[(idx << 3) + 4]) : null;
|
|
}
|
|
|
|
/**
|
|
* Look up an attribute's type by XML 1.0 qualified name.
|
|
*
|
|
* <p>See {@link #getType(int) getType(int)} for a description of the
|
|
* possible types.</p>
|
|
*
|
|
* @param qName The XML 1.0 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 String getType(String qName) {
|
|
int idx = getIndex(qName);
|
|
return (idx >= 0) ? (mItems[(idx << 3) + 4]) : null;
|
|
}
|
|
|
|
/**
|
|
* 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 String getValue(String uri, String localName) {
|
|
int idx = getIndex(uri, localName);
|
|
return (idx >= 0) ? (mItems[(idx << 3) + 3]) : null;
|
|
}
|
|
|
|
/**
|
|
* Look up an attribute's value by XML 1.0 qualified name.
|
|
*
|
|
* <p>See {@link #getValue(int) getValue(int)} for a description of the
|
|
* possible values.</p>
|
|
*
|
|
* @param qName The XML 1.0 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 String getValue(String qName) {
|
|
int idx = getIndex(qName);
|
|
return (idx >= 0) ? (mItems[(idx << 3) + 3]) : null;
|
|
}
|
|
|
|
/**
|
|
* Returns false unless the attribute was declared in the DTD. This helps
|
|
* distinguish two kinds of attributes that SAX reports as CDATA: ones that
|
|
* were declared (and hence are usually valid), and those that were not (and
|
|
* which are never valid).
|
|
*
|
|
* @param index The attribute index (zero-based).
|
|
* @return true if the attribute was declared in the DTD, false otherwise.
|
|
* @exception java.lang.ArrayIndexOutOfBoundsException When the supplied
|
|
* index does not identify an attribute.
|
|
*/
|
|
public boolean isDeclared(int index) {
|
|
if ((index < 0) || (index >= mLength)) {
|
|
throw new ArrayIndexOutOfBoundsException("");
|
|
}
|
|
|
|
return ((mItems[(index << 3) + 5]) != null);
|
|
}
|
|
|
|
/**
|
|
* Returns false unless the attribute was declared in the DTD. This helps
|
|
* distinguish two kinds of attributes that SAX reports as CDATA: ones that
|
|
* were declared (and hence are usually valid), and those that were not (and
|
|
* which are never valid).
|
|
*
|
|
* @param qName The XML qualified (prefixed) name.
|
|
* @return true if the attribute was declared in the DTD, false otherwise.
|
|
* @exception java.lang.IllegalArgumentException When the supplied name does
|
|
* not identify an attribute.
|
|
*/
|
|
public boolean isDeclared(String qName) {
|
|
int idx = getIndex(qName);
|
|
if (idx < 0) {
|
|
throw new IllegalArgumentException("");
|
|
}
|
|
|
|
return ((mItems[(idx << 3) + 5]) != null);
|
|
}
|
|
|
|
/**
|
|
* Returns false unless the attribute was declared in the DTD. This helps
|
|
* distinguish two kinds of attributes that SAX reports as CDATA: ones that
|
|
* were declared (and hence are usually valid), and those that were not (and
|
|
* which are never valid).
|
|
*
|
|
* <p>Remember that since DTDs do not "understand" namespaces, the namespace
|
|
* URI associated with an attribute may not have come from the DTD. The
|
|
* declaration will have applied to the attribute's <em>qName</em>.
|
|
*
|
|
* @param uri The Namespace URI, or the empty string if the name has no
|
|
* Namespace URI.
|
|
* @param localName The attribute's local name.
|
|
* @return true if the attribute was declared in the DTD, false otherwise.
|
|
* @exception java.lang.IllegalArgumentException When the supplied names do
|
|
* not identify an attribute.
|
|
*/
|
|
public boolean isDeclared(String uri, String localName) {
|
|
int idx = getIndex(uri, localName);
|
|
if (idx < 0) {
|
|
throw new IllegalArgumentException("");
|
|
}
|
|
|
|
return ((mItems[(idx << 3) + 5]) != null);
|
|
}
|
|
|
|
/**
|
|
* Returns true unless the attribute value was provided by DTD defaulting.
|
|
*
|
|
* @param index The attribute index (zero-based).
|
|
* @return true if the value was found in the XML text, false if the value
|
|
* was provided by DTD defaulting.
|
|
* @exception java.lang.ArrayIndexOutOfBoundsException When the supplied
|
|
* index does not identify an attribute.
|
|
*/
|
|
public boolean isSpecified(int index) {
|
|
if ((index < 0) || (index >= mLength)) {
|
|
throw new ArrayIndexOutOfBoundsException("");
|
|
}
|
|
|
|
String str = mItems[(index << 3) + 5];
|
|
return ((str != null) ? (str.charAt(0) == 'd') : true);
|
|
}
|
|
|
|
/**
|
|
* Returns true unless the attribute value was provided by DTD defaulting.
|
|
*
|
|
* <p>Remember that since DTDs do not "understand" namespaces, the namespace
|
|
* URI associated with an attribute may not have come from the DTD. The
|
|
* declaration will have applied to the attribute's <em>qName</em>.
|
|
*
|
|
* @param uri The Namespace URI, or the empty string if the name has no
|
|
* Namespace URI.
|
|
* @param localName The attribute's local name.
|
|
* @return true if the value was found in the XML text, false if the value
|
|
* was provided by DTD defaulting.
|
|
* @exception java.lang.IllegalArgumentException When the supplied names do
|
|
* not identify an attribute.
|
|
*/
|
|
public boolean isSpecified(String uri, String localName) {
|
|
int idx = getIndex(uri, localName);
|
|
if (idx < 0) {
|
|
throw new IllegalArgumentException("");
|
|
}
|
|
|
|
String str = mItems[(idx << 3) + 5];
|
|
return ((str != null) ? (str.charAt(0) == 'd') : true);
|
|
}
|
|
|
|
/**
|
|
* Returns true unless the attribute value was provided by DTD defaulting.
|
|
*
|
|
* @param qName The XML qualified (prefixed) name.
|
|
* @return true if the value was found in the XML text, false if the value
|
|
* was provided by DTD defaulting.
|
|
* @exception java.lang.IllegalArgumentException When the supplied name does
|
|
* not identify an attribute.
|
|
*/
|
|
public boolean isSpecified(String qName) {
|
|
int idx = getIndex(qName);
|
|
if (idx < 0) {
|
|
throw new IllegalArgumentException("");
|
|
}
|
|
|
|
String str = mItems[(idx << 3) + 5];
|
|
return ((str != null) ? (str.charAt(0) == 'd') : true);
|
|
}
|
|
}
|