org.apache.commons.digester.xmlrules
Class DigesterLoader

java.lang.Object
  |
  +--org.apache.commons.digester.xmlrules.DigesterLoader

public class DigesterLoader
extends java.lang.Object

This class manages the creation of Digester instances from XML digester rules files.

Author:
David H. Martin - Initial Contribution, Scott Sanders - Added ASL, removed external dependencies

Constructor Summary
DigesterLoader()
           
 
Method Summary
static Digester createDigester(java.net.URL rulesXml)
          Creates a new digester and initializes it from the specified XML file
static java.lang.Object load(java.net.URL digesterRules, java.lang.ClassLoader classLoader, java.io.InputStream input)
          Given the digester rules XML file, a class loader, and an input stream, this method parses the input into Java objects.
static java.lang.Object load(java.net.URL digesterRules, java.lang.ClassLoader classLoader, java.io.InputStream input, java.lang.Object rootObject)
          Given the digester rules XML file, a class loader, and an input stream, this method parses the input into Java objects.
static java.lang.Object load(java.net.URL digesterRules, java.lang.ClassLoader classLoader, java.net.URL fileURL)
          Given the digester rules XML file, a class loader, and an XML input file, this method parses the input file into Java objects.
static java.lang.Object load(java.net.URL digesterRules, java.lang.ClassLoader classLoader, java.net.URL fileURL, java.lang.Object rootObject)
          Given the digester rules XML file, a class loader, and an XML input file, this method parses the input file into Java objects.
 
Methods inherited from class java.lang.Object
, clone, equals, finalize, getClass, hashCode, notify, notifyAll, registerNatives, toString, wait, wait, wait
 

Constructor Detail

DigesterLoader

public DigesterLoader()
Method Detail

createDigester

public static Digester createDigester(java.net.URL rulesXml)
Creates a new digester and initializes it from the specified XML file
Parameters:
rulesXml - URL to the XML file defining the digester rules
Returns:
a new Digester initialized with the rules

load

public static java.lang.Object load(java.net.URL digesterRules,
                                    java.lang.ClassLoader classLoader,
                                    java.net.URL fileURL)
                             throws java.io.IOException,
                                    org.xml.sax.SAXException,
                                    DigesterLoadingException
Given the digester rules XML file, a class loader, and an XML input file, this method parses the input file into Java objects. The class loader is used by the digester to create the Java objects.
Parameters:
digesterRules - URL to the XML document defining the digester rules
classLoader - the ClassLoader to register with the digester
fileURL - URL to the XML file to parse into Java objects
Returns:
an Object which is the root of the network of Java objects created by digesting fileURL

load

public static java.lang.Object load(java.net.URL digesterRules,
                                    java.lang.ClassLoader classLoader,
                                    java.io.InputStream input)
                             throws java.io.IOException,
                                    org.xml.sax.SAXException,
                                    DigesterLoadingException
Given the digester rules XML file, a class loader, and an input stream, this method parses the input into Java objects. The class loader is used by the digester to create the Java objects.
Parameters:
digesterRules - URL to the XML document defining the digester rules
classLoader - the ClassLoader to register with the digester
input - InputStream over the XML file to parse into Java objects
Returns:
an Object which is the root of the network of Java objects created by digesting fileURL

load

public static java.lang.Object load(java.net.URL digesterRules,
                                    java.lang.ClassLoader classLoader,
                                    java.net.URL fileURL,
                                    java.lang.Object rootObject)
                             throws java.io.IOException,
                                    org.xml.sax.SAXException,
                                    DigesterLoadingException
Given the digester rules XML file, a class loader, and an XML input file, this method parses the input file into Java objects. The class loader is used by the digester to create the Java objects.
Parameters:
digesterRules - URL to the XML document defining the digester rules
classLoader - the ClassLoader to register with the digester
fileURL - URL to the XML file to parse into Java objects
rootObject - an Object to push onto the digester's stack, prior to parsing the input
Returns:
an Object which is the root of the network of Java objects. Usually, this will be the same object as rootObject created by digesting fileURL

load

public static java.lang.Object load(java.net.URL digesterRules,
                                    java.lang.ClassLoader classLoader,
                                    java.io.InputStream input,
                                    java.lang.Object rootObject)
                             throws java.io.IOException,
                                    org.xml.sax.SAXException,
                                    DigesterLoadingException
Given the digester rules XML file, a class loader, and an input stream, this method parses the input into Java objects. The class loader is used by the digester to create the Java objects.
Parameters:
digesterRules - URL to the XML document defining the digester rules
classLoader - the ClassLoader to register with the digester
input - InputStream over the XML file to parse into Java objects
rootObject - an Object to push onto the digester's stack, prior to parsing the input
Returns:
an Object which is the root of the network of Java objects created by digesting fileURL


Copyright (c) 2001-2002 - Apache Software Foundation