org.jvnet.fastinfoset.sax
Interface EncodingAlgorithmAttributes

All Superinterfaces:
org.xml.sax.Attributes
All Known Implementing Classes:
AttributesHolder, EncodingAlgorithmAttributesImpl

public interface EncodingAlgorithmAttributes
extends org.xml.sax.Attributes

Interface for a list of XML attributes that may contain encoding algorithm data.

Implementations shall ensure that the Attributes.getValue(int) method correctly returns a String object even if the attribute is represented as algorithm data.

If an attribute has algorithm data then the getAlgorithmData(int) method shall return a non null value.

See Also:
FastInfosetReader, XMLReader

Method Summary
 java.lang.Object getAlgorithmData(int index)
          Return the data of the encoding algorithm.
 int getAlgorithmIndex(int index)
          Return the index of the encoding algorithm.
 java.lang.String getAlgorithmURI(int index)
          Return the URI of the encoding algorithm.
 java.lang.String getAlpababet(int index)
          Return the alphabet associated with the attribute value.
 boolean getToIndex(int index)
          Return the whether the attribute value should be indexed or not.
 
Methods inherited from interface org.xml.sax.Attributes
getIndex, getIndex, getLength, getLocalName, getQName, getType, getType, getType, getURI, getValue, getValue, getValue
 

Method Detail

getAlgorithmURI

public java.lang.String getAlgorithmURI(int index)
Return the URI of the encoding algorithm.

If the algorithm data corresponds to a built-in encoding algorithm then the null is returned.

If the algorithm data corresponds to an application-defined encoding algorithm then the URI of the algorithm is returned.

If getAlgorithmData(int) returns null then the result of this method is undefined.

Parameters:
index - The attribute index (zero-based).
Returns:
The URI. If the index is out of range then null is returned.

getAlgorithmIndex

public int getAlgorithmIndex(int index)
Return the index of the encoding algorithm.

If getAlgorithmData(int) returns null then the result of this method is undefined.

Parameters:
index - The attribute index (zero-based).
Returns:
The algorithm index. If index is out of range then -1 is returned.
See Also:
EncodingAlgorithmIndexes

getAlgorithmData

public java.lang.Object getAlgorithmData(int index)
Return the data of the encoding algorithm.

If the algorithm data corresponds to a built-in encoding algorithm then an Object corresponding to the Java primitive type is returned.

If the algorithm data corresponds to an application-defined encoding algorithm then an Object that is an instance of byte[] is returned if there is no EncodingAlgorithm registered for the application-defined encoding algorithm URI. Otherwise, an Object produced from the registeredEncodingAlgorithm is returned.

If there no encoding algorithm data associated an attribute then null is returned.

Parameters:
index - The attribute index (zero-based).
Returns:
The data. If the index is out of range then null is returned.

getAlpababet

public java.lang.String getAlpababet(int index)
Return the alphabet associated with the attribute value.

Parameters:
index - The attribute index (zero-based).
Returns:
The alphabet. If the index is out of range then null is returned. If there is is no alphabet then null is returned.

getToIndex

public boolean getToIndex(int index)
Return the whether the attribute value should be indexed or not.

Parameters:
index - The attribute index (zero-based).
Returns:
True if attribute value should be indexed, otherwise false.