XmlBuilder

All Known Implementing Classes:

AbstractXmlBuilder, CompositeBuilder
```
public interface XmlBuilder
```
An XmlBuilder is an interface that can be implemented by classes that convert between XmlElements and some internal data representation. The main reason for doing so is to allow other builders to "reuse" parts of an XML DTD. For example, we could have a builder that builds Java2D objects, such as "line" and "polygon". Then some other builder, that for example builds libraries of graphical icons, can use an instance of the Java2D builder internally -- if it does not recognize the type of an XML element, it calls the Java2D builder to see if it can get a low-level graphical object.

Version:

$Id$

Author:

John Reekie

Pt.AcceptedRating:

Red

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method	Description
`java.lang.Object`	`build(XmlElement elt, java.lang.String type)`	Given an XmlElement, create and return an internal representation of it.
`XmlElement`	`generate(java.lang.Object obj)`	Given an object, produce an XML representation of it.
`void`	`setDelegate(XmlBuilder child)`	Delegate builders can be used to build/generate for objects that are unknown by the current builder, as might be the case in a hierarchy of heterogeneous objects.

- Method Detail
  - build
```
java.lang.Object build(XmlElement elt,
                       java.lang.String type)
                throws java.lang.Exception
```
    Given an XmlElement, create and return an internal representation of it. Implementors should also provide a more type-specific version of this method:
    public Graph build (XmlElement elt, String type);
    Throws:
    
    java.lang.Exception
  - setDelegate
```
void setDelegate(XmlBuilder child)
```
    Delegate builders can be used to build/generate for objects that are unknown by the current builder, as might be the case in a hierarchy of heterogeneous objects.
    
    See Also:
    
    CompositeBuilder
  - generate
```
XmlElement generate(java.lang.Object obj)
             throws java.lang.Exception
```
    Given an object, produce an XML representation of it.
    
    Throws:
    
    java.lang.Exception