Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep
Overview  Package   Class  Use  Deprecated  Index 
Home >> All >> org >> apache >> commons >> [ jocl overview ]  PREV CLASS  NEXT CLASS
SUMMARY: JavaDoc of org.apache.commons.jocl.JOCLContentHandler JAVADOC | Sourc code of org.apache.commons.jocl.JOCLContentHandler SOURCE | Download org.apache.commons.jocl.JOCLContentHandler DOWNLOAD | NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD

org.apache.commons.jocl
Class JOCLContentHandler  view JOCLContentHandler download JOCLContentHandler.java

java.lang.Object
  extended byorg.xml.sax.helpers.DefaultHandler
      extended byorg.apache.commons.jocl.JOCLContentHandler
All Implemented Interfaces:
org.xml.sax.ContentHandler, org.xml.sax.DTDHandler, org.xml.sax.EntityResolver, org.xml.sax.ErrorHandler
public class JOCLContentHandler
extends org.xml.sax.helpers.DefaultHandler
implements org.xml.sax.ContentHandler

A org.xml.sax.ContentHandler for the Java Object Configuration Language.

JOCL provides an XML syntax for constructing arbitrary Java java.lang.Object instances. It does not define a full XML document type (there's no root element), but rather an XML fragment describing the Objects>Objects to be constructed.

In a JOCL fragment, one may define a series of objects using the object element. A trivial example is: 

 <object class="java.util.Date"/>
which constructs an instance of java.util.Date using the no-argument constructor.

After a "root-level" <object> element has been processed (that is, once endElement(java.lang.String,java.lang.String,java.lang.String) 55 has been invoked by the org.xml.sax.XMLReader), it will be appended to a list of Objects maintained by the JOCLContentHandler.

(See size() 55 , clear() 55 , clear(int) 55 , getType(int) 55 , getValue(int) 55 , getTypeArray() 55 , and getValueArray() 55 .)

You can list multiple object elements in a fragment. For example, after processing the JOCL fragment: 

 <object class="java.util.Date"/>
 <object class="java.util.Date"/>
The getTypeArray() 55 method will return an composed of two instances of java.util.Date. The sequence of Objects>Objects in the array will correspond to the sequence of <object> elements in the JOCL fragment.

As we've seen, when used with no child-elements, the <object> tag will cause the no-argument constructor of the specified class to be invoked. It is also possible to nest <object> tags to provide arguments for the constructor. For example, the fragment: 

 <object class="mypackage.Foo">
   <object class="mypackage.Bar"/>
 </object>
will add an instance of mypackage.Foo to the object list, constructed via new mypackage.Foo(new mypackage.Bar()).

There is a special syntax available creating primative values and arguments, as well as for constructing String>Strings. Some examples: 

 <byte value="3"/>
 <boolean value="false"/>
 <char value="c"/>
 <double value="3.14159"/>
 <float value="3.14"/>
 <int value="17"/>
 <long value="1700000"/>
 <short value="1"/>
 <string value="The quick brown fox..."/>

When invoked at the "root" level (that is, with no <object> parent), this will cause the corresponding "object wrapper" to be added to the list of Object>Objects. The type 55 for these objects will reflect the proper primative type, however. When invoked with an <object> parent, these will be treated as primitive arguments to the specified Object>Object's constructor. For example, while: 

 <int value="5"/>
 <int value="26"/>
 <int value="100"/>

results in three java.lang.Integer instances being added to the list of values, with types corresponding to java.lang.Integer, the fragment: 

 <int value="5"/>
 <int value="26"/>
 <int value="100"/>

results in three java.lang.Integer instances being added to the list of values, with types corresponding to Integer.TYPE>Integer.TYPE 55 .

Hence if you want to invoke the mypackage.Foo(java.lang.Integer,java.lang.Integer,java.lang.Integer) constructor, use: 

 <object class="mypackage.Foo"/>
   <object class="java.lang.Integer"><int value="5"/></object>
   <object class="java.lang.Integer"><int value="26"/></object>
   <object class="java.lang.Integer"><int value="100"/></object>
 </object>

If you want to invoke the mypackage.Foo(int,int,int) constructor, use: 

 <object class="mypackage.Foo"/>
   <int value="5"/>
   <int value="26"/>
   <int value="100"/>
 </object>

If you'd like to creat a null object, use: 

 <object class="mypackage.Bar" null="true"/>

Here's a simple but complete example: 

 <?xml version="1.0"?>
 <arbitrary-root xmlns="http://apache.org/xml/xmlns/jakarta/commons/jocl">
   <string value="Hello World!"/>
   <string/>
   <boolean/>
   <boolean value="true"/>
   <byte value="1"/>
   <short value="1"/>
   <int value="1"/>
   <long value="1"/>
   <float value="1.0"/>
   <double value="1.0"/>
   <object class="java.util.Date"/>
   <object class="java.util.Date">
    <int value="1"/>
    <int value="1"/>
    <int value="1"/>
   </object>
 </arbitrary-root>

Formally, a DTD for the JOCL grammar is as follows: 

 <!ELEMENT object (object|byte|boolean|char|double|float|int|long|short|string)*>
 <!ATTLIST object
   class CDATA #REQUIRED
   null (true|false) "false">

 <!ELEMENT byte EMPTY>
 <!ATTLIST byte value CDATA #REQUIRED>

 <!ELEMENT boolean EMPTY>
 <!ATTLIST boolean value (true|false) #REQUIRED>

 <!ELEMENT char EMPTY>
 <!ATTLIST char value CDATA #REQUIRED>

 <!ELEMENT double EMPTY>
 <!ATTLIST double value CDATA #REQUIRED>

 <!ELEMENT float EMPTY>
 <!ATTLIST float value CDATA #REQUIRED>

 <!ELEMENT int EMPTY>
 <!ATTLIST int value CDATA #REQUIRED>

 <!ELEMENT long EMPTY>
 <!ATTLIST long value CDATA #REQUIRED>

 <!ELEMENT short EMPTY>
 <!ATTLIST short value CDATA #REQUIRED>

 <!ELEMENT string EMPTY>
 <!ATTLIST string value CDATA #REQUIRED>

This class can also be used as a base class for org.xml.sax.ContentHandlers that include JOCL as part of their grammar. Simply extend this class, and override the startElement(java.lang.String, java.lang.String, java.lang.String, org.xml.sax.Attributes) 55 , DefaultHandler.characters(char[], int, int)>DefaultHandler.characters(char[], int, int) 55 , and endElement(java.lang.String, java.lang.String, java.lang.String) 55 methods to handle your tags, and invoke the method of the parent class (i.e., super.XXX for elements and data that you don't handle.

A number of static methods are available for simply reading a list of objects from a java.io.InputStream, java.io.Reader or org.xml.sax.InputSource.

Note that this class is not synchronized.

Version:
$Revision: 1.6 $ $Date: 2004/02/28 21:37:42 $

Nested Class Summary
(package private)  class JOCLContentHandler.ConstructorDetails
           
 
Field Summary
protected  boolean _acceptEmptyNamespaceForAttributes
          When true, I will treat attributes with an empty namespace URI as part of the JOCL namespace.
protected  boolean _acceptEmptyNamespaceForElements
          When true, I will treat elements with an empty namespace URI as part of the JOCL namespace.
protected  boolean _acceptJoclPrefixForAttributes
          When true, I will treat attributes with the JOCL_PREFIX 55 but no namespace URI as being mapped to the jocl namespace.
protected  boolean _acceptJoclPrefixForElements
          When true, I will treat elements with the JOCL_PREFIX 55 but no namespace URI as being mapped to the jocl namespace.
protected  JOCLContentHandler.ConstructorDetails _cur
          The object I'm currently working on.
protected  org.xml.sax.Locator _locator
          My org.xml.sax.Locator.
protected  java.util.ArrayList _typeList
          A list of the types (java.lang.Classes) already created via the parse.
protected  java.util.ArrayList _valueList
          A list of the values (java.lang.Objects) already created via the parse.
protected static java.lang.String ATT_CLASS
          The name of the "object" element's "class" attribute.
protected static java.lang.String ATT_ISNULL
          The name of the "object" element's "isnull" attribute.
protected static java.lang.String ATT_VALUE
          The name of the "value" attribute.
protected static java.lang.String ELT_BOOLEAN
          The name of the "boolean" element.
protected static java.lang.String ELT_BYTE
          The name of the "byte" element.
protected static java.lang.String ELT_CHAR
          The name of the "char" element.
protected static java.lang.String ELT_DOUBLE
          The name of the "double" element.
protected static java.lang.String ELT_FLOAT
          The name of the "float" element.
protected static java.lang.String ELT_INT
          The name of the "int" element.
protected static java.lang.String ELT_LONG
          The name of the "long" element.
protected static java.lang.String ELT_OBJECT
          The name of the "object" element.
protected static java.lang.String ELT_SHORT
          The name of the "short" element.
protected static java.lang.String ELT_STRING
          The name of the "string" element.
static java.lang.String JOCL_NAMESPACE_URI
          The JOCL namespace URI, http://apache.org/xml/xmlns/jakarta/commons/jocl.
static java.lang.String JOCL_PREFIX
          The default JOCL prefix, jocl:.
 
Constructor Summary
JOCLContentHandler()
          Equivalent to JOCLContentHandler(true,true,true,true) 55 .
JOCLContentHandler(boolean emptyEltNS, boolean joclEltPrefix, boolean emptyAttrNS, boolean joclAttrPrefix)
          Construct a JOCLContentHandler.
 
Method Summary
protected  void addObject(java.lang.Class type, java.lang.Object val)
          Add the specified object either to my type/value list, or as an argument to the object I'm currently constructing.
 void clear()
          Clears all the values and types in my list.
 void clear(int i)
          Removes the value/type pair at the specified index.
 void endElement(java.lang.String uri, java.lang.String localName, java.lang.String qname)
          Receive notification of the end of an element.
protected  java.lang.String getAttributeValue(java.lang.String localname, org.xml.sax.Attributes attr)
          Equivalent to getAttributeValue(localname,attr,null) 55 .
protected  java.lang.String getAttributeValue(java.lang.String localname, org.xml.sax.Attributes attr, java.lang.String implied)
          Returns the value of attribute with the given localname within the JOCL namespace from the given set of org.xml.sax.Attributes.
 java.lang.Class getType(int i)
          Returns the type of the object at the specified index.
 java.lang.Object[] getTypeArray()
          Returns a shallow copy of my list of types.
 java.lang.Object getValue(int i)
          Returns the value of the object at the specified index.
 java.lang.Object[] getValueArray()
          Returns a shallow copy of my list of values.
protected  boolean isJoclNamespace(java.lang.String uri, java.lang.String localname, java.lang.String qname)
          Returns true if the given attributes define an element within the JOCL namespace (according to my current configuration.)
static void main(java.lang.String[] args)
          A simple tester method.
static JOCLContentHandler parse(java.io.File f)
          Parses a JOCL document from the specified file, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property.
static JOCLContentHandler parse(java.io.File f, org.xml.sax.XMLReader reader)
          Parses a JOCL document from the specified file, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property.
static JOCLContentHandler parse(org.xml.sax.InputSource in)
          Parses a JOCL document from the specified org.xml.sax.InputSource, using thethe org.xml.sax.XMLReader specified by the org.xml.sax.driver property.
static JOCLContentHandler parse(org.xml.sax.InputSource in, org.xml.sax.XMLReader reader)
          Parses a JOCL document from the specified org.xml.sax.InputSource, using the specified org.xml.sax.XMLReader.
static JOCLContentHandler parse(java.io.InputStream in)
          Parses a JOCL document from the specified java.io.InputStream, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property.
static JOCLContentHandler parse(java.io.InputStream in, org.xml.sax.XMLReader reader)
          Parses a JOCL document from the specified java.io.InputStream, using the specified org.xml.sax.XMLReader.
static JOCLContentHandler parse(java.io.Reader in)
          Parses a JOCL document from the specified java.io.Reader, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property.
static JOCLContentHandler parse(java.io.Reader in, org.xml.sax.XMLReader reader)
          Parses a JOCL document from the specified java.io.Reader, using the specified org.xml.sax.XMLReader.
 void setDocumentLocator(org.xml.sax.Locator locator)
          Receive an object for locating the origin of SAX document events.
 int size()
          Returns the number of values and types in my list.
 void startElement(java.lang.String uri, java.lang.String localName, java.lang.String qname, org.xml.sax.Attributes attr)
          Receive notification of the beginning of an element.
 
Methods inherited from class org.xml.sax.helpers.DefaultHandler
characters, endDocument, endPrefixMapping, error, fatalError, ignorableWhitespace, notationDecl, processingInstruction, resolveEntity, skippedEntity, startDocument, startPrefixMapping, unparsedEntityDecl, warning
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.xml.sax.ContentHandler
characters, endDocument, endPrefixMapping, ignorableWhitespace, processingInstruction, skippedEntity, startDocument, startPrefixMapping
 

Field Detail

JOCL_NAMESPACE_URI

public static final java.lang.String JOCL_NAMESPACE_URI
The JOCL namespace URI, http://apache.org/xml/xmlns/jakarta/commons/jocl.

See Also:
Constant Field Values

JOCL_PREFIX

public static final java.lang.String JOCL_PREFIX
The default JOCL prefix, jocl:.

See Also:
Constant Field Values

_typeList

protected java.util.ArrayList _typeList
A list of the types (java.lang.Classes) already created via the parse.

_valueList

protected java.util.ArrayList _valueList
A list of the values (java.lang.Objects) already created via the parse.

_cur

protected JOCLContentHandler.ConstructorDetails _cur
The object I'm currently working on.

_acceptEmptyNamespaceForElements

protected boolean _acceptEmptyNamespaceForElements
When true, I will treat elements with an empty namespace URI as part of the JOCL namespace.

See Also:
JOCL_NAMESPACE_URI 55

_acceptJoclPrefixForElements

protected boolean _acceptJoclPrefixForElements
When true, I will treat elements with the JOCL_PREFIX 55 but no namespace URI as being mapped to the jocl namespace.

See Also:
JOCL_PREFIX 55 , JOCL_NAMESPACE_URI 55

_acceptEmptyNamespaceForAttributes

protected boolean _acceptEmptyNamespaceForAttributes
When true, I will treat attributes with an empty namespace URI as part of the JOCL namespace.

See Also:
JOCL_NAMESPACE_URI 55

_acceptJoclPrefixForAttributes

protected boolean _acceptJoclPrefixForAttributes
When true, I will treat attributes with the JOCL_PREFIX 55 but no namespace URI as being mapped to the jocl namespace.

See Also:
JOCL_PREFIX 55 , JOCL_NAMESPACE_URI 55

_locator

protected org.xml.sax.Locator _locator
My org.xml.sax.Locator.

ELT_OBJECT

protected static final java.lang.String ELT_OBJECT
The name of the "object" element.

See Also:
Constant Field Values

ATT_CLASS

protected static final java.lang.String ATT_CLASS
The name of the "object" element's "class" attribute.

See Also:
Constant Field Values

ATT_ISNULL

protected static final java.lang.String ATT_ISNULL
The name of the "object" element's "isnull" attribute.

See Also:
Constant Field Values

ELT_BOOLEAN

protected static final java.lang.String ELT_BOOLEAN
The name of the "boolean" element.

See Also:
Constant Field Values

ELT_BYTE

protected static final java.lang.String ELT_BYTE
The name of the "byte" element.

See Also:
Constant Field Values

ELT_CHAR

protected static final java.lang.String ELT_CHAR
The name of the "char" element.

See Also:
Constant Field Values

ELT_DOUBLE

protected static final java.lang.String ELT_DOUBLE
The name of the "double" element.

See Also:
Constant Field Values

ELT_FLOAT

protected static final java.lang.String ELT_FLOAT
The name of the "float" element.

See Also:
Constant Field Values

ELT_INT

protected static final java.lang.String ELT_INT
The name of the "int" element.

See Also:
Constant Field Values

ELT_LONG

protected static final java.lang.String ELT_LONG
The name of the "long" element.

See Also:
Constant Field Values

ELT_SHORT

protected static final java.lang.String ELT_SHORT
The name of the "short" element.

See Also:
Constant Field Values

ELT_STRING

protected static final java.lang.String ELT_STRING
The name of the "string" element.

See Also:
Constant Field Values

ATT_VALUE

protected static final java.lang.String ATT_VALUE
The name of the "value" attribute.

See Also:
Constant Field Values
Constructor Detail

JOCLContentHandler

public JOCLContentHandler()
Equivalent to JOCLContentHandler(true,true,true,true) 55 .

JOCLContentHandler

public JOCLContentHandler(boolean emptyEltNS,
                          boolean joclEltPrefix,
                          boolean emptyAttrNS,
                          boolean joclAttrPrefix)
Construct a JOCLContentHandler.

Method Detail

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception
A simple tester method. Reads a JOCL document from standard in and prints a list of the objects created to standard out. (Use the org.xml.sax.driver system property to specify an org.xml.sax.XMLReader.

parse

public static JOCLContentHandler parse(java.io.File f)
                                throws org.xml.sax.SAXException,
                                       java.io.FileNotFoundException,
                                       java.io.IOException
Parses a JOCL document from the specified file, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(java.io.Reader in)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified java.io.Reader, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(java.io.InputStream in)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified java.io.InputStream, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(org.xml.sax.InputSource in)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified org.xml.sax.InputSource, using thethe org.xml.sax.XMLReader specified by the org.xml.sax.driver property. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(java.io.File f,
                                       org.xml.sax.XMLReader reader)
                                throws org.xml.sax.SAXException,
                                       java.io.FileNotFoundException,
                                       java.io.IOException
Parses a JOCL document from the specified file, using the org.xml.sax.XMLReader specified by the org.xml.sax.driver property. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(java.io.Reader in,
                                       org.xml.sax.XMLReader reader)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified java.io.Reader, using the specified org.xml.sax.XMLReader. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(java.io.InputStream in,
                                       org.xml.sax.XMLReader reader)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified java.io.InputStream, using the specified org.xml.sax.XMLReader. The returned JOCLContentHandler will contain the list of objects described by the file.

parse

public static JOCLContentHandler parse(org.xml.sax.InputSource in,
                                       org.xml.sax.XMLReader reader)
                                throws org.xml.sax.SAXException,
                                       java.io.IOException
Parses a JOCL document from the specified org.xml.sax.InputSource, using the specified org.xml.sax.XMLReader. The returned JOCLContentHandler will contain the list of objects described by the file.

size

public int size()
Returns the number of values and types in my list.

clear

public void clear()
Clears all the values and types in my list.

clear

public void clear(int i)
Removes the value/type pair at the specified index.

getType

public java.lang.Class getType(int i)
Returns the type of the object at the specified index.

getValue

public java.lang.Object getValue(int i)
Returns the value of the object at the specified index.

getValueArray

public java.lang.Object[] getValueArray()
Returns a shallow copy of my list of values.

getTypeArray

public java.lang.Object[] getTypeArray()
Returns a shallow copy of my list of types.

startElement

public void startElement(java.lang.String uri,
                         java.lang.String localName,
                         java.lang.String qname,
                         org.xml.sax.Attributes attr)
                  throws org.xml.sax.SAXException
Description copied from interface: org.xml.sax.ContentHandler
Receive notification of the beginning of an element.

The Parser will invoke this method at the beginning of every element in the XML document; there will be a corresponding endElement 55 event for every startElement event (even when the element is empty). All of the element's content will be reported, in order, before the corresponding endElement event.

This event allows up to three name components for each element:

  1. the Namespace URI;
  2. the local name; and
  3. the qualified (prefixed) name.

Any or all of these may be provided, depending on the values of the http://xml.org/sax/features/namespaces and the http://xml.org/sax/features/namespace-prefixes properties:

  • the Namespace URI and local name are required when the namespaces property is true (the default), and are optional when the namespaces property is false (if one is specified, both must be);
  • the qualified name is required when the namespace-prefixes property is true, and is optional when the namespace-prefixes property is false (the default).

Note that the attribute list provided will contain only attributes with explicit values (specified or defaulted): #IMPLIED attributes will be omitted. The attribute list will contain attributes used for Namespace declarations (xmlns* attributes) only if the http://xml.org/sax/features/namespace-prefixes property is true (it is false by default, and support for a true value is optional).

Like characters() 55 , attribute values may have characters that need more than one char value.

Specified by:
startElement in interface org.xml.sax.ContentHandler

endElement

public void endElement(java.lang.String uri,
                       java.lang.String localName,
                       java.lang.String qname)
                throws org.xml.sax.SAXException
Description copied from interface: org.xml.sax.ContentHandler
Receive notification of the end of an element.

The SAX parser will invoke this method at the end of every element in the XML document; there will be a corresponding startElement 55 event for every endElement event (even when the element is empty).

For information on the names, see startElement.

Specified by:
endElement in interface org.xml.sax.ContentHandler

setDocumentLocator

public void setDocumentLocator(org.xml.sax.Locator locator)
Description copied from interface: org.xml.sax.ContentHandler
Receive an object for locating the origin of SAX document events.

SAX parsers are strongly encouraged (though not absolutely required) to supply a locator: if it does so, it must supply the locator to the application by invoking this method before invoking any of the other methods in the ContentHandler interface.

The locator allows the application to determine the end position of any document-related event, even if the parser is not reporting an error. Typically, the application will use this information for reporting its own errors (such as character content that does not match an application's business rules). The information returned by the locator is probably not sufficient for use with a search engine.

Note that the locator will return correct information only during the invocation SAX event callbacks after startDocument 55 returns and before endDocument 55 is called. The application should not attempt to use it at any other time.

Specified by:
setDocumentLocator in interface org.xml.sax.ContentHandler

isJoclNamespace

protected boolean isJoclNamespace(java.lang.String uri,
                                  java.lang.String localname,
                                  java.lang.String qname)
Returns true if the given attributes define an element within the JOCL namespace (according to my current configuration.)

getAttributeValue

protected java.lang.String getAttributeValue(java.lang.String localname,
                                             org.xml.sax.Attributes attr)
Equivalent to getAttributeValue(localname,attr,null) 55 .

getAttributeValue

protected java.lang.String getAttributeValue(java.lang.String localname,
                                             org.xml.sax.Attributes attr,
                                             java.lang.String implied)
Returns the value of attribute with the given localname within the JOCL namespace from the given set of org.xml.sax.Attributes. If no such attribute can be found, returns implied.

addObject

protected void addObject(java.lang.Class type,
                         java.lang.Object val)
Add the specified object either to my type/value list, or as an argument to the object I'm currently constructing.

Overview  Package   Class  Use  Deprecated  Index 
Home >> All >> org >> apache >> commons >> [ jocl overview ]  PREV CLASS  NEXT CLASS
SUMMARY: JavaDoc of org.apache.commons.jocl.JOCLContentHandler JAVADOC | Sourc code of org.apache.commons.jocl.JOCLContentHandler SOURCE | Download org.apache.commons.jocl.JOCLContentHandler DOWNLOAD | NESTED | FIELD | CONSTR | METHOD DETAIL: FIELD | CONSTR | METHOD