public interface PrimitiveTypeContentHandler
This is an optional extension handler for SAX2. XML readers are not required to recognize this handler, and it is not part of core-only SAX2 distributions.
This interface may be used with with a Fast Infoset SAX parser to receive notification of data encoded using the following built-in encoding algorithms specified in ITU-T Rec. X.891 | ISO/IEC 24824-1 (Fast Infoset), clause 10: "boolean", "base64", "short", "int", "long", "float", "double" and "uuid" encoding algorithms.
To set the PrimitiveTypeContentHandler for an XML reader, use the
setProperty
method
with the property name
URI TO BE DEFINED
and an object implementing this interface (or null) as the value.
If the reader does not report primitive data types, it will throw a
SAXNotRecognizedException
To set the PrimitiveTypeContentHandler for an Fast Infoset reader, use
setPrimitiveTypeContentHandler
method.
The Parser will call methods of this interface to report each chunk of character data that has been converted to an array of primitive types, for example an array of integer or an array of float. Parsers may return all contiguous primtive types in a single chunk, or they may split it into several chunks
The application must not attempt to read from the array outside of the specified range.
Modifier and Type | Method and Description |
---|---|
void |
booleans(boolean[] b,
int start,
int length)
Receive notification of character data as an array of boolean.
|
void |
bytes(byte[] b,
int start,
int length)
Receive notification of character data as an array of byte.
|
void |
doubles(double[] d,
int start,
int length)
Receive notification of character data as an array of double.
|
void |
floats(float[] f,
int start,
int length)
Receive notification of character data as an array of float.
|
void |
ints(int[] i,
int start,
int length)
Receive notification of character data as an array of int.
|
void |
longs(long[] l,
int start,
int length)
Receive notification of character data as an array of long.
|
void |
shorts(short[] s,
int start,
int length)
Receive notification of character data as an array of short.
|
void |
uuids(long[] msblsb,
int start,
int length)
Receive notification of character data as an two array of UUID.
|
void booleans(boolean[] b, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "boolean" encoding algorithm, see subclause 10.7
.
b
- the array of booleanstart
- the start position in the arraylength
- the number of boolean to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid bytes(byte[] b, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "base64" encoding algorithm, see subclause 10.3, or the "hexadecimal" encoding algorithm, see subclause 10.2.
Such a notification may occur for binary data that would
normally require base 64 encoding and reported as character data
using the characters
method
.
b
- the array of bytestart
- the start position in the arraylength
- the number of byte to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid shorts(short[] s, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "short" encoding algorithm, see subclause 10.4
.
s
- the array of shortstart
- the start position in the arraylength
- the number of short to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid ints(int[] i, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "int" encoding algorithm, see subclause 10.5
.
i
- the array of intstart
- the start position in the arraylength
- the number of int to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid longs(long[] l, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "long" encoding algorithm, see subclause 10.6
.
l
- the array of longstart
- the start position in the arraylength
- the number of long to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid floats(float[] f, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "float" encoding algorithm, see subclause 10.8
.
f
- the array of floatstart
- the start position in the arraylength
- the number of float to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid doubles(double[] d, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "double" encoding algorithm, see subclause 10.9
.
d
- the array of doublestart
- the start position in the arraylength
- the number of double to read from the arraySAXException
- any SAX exception, possibly
wrapping another exceptionvoid uuids(long[] msblsb, int start, int length) throws SAXException
The application must not attempt to read from the array outside of the specified range.
Such notifications will occur for a Fast Infoset SAX parser when processing data encoded using the "uuid" encoding algorithm, see subclause 10.10
.
msblsb
- the array of long containing pairs of most signficant
bits and least significant bits of the UUIDsstart
- the start position in the arraylength
- the number of long to read from the array. This will
be twice the number of UUIDs, which are pairs of two long valuesSAXException
- any SAX exception, possibly
wrapping another exceptionCopyright © 2017 Oracle Corpration. All Rights Reserved.