org.jbind.xml.instance.builder
Interface IDataBuilder

All Known Implementing Classes:
DataBuilder

public interface IDataBuilder


Method Summary
 void endElement(IElementImpl anElement, ILocation aLocation, IConstraintViolations aViolations)
          Creates the data object of the element.
 void initialize()
          Initializes the value builder.
 void signalText(IImplContainer aContainer, java.lang.String aText, ILocation aLocation, IConstraintViolations aViolations)
          Signals textual content.
 void startElement(IElementImpl anElement, IConstraintViolations aViolations)
          Starts an element.
 

Method Detail

initialize

public void initialize()
Initializes the value builder. Called by the data builder before a new data document is built.


startElement

public void startElement(IElementImpl anElement,
                         IConstraintViolations aViolations)
                  throws XmlException
Starts an element. The provided element (implementation) has not yet received its content.

Parameters:
anElement - (required).
aViolations - (required).
Throws:
XmlException - Raised if the element could not be started. The value builder must not be called until the element has ended. (The corresponding endElement call must also not be done.)

endElement

public void endElement(IElementImpl anElement,
                       ILocation aLocation,
                       IConstraintViolations aViolations)
                throws XmlException
Creates the data object of the element. The element implementation must be finished now. In particular, the textual content of the element implementation must be available in order to guide the creation of union data.

Parameters:
anElement - (required).
aLocation - (required). The location where the element ended.
aViolations - (required).
Throws:
XmlException - Raised if the data object could not be created.

signalText

public void signalText(IImplContainer aContainer,
                       java.lang.String aText,
                       ILocation aLocation,
                       IConstraintViolations aViolations)
Signals textual content.

Parameters:
aContainer - (required).
aText - (required).
aLocation - (required). The location where the text started.
aViolations - (required).