com.planet_ink.coffee_mud.Libraries.interfaces
Interface XMLLibrary

All Superinterfaces:

java.lang.Cloneable, CMLibrary, CMObject, java.lang.Comparable<CMObject>

All Known Implementing Classes:

XMLManager

public interface XMLLibrary
extends CMLibrary

Nested Class Summary

static class

XMLLibrary.XMLpiece

Field Summary

static java.lang.String	FILE_XML_BOUNDARY
static java.lang.String	HEX_DIGITS

Method Summary

java.lang.String	convertXMLtoTag(java.lang.String TName, boolean Data) Return the outer wrapper and contents of an XML tag Data Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);
java.lang.String	convertXMLtoTag(java.lang.String TName, int Data) Return the outer wrapper and contents of an XML tag Data Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);
java.lang.String	convertXMLtoTag(java.lang.String TName, long Data) Return the outer wrapper and contents of an XML tag Data Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);
java.lang.String	convertXMLtoTag(java.lang.String TName, short Data) Return the outer wrapper and contents of an XML tag Data Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);
java.lang.String	convertXMLtoTag(java.lang.String TName, java.lang.String Data) Return the outer wrapper and contents of an XML tag Data Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);
boolean	getBoolFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Return the data value within a given XML block Data Usage: String ThisColHead=getBoolFromPieces(ThisRow,"TD");
java.util.List<XMLLibrary.XMLpiece>	getContentsFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Returns the contents of a container tag, searched for in another container tags contents
double	getDoubleFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Return the data value within a given XML block Data Usage: String ThisColHead=getDoubleFromPieces(ThisRow,"TD");
int	getIntFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Return the data value within a given XML block Data Usage: String ThisColHead=getIntFromPieces(ThisRow,"TD");
long	getLongFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Return the data value within a given XML block Data Usage: String ThisColHead=getLongFromPieces(ThisRow,"TD");
java.lang.String	getParmValue(java.util.Map<java.lang.String,java.lang.String> parmSet, java.lang.String Tag) Return a parameter value within an XML tag Usage: String ThisColHead=getParmValue(parmSet,"TD");
XMLLibrary.XMLpiece	getPieceFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Returns the xml tag node for the given tag name, if found in the given tag container contents
short	getShortFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Return the data value within a given XML block Data Usage: String ThisColHead=getShortFromPieces(ThisRow,"TD");
java.lang.String	getValFromPieces(java.util.List<XMLLibrary.XMLpiece> V, java.lang.String tag) Returns the value of the tag, if it exists in the given tag collection
java.lang.String	getXMLList(java.util.List<java.lang.String> V) Converts the given list of strings into a set of top-level xml tags called simply
java.util.List<XMLLibrary.XMLpiece>	parseAllXML(java.lang.String buf) Parses all xml inside the given string buffer and returns the root tags as a container collection.
java.util.List<XMLLibrary.XMLpiece>	parseAllXML(java.lang.StringBuffer buf) Parses all xml inside the given stringbuffer and returns the root tags as a container collection.
java.lang.String	parseOutAngleBrackets(java.lang.String s) parse a tag value for safety Usage: String val=parseOutAngleBrackets(ThisValue);
java.util.List<java.lang.String>	parseXMLList(java.lang.String numberedList) Parses a list of single-level xml tags, together in string.
java.lang.String	restoreAngleBrackets(java.lang.String s) restore a tag value parsed for safety Usage: String val=restoreAngleBrackets(ThisValue);
java.lang.String	returnXMLBlock(java.lang.String Blob, java.lang.String Tag) Return the contents of an XML tag, given the tag to search for Usage: String XML=returnXMLBlock(Response,"PDIModelErrors");
boolean	returnXMLBoolean(java.lang.String Blob, java.lang.String Tag) Return the data value within a given XML block Data Usage: String ThisColHead=returnXMLValue(ThisRow,"TD");
java.lang.String	returnXMLValue(java.lang.String Blob) Return the data value within the first XML block Data Usage: String ThisColHead=returnXMLValue(ThisRow);
java.lang.String	returnXMLValue(java.lang.String Blob, java.lang.String Tag) Return the data value within a given XML block Data Usage: String ThisColHead=returnXMLValue(ThisRow,"TD");

Methods inherited from interface com.planet_ink.coffee_mud.Libraries.interfaces.CMLibrary

activate, getSupportThread, propertiesLoaded, shutdown

Methods inherited from interface com.planet_ink.coffee_mud.core.interfaces.CMObject

copyOf, ID, initializeClass, newInstance

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

HEX_DIGITS

static final java.lang.String HEX_DIGITS

See Also:

Constant Field Values

FILE_XML_BOUNDARY

static final java.lang.String FILE_XML_BOUNDARY

See Also:

Constant Field Values

Method Detail

convertXMLtoTag

java.lang.String convertXMLtoTag(java.lang.String TName,
                                 java.lang.String Data)

Return the outer wrapper and contents of an XML tag Data

Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);

Parameters:

TName - Tag name to use

Data - the data

Returns:

String Information corresponding to the tname

convertXMLtoTag

java.lang.String convertXMLtoTag(java.lang.String TName,
                                 int Data)

Return the outer wrapper and contents of an XML tag Data

Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);

Parameters:

TName - Tag name to use

Data - the data

Returns:

String Information corresponding to the tname

convertXMLtoTag

java.lang.String convertXMLtoTag(java.lang.String TName,
                                 short Data)

Return the outer wrapper and contents of an XML tag Data

Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);

Parameters:

TName - Tag name to use

Data - the data

Returns:

String Information corresponding to the tname

convertXMLtoTag

java.lang.String convertXMLtoTag(java.lang.String TName,
                                 boolean Data)

Return the outer wrapper and contents of an XML tag Data

Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);

Parameters:

TName - Tag name to use

Data - the data

Returns:

String Information corresponding to the tname

convertXMLtoTag

java.lang.String convertXMLtoTag(java.lang.String TName,
                                 long Data)

Return the outer wrapper and contents of an XML tag Data

Usage: Data+=XMLoTag("MODELOBJECTONE",VA.ModelObjectOne);

Parameters:

TName - Tag name to use

Data - the data

Returns:

String Information corresponding to the tname

returnXMLBlock

java.lang.String returnXMLBlock(java.lang.String Blob,
                                java.lang.String Tag)

Return the contents of an XML tag, given the tag to search for

Usage: String XML=returnXMLBlock(Response,"PDIModelErrors");

Parameters:

Blob - String to searh

Tag - Tag name to search for

Returns:

String Information corresponding to the tname

getValFromPieces

java.lang.String getValFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                                  java.lang.String tag)

Returns the value of the tag, if it exists in the given tag collection

Parameters:

V - the tag collection (container tag)

tag - the tag to look for

Returns:

its value, or null

getContentsFromPieces

java.util.List<XMLLibrary.XMLpiece> getContentsFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                                                          java.lang.String tag)

Returns the contents of a container tag, searched for in another container tags contents

Parameters:

V - the container tags contents

tag - the tag to look for

Returns:

the tags contained in tag, or null

getPieceFromPieces

XMLLibrary.XMLpiece getPieceFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                                       java.lang.String tag)

Returns the xml tag node for the given tag name, if found in the given tag container contents

Parameters:

V - the tag container contents

tag - the tag name

Returns:

the xml tag node for the given tag name

getBoolFromPieces

boolean getBoolFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                          java.lang.String tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=getBoolFromPieces(ThisRow,"TD");

Parameters:

V - Pieces to search

tag - Tag to search for

Returns:

boolean Information from XML block

getShortFromPieces

short getShortFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                         java.lang.String tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=getShortFromPieces(ThisRow,"TD");

Parameters:

V - Pieces to search

tag - Tag to search for

Returns:

short Information from XML block

getIntFromPieces

int getIntFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                     java.lang.String tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=getIntFromPieces(ThisRow,"TD");

Parameters:

V - Pieces to search

tag - Tag to search for

Returns:

int Information from XML block

getLongFromPieces

long getLongFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                       java.lang.String tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=getLongFromPieces(ThisRow,"TD");

Parameters:

V - Pieces to search

tag - Tag to search for

Returns:

long Information from XML block

getDoubleFromPieces

double getDoubleFromPieces(java.util.List<XMLLibrary.XMLpiece> V,
                           java.lang.String tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=getDoubleFromPieces(ThisRow,"TD");

Parameters:

V - Pieces to search

tag - Tag to search for

Returns:

double Information from XML block

parseAllXML

java.util.List<XMLLibrary.XMLpiece> parseAllXML(java.lang.String buf)

Parses all xml inside the given string buffer and returns the root tags as a container collection.

Parameters:

buf - the string to parse

Returns:

the parsed xml

parseAllXML

java.util.List<XMLLibrary.XMLpiece> parseAllXML(java.lang.StringBuffer buf)

Parses all xml inside the given stringbuffer and returns the root tags as a container collection.

Parameters:

buf - the string to parse

Returns:

the parsed xml

parseXMLList

java.util.List<java.lang.String> parseXMLList(java.lang.String numberedList)

Parses a list of single-level xml tags, together in string. This method assumes that the given string is a series of top level tags, with no child tags, and no attributes. It will parse the tags, and return their values (only) as a list of strings. Any deconversions for compatibility are also performed

Parameters:

numberedList - the top level xml tags

Returns:

the list of strings with the values of those tags

getXMLList

java.lang.String getXMLList(java.util.List<java.lang.String> V)

Converts the given list of strings into a set of top-level xml tags called simply

Parameters:

V - the list of strings

Returns:

the top level xml tags

returnXMLValue

java.lang.String returnXMLValue(java.lang.String Blob)

Return the data value within the first XML block Data

Usage: String ThisColHead=returnXMLValue(ThisRow);

Parameters:

Blob - String to searh

Returns:

String Information from first XML block

returnXMLValue

java.lang.String returnXMLValue(java.lang.String Blob,
                                java.lang.String Tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=returnXMLValue(ThisRow,"TD");

Parameters:

Blob - String to search

Tag - Tag to search for

Returns:

String Information from XML block

returnXMLBoolean

boolean returnXMLBoolean(java.lang.String Blob,
                         java.lang.String Tag)

Return the data value within a given XML block Data

Usage: String ThisColHead=returnXMLValue(ThisRow,"TD");

Parameters:

Blob - String to search

Tag - Tag to search for

Returns:

String Information from XML block

getParmValue

java.lang.String getParmValue(java.util.Map<java.lang.String,java.lang.String> parmSet,
                              java.lang.String Tag)

Return a parameter value within an XML tag

Usage: String ThisColHead=getParmValue(parmSet,"TD");

Parameters:

parmSet - set of parms to search

Tag - Tag to search for

Returns:

String Parameter value

parseOutAngleBrackets

java.lang.String parseOutAngleBrackets(java.lang.String s)

parse a tag value for safety

Usage: String val=parseOutAngleBrackets(ThisValue);

Parameters:

s - String to parse

Returns:

String parsed value

restoreAngleBrackets

java.lang.String restoreAngleBrackets(java.lang.String s)

restore a tag value parsed for safety

Usage: String val=restoreAngleBrackets(ThisValue);

Parameters:

s - String to parse

Returns:

String unparsed value