com.steelypip.powerups.minxml

Class FlexiMinXMLBuilder

java.lang.Object

com.steelypip.powerups.minxml.FlexiMinXMLBuilder

All Implemented Interfaces:

MinXMLBuilder

public class FlexiMinXMLBuilder
extends java.lang.Object
implements MinXMLBuilder

This implementation of MinXMLBuilder is maximally flexible:

• It accepts null element names in startTagOpen, startTagClose and endTag.
• The startTagClose method may be omitted in the build sequence.
• After build is called, the builder can be reused.

Constructor Summary

Constructors

Constructor and Description
FlexiMinXMLBuilder()

Method Summary

Modifier and Type	Method and Description
MinXML	build() This method returns the constructed tree.
void	endTag(java.lang.String name) This method finishes the construction of the current element.
void	put(java.lang.String key, java.lang.String value) This method adds the attribute key=value to the start tag that is under construction.
void	startTagClose(java.lang.String name) This method finishes the construction of the current start tag.
void	startTagOpen(java.lang.String name) This method should be called to begin the construction of a start-tag with a particular element name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FlexiMinXMLBuilder

public FlexiMinXMLBuilder()

Method Detail

startTagOpen

public void startTagOpen(java.lang.String name)

Description copied from interface: MinXMLBuilder

This method should be called to begin the construction of a start-tag with a particular element name. An implementation may insist on the name being non-null or may permit it to be supplied later. After this method, the next builder method should be put or startTagClose.

Specified by:

startTagOpen in interface MinXMLBuilder

Parameters:

name - the name of the element to be constructed (or null).

put

public void put(java.lang.String key,
                java.lang.String value)

Description copied from interface: MinXMLBuilder

This method adds the attribute key=value to the start tag that is under construction. The builder method starTagOpen must have been the immediately previous method.

Specified by:

put in interface MinXMLBuilder

Parameters:

key - the attribute key

value - the attribute value

startTagClose

public void startTagClose(java.lang.String name)

Description copied from interface: MinXMLBuilder

This method finishes the construction of the current start tag. It may be followed by a call to endTag or startTagOpen. If the tag name is not-null it must agree with the previous value. If the previous value was null then it automatically is in agreement. An implementation may choose to make startTagClose optional, implicitly closing it when the next startTagOpen is invoked.

Specified by:

startTagClose in interface MinXMLBuilder

Parameters:

name - the name of the element to be constructed (or null)

endTag

public void endTag(java.lang.String name)

Description copied from interface: MinXMLBuilder

This method finishes the construction of the current element. If the tag-name is non-null then it must be in agreement with the previous value. If the previous value is null then it is automatically in agreement.

Specified by:

endTag in interface MinXMLBuilder

Parameters:

name - the name of the element to be constructed (or null)

build

public MinXML build()

Description copied from interface: MinXMLBuilder

This method returns the constructed tree. An implementation may elect to make the builder reusable again.

Specified by:

build in interface MinXMLBuilder

Returns:

the constructed tree