NodeCreator (ActiveObjects Plugin - Parent POM 2.0.1-0fc30df API)

```
public interface NodeCreator
```
Represents a node in streaming XML documents. This is a small abstraction layer over StAX that allows other streaming data formats to be created (JSON, ASN.1, ?) and make it easier to deal with StAX, of which the API can be a bit tedious. This interface also provides type conversion instead of just strings. This interface only provides write access to a streaming node graph.

Author:

Erik van Zijst

See Also:

counterpart of this interface that provides read access to streaming node graphs., NodeStreamWriter

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`NodeCreator`	`addAttribute(String key, String value)` Adds an attribute to the current node.
`NodeCreator`	`addNode(String name)` Creates a new child node under the current node.
`NodeCreator`	`closeEntity()` Closes the current node and returns a reference to the parent node.
`NodeCreator`	`setContent(Reader data)` Similar to `setContentAsString(String)`, but passes the content to the `NodeCreator` as a `Reader` instance.
`NodeCreator`	`setContentAsBigDecimal(BigDecimal bigDecimal)`
`NodeCreator`	`setContentAsBigInteger(BigInteger bigInteger)` Similar to `setContentAsString(String)`, but sets the content to the specified `BigInteger` instance.
`NodeCreator`	`setContentAsBinary(byte[] bytes)` Similar to `setContentAsString(String)`, but sets the content to the specified `byte[]` instance.
`NodeCreator`	`setContentAsBoolean(Boolean bool)` Similar to `setContentAsString(String)`, but sets the content to the specified `Boolean` instance.
`NodeCreator`	`setContentAsDate(Date date)` Similar to `setContentAsString(String)`, but sets the content to the specified `Date` instance.
`NodeCreator`	`setContentAsString(String string)` Sets the content of the current node to be the specified string.

- Method Detail
  - addNode
```
NodeCreator addNode(String name)
```
    Creates a new child node under the current node.
    
    Parameters:
    
    name - the name of the new child node.
    
    Returns:
    
    a reference to the new node. Continue with this reference.
  - closeEntity
```
NodeCreator closeEntity()
```
    Closes the current node and returns a reference to the parent node.
    
    Returns:
    
    a reference to the parent node. Continue with this reference.
  - setContentAsDate
```
NodeCreator setContentAsDate(Date date)
```
    Similar to setContentAsString(String), but sets the content to the specified Date instance.
    
    Parameters:
    
    date - the value to set
    
    Returns:
    
    a reference to the current node.
  - setContentAsBigInteger
```
NodeCreator setContentAsBigInteger(BigInteger bigInteger)
```
    Similar to setContentAsString(String), but sets the content to the specified BigInteger instance.
    
    Parameters:
    
    bigInteger - the value to set
    
    Returns:
    
    a reference to the current node.
  - setContentAsBigDecimal
```
NodeCreator setContentAsBigDecimal(BigDecimal bigDecimal)
```
  - setContentAsString
```
NodeCreator setContentAsString(String string)
```
    Sets the content of the current node to be the specified string. This method does not automatically close the node, but returns a reference to the current node. The caller is responsible for closing the node using closeEntity().
    Use null to explicitly encode the null value (results in <node xsi:nil="true"/> in XML, while an empty string produces <node></node>).
    
    Parameters:
    
    string - the content for the current node.
    
    Returns:
    
    a reference to the current node.
  - setContentAsBoolean
```
NodeCreator setContentAsBoolean(Boolean bool)
```
    Similar to setContentAsString(String), but sets the content to the specified Boolean instance.
    
    Parameters:
    
    bool - the value to set
    
    Returns:
    
    a reference to the current node.
  - setContentAsBinary
```
NodeCreator setContentAsBinary(byte[] bytes)
```
    Similar to setContentAsString(String), but sets the content to the specified byte[] instance.
    
    Parameters:
    
    bytes - the value to set
    
    Returns:
    
    a reference to the current node.
  - setContent
```
NodeCreator setContent(Reader data)
                throws IOException
```
    Similar to setContentAsString(String), but passes the content to the NodeCreator as a Reader instance. Use this to encode large chunks of content in a memory-efficient way.
    
    Parameters:
    
    data - the content to set
    
    Returns:
    
    a reference to the current node.
    
    Throws:
    
    IOException
  - addAttribute
```
NodeCreator addAttribute(String key,
                         String value)
```
    Adds an attribute to the current node.
    
    Parameters:
    
    key - the attribute key
    
    value - the attribute value

Interface NodeCreator

Method Summary

Method Detail

addNode

closeEntity

setContentAsDate

setContentAsBigInteger

setContentAsBigDecimal

setContentAsString

setContentAsBoolean

setContentAsBinary

setContent

addAttribute