RuleTestCase (Apache Commons Digester 3.3-SNAPSHOT Test API)

java.lang.Object
- org.apache.commons.digester3.RuleTestCase

```
public class RuleTestCase
extends Object
```
Test Case for the Digester class. These tests perform parsing of XML documents to exercise the built-in rules.

Author:

Craig R. McClanahan, Janek Bogucki

Field Summary

Fields
Modifier and Type Field and Description

protected Digester digester
The digester instance we will be processing.

Fields
Modifier and Type	Field and Description
`protected Digester`	`digester` The digester instance we will be processing.

Constructor Summary

Constructors
Constructor and Description

RuleTestCase()

Constructors
Constructor and Description
`RuleTestCase()`

Method Summary

Methods
Modifier and Type	Method and Description
`protected InputStream`	`getInputStream(String name)` Return an appropriate InputStream for the specified test file (which must be inside our current package.
`void`	`setUp()` Set up instance variables required by this test case.
`void`	`tearDown()` Tear down instance variables required by this test case.
`void`	`testAddRule()` Test rule addition - this boils down to making sure that digester is set properly on rule addition.
`void`	`testObjectCreate1()` Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned.
`void`	`testObjectCreate2()` Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned.
`void`	`testObjectCreate3()` Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned.
`void`	`testObjectCreate4()` Same as testObjectCreate1(), except use individual call method rules to set the properties of the Employee.
`void`	`testObjectCreate5()` Same as testObjectCreate1(), except use individual call method rules to set the properties of the Employee.
`void`	`testRepeatedParse()` It should be possible to parse the same input twice, and get trees of objects that are isomorphic but not be identical object instances.
`void`	`testRuleSet1()` Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned.
`void`	`testRuleSet2()` Same as `testRuleSet1` except using a single namespace.
`void`	`testRuleSet3()` Same as `testRuleSet2` except using a namespace for employee that we should recognize, and a namespace for address that we should skip.
`void`	`testSetCustomProperties()`
`void`	`testSetNext()`
`void`	`testSetTop()`
`void`	`testSetTopRule1()` Test the two argument version of the SetTopRule rule.
`void`	`testSetTopRule2()` Same as `testSetTopRule1` except using the three argument form of the SetTopRule rule.
`protected void`	`validateObjectCreate3(Object root)` Validate the assertions for ObjectCreateRule3.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - digester
```
protected Digester digester
```
    The digester instance we will be processing.
- Constructor Detail
  - RuleTestCase
```
public RuleTestCase()
```
- Method Detail
  - setUp
```
public void setUp()
```
    Set up instance variables required by this test case.
  - tearDown
```
public void tearDown()
```
    Tear down instance variables required by this test case.
  - testObjectCreate1
```
public void testObjectCreate1()
                       throws SAXException,
                              IOException
```
    Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned.
    
    Throws:
    
    SAXException
    
    IOException
  - testObjectCreate2
```
public void testObjectCreate2()
                       throws SAXException,
                              IOException
```
    Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned. The processing rules will process the nested Address elements as well, but will not attempt to add them to the Employee.
    
    Throws:
    
    SAXException
    
    IOException
  - testObjectCreate3
```
public void testObjectCreate3()
                       throws SAXException,
                              IOException
```
    Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned. The processing rules will process the nested Address elements as well, and will add them to the owning Employee.
    
    Throws:
    
    SAXException
    
    IOException
  - testObjectCreate4
```
public void testObjectCreate4()
                       throws SAXException,
                              IOException
```
    Same as testObjectCreate1(), except use individual call method rules to set the properties of the Employee.
    
    Throws:
    
    SAXException
    
    IOException
  - testObjectCreate5
```
public void testObjectCreate5()
                       throws SAXException,
                              IOException
```
    Same as testObjectCreate1(), except use individual call method rules to set the properties of the Employee. Bean data are defined using elements instead of attributes. The purpose is to test CallMethod with a paramCount=0 (ie the body of the element is the argument of the method).
    
    Throws:
    
    SAXException
    
    IOException
  - testRepeatedParse
```
public void testRepeatedParse()
                       throws SAXException,
                              IOException
```
    It should be possible to parse the same input twice, and get trees of objects that are isomorphic but not be identical object instances.
    
    Throws:
    
    SAXException
    
    IOException
  - testRuleSet1
```
public void testRuleSet1()
                  throws SAXException,
                         IOException
```
    Test object creation (and associated property setting) with nothing on the stack, which should cause an appropriate Employee object to be returned. The processing rules will process the nested Address elements as well, but will not attempt to add them to the Employee.
    
    Throws:
    
    SAXException
    
    IOException
  - testRuleSet2
```
public void testRuleSet2()
                  throws SAXException,
                         IOException
```
    Same as testRuleSet1 except using a single namespace.
    
    Throws:
    
    SAXException
    
    IOException
  - testRuleSet3
```
public void testRuleSet3()
                  throws SAXException,
                         IOException
```
    Same as testRuleSet2 except using a namespace for employee that we should recognize, and a namespace for address that we should skip.
    
    Throws:
    
    SAXException
    
    IOException
  - testSetTopRule1
```
public void testSetTopRule1()
                     throws SAXException,
                            IOException
```
    Test the two argument version of the SetTopRule rule. This test is based on testObjectCreate3 and should result in the same tree of objects. Instead of using the SetNextRule rule which results in a method invocation on the (top-1) (parent) object with the top object (child) as an argument, this test uses the SetTopRule rule which results in a method invocation on the top object (child) with the top-1 (parent) object as an argument. The three argument form is tested in testSetTopRule2.
    
    Throws:
    
    SAXException
    
    IOException
  - testSetTopRule2
```
public void testSetTopRule2()
                     throws SAXException,
                            IOException
```
    Same as testSetTopRule1 except using the three argument form of the SetTopRule rule.
    
    Throws:
    
    SAXException
    
    IOException
  - testAddRule
```
public void testAddRule()
```
    Test rule addition - this boils down to making sure that digester is set properly on rule addition.
  - testSetNext
```
public void testSetNext()
                 throws SAXException,
                        IOException
```
    Throws:
    
    SAXException
    
    IOException
  - testSetTop
```
public void testSetTop()
                throws SAXException,
                       IOException
```
    Throws:
    
    SAXException
    
    IOException
  - testSetCustomProperties
```
public void testSetCustomProperties()
                             throws SAXException,
                                    IOException
```
    Throws:
    
    SAXException
    
    IOException
  - getInputStream
```
protected InputStream getInputStream(String name)
                              throws IOException
```
    Return an appropriate InputStream for the specified test file (which must be inside our current package.
    
    Parameters:
    name - Name of the test file we want
    
    Throws:
    
    IOException - if an input/output error occurs
  - validateObjectCreate3
```
protected void validateObjectCreate3(Object root)
```
    Validate the assertions for ObjectCreateRule3.
    
    Parameters:
    root - Root object returned by digester.parse()

Class RuleTestCase

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

digester

Constructor Detail

RuleTestCase

Method Detail

setUp

tearDown

testObjectCreate1

testObjectCreate2

testObjectCreate3

testObjectCreate4

testObjectCreate5

testRepeatedParse

testRuleSet1

testRuleSet2

testRuleSet3

testSetTopRule1

testSetTopRule2

testAddRule

testSetNext

testSetTop

testSetCustomProperties

getInputStream

validateObjectCreate3