com.ibm.dse.base
Class XMLFormat

java.lang.Object
  |
  +--com.ibm.dse.base.FormatElement
        |
        +--com.ibm.dse.base.KeyedCollectionFormat
              |
              +--com.ibm.dse.base.RecordFormat
                    |
                    +--com.ibm.dse.base.XMLFormat

public class XMLFormat
extends RecordFormat

This class formats a KeyedCollection to an XML-compliant format.

See Also:
Serialized Form

Field Summary
protected  java.lang.String includeDataType
          includeDataType tag attribute.
protected  java.lang.String unNamed
          unNamed tag attribute.
 
Fields inherited from class com.ibm.dse.base.FormatElement
dataElementName, name
 
Constructor Summary
XMLFormat()
          This constructor creates an XMLFormat object.
XMLFormat(java.lang.String aName)
          This constructor creates an XMLFormat object with a specified name.
 
Method Summary
 java.lang.String[] extract(java.lang.String aString)
          Extracts a String taking the substring in which the format is interested.
 java.lang.String[] extractElement(java.lang.String elementName, java.lang.String aString)
          Extracts from aString the element named elementName.
 java.lang.String format(Context aContext)
          Formats data elements getting them from the context.
 java.lang.String format(KeyedCollection aKeyedCollection)
          Formats data elements getting them from the collection passes as a parameter.
 java.lang.String formatAsXML(DataElement aDataElement, FormatElement aFormatElement)
          Formats aDataElement to an XML-compliant format.
 java.lang.String formatContext(Context aContext)
          This method performs the format seeking the elements to format around the context tree of the context passed as parameter.
 java.lang.String formatKeyedCollection(KeyedCollection aKeyedCollection)
          This method performs the format seeking the elements to format around the keyedCollection passed as parameter.
 java.lang.String getIncludeDataType()
          Gets the includeDataType property value.
protected  java.lang.String getPostTag(java.lang.String aName)
          Returns the tag that follows each DataElement.
protected  java.lang.String getPreTag(java.lang.String aName)
          Returns the tag that preceeds each DataElement.
protected  java.lang.String getPreTag(java.lang.String aName, java.lang.String aType)
          Returns the tag already built.
protected  java.lang.String getType(FormatElement aFormatElement)
          Returns the type of the DataElement referenced in the FormatElement
 java.lang.String getUnNamed()
          Returns the value of the unNamed property.
 java.lang.Object initializeFrom(Tag aTag)
          Initializes an XMLFormat with the aTag attributes.
 boolean isIncludeDataType()
          Returns the boolean value of the includeDataType property
 boolean isUnNamed()
          Returns the boolean value of the unNamed property
 void setIncludeDataType(java.lang.String aString)
          Sets the includeDataType property (String) value.
 void setUnNamed(java.lang.String newUnNamed)
          Sets the value of the unNamed property.
 Vector toStrings()
          Returns a visual representation of this format element.
 DataElement unformatContext(java.lang.String aString, Context aContext)
          Unformats an XMLFormat updating data elements in the context.
 KeyedCollection unformatKeyedCollection(java.lang.String aString, KeyedCollection aKeyedCollection)
          Unformats an XMLFormat updating data elements in the collection passed as a parameter.
 void unformatXML(java.lang.String aString, DataElement aDataElement, FormatElement aFormatElement)
          This method unformats a String XML compliant format in aDataElement.
 
Methods inherited from class com.ibm.dse.base.RecordFormat
obtainDataElement, obtainDataElement, toString
 
Methods inherited from class com.ibm.dse.base.KeyedCollectionFormat
add, addElementAt, addFirst, at, format, getElements, getEnumeration, removeAll, removeAt, setElements, size, unformat, unformat
 
Methods inherited from class com.ibm.dse.base.FormatElement
exceptionInfo, externalizer, format, getDataElementName, getExternalizer, getName, getTagName, isCacheable, isConstant, readExternal, readExternal, readObject, reinitialize, removeExternal, rootDecorated, setDataElementName, setExternalizer, setName, setSize, toTags, unformat, writeExternal, writeExternal
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

includeDataType

protected java.lang.String includeDataType
includeDataType tag attribute.

unNamed

protected java.lang.String unNamed
unNamed tag attribute.
Constructor Detail

XMLFormat

public XMLFormat()
This constructor creates an XMLFormat object.

XMLFormat

public XMLFormat(java.lang.String aName)
          throws java.io.IOException
This constructor creates an XMLFormat object with a specified name.
Parameters:
aName - java.lang.String
Throws:
java.io.IOException -  
Method Detail

extract

public java.lang.String[] extract(java.lang.String aString)
                           throws DSEInvalidArgumentException
Extracts a String taking the substring in which the format is interested.
Overrides:
extract in class RecordFormat
Parameters:
String - aString, a string which contains formated strings
Returns:
String[] - the first element is the part of the provided string that is able to unformat and the second is the rest of the provided string
Throws:
DSEInvalidArgumentException -  

extractElement

public java.lang.String[] extractElement(java.lang.String elementName,
                                         java.lang.String aString)
Extracts from aString the element named elementName.
Parameters:
elementName - java.lang.String
aString - java.lang.String
Returns:
String[]

format

public java.lang.String format(Context aContext)
                        throws DSEInvalidClassException,
                               DSEInvalidRequestException,
                               DSEInvalidArgumentException
Formats data elements getting them from the context.
Overrides:
format in class KeyedCollectionFormat
Parameters:
aContext - com.ibm.dse.base.Context
Returns:
java.lang.String
Throws:
com.ibm.dse.base.DSEInvalidClassException. -  
com.ibm.dse.base.DSEInvalidRequestException, -  
DSEInvalidArgumentException -  

format

public java.lang.String format(KeyedCollection aKeyedCollection)
                        throws DSEInvalidClassException,
                               DSEInvalidRequestException,
                               DSEInvalidArgumentException
Formats data elements getting them from the collection passes as a parameter.
Parameters:
aKeyedCollection - com.ibm.dse.base.KeyedCollection
Returns:
java.lang.String
Throws:
com.ibm.dse.base.DSEInvalidClassException. -  
com.ibm.dse.base.DSEInvalidRequestException, -  
DSEInvalidArgumentException -  

formatAsXML

public java.lang.String formatAsXML(DataElement aDataElement,
                                    FormatElement aFormatElement)
Formats aDataElement to an XML-compliant format.
Parameters:
aDataElement - com.ibm.dse.base.DataElement
aFormatElement - com.ibm.dse.base.FormatElement
Returns:
java.lang.String

formatContext

public java.lang.String formatContext(Context aContext)
                               throws DSEInvalidClassException,
                                      DSEInvalidRequestException,
                                      DSEInvalidArgumentException
This method performs the format seeking the elements to format around the context tree of the context passed as parameter.
Overrides:
formatContext in class RecordFormat
Parameters:
aContext - com.ibm.dse.base.Context
Returns:
java.lang.String

formatKeyedCollection

public java.lang.String formatKeyedCollection(KeyedCollection aKeyedCollection)
                                       throws DSEInvalidClassException,
                                              DSEInvalidRequestException,
                                              DSEInvalidArgumentException
This method performs the format seeking the elements to format around the keyedCollection passed as parameter.
Overrides:
formatKeyedCollection in class RecordFormat
Parameters:
aKeyedCollection - com.ibm.dse.base.KeyedCollection
Returns:
java.lang.String

getIncludeDataType

public java.lang.String getIncludeDataType()
Gets the includeDataType property value.
Returns:
The includeDataType property value.
See Also:
setIncludeDataType(java.lang.String)

getPostTag

protected java.lang.String getPostTag(java.lang.String aName)
Returns the tag that follows each DataElement.
Parameters:
String - aName
Returns:
java.lang.String

getPreTag

protected java.lang.String getPreTag(java.lang.String aName)
Returns the tag that preceeds each DataElement.
Parameters:
String - aName
Returns:
java.lang.String

getPreTag

protected java.lang.String getPreTag(java.lang.String aName,
                                     java.lang.String aType)
Returns the tag already built.
Parameters:
aName - String
aType - String

getType

protected java.lang.String getType(FormatElement aFormatElement)
Returns the type of the DataElement referenced in the FormatElement
Parameters:
FormatElement - aFormatElement
Returns:
java.lang.String

getUnNamed

public java.lang.String getUnNamed()
Returns the value of the unNamed property.
Returns:
java.lang.String - The current value of unNamed

initializeFrom

public java.lang.Object initializeFrom(Tag aTag)
                                throws java.io.IOException
Initializes an XMLFormat with the aTag attributes.
Overrides:
initializeFrom in class RecordFormat
Parameters:
aTag - com.ibm.dse.base.Tag
Returns:
java.lang.Object
Throws:
java.io.IOException -  

isIncludeDataType

public boolean isIncludeDataType()
Returns the boolean value of the includeDataType property
Returns:
boolean.
See Also:
getIncludeDataType(), setIncludeDataType(java.lang.String)

isUnNamed

public boolean isUnNamed()
Returns the boolean value of the unNamed property
Returns:
boolean.
See Also:
getUnNamed(), setUnNamed(java.lang.String)

setIncludeDataType

public void setIncludeDataType(java.lang.String aString)
Sets the includeDataType property (String) value.
Parameters:
The - includeDataType property value.
See Also:
getIncludeDataType()

setUnNamed

public void setUnNamed(java.lang.String newUnNamed)
Sets the value of the unNamed property.
Parameters:
newUnNamed - java.lang.String The new value of the property.

toStrings

public Vector toStrings()
Description copied from class: FormatElement
Returns a visual representation of this format element.
Overrides:
toStrings in class RecordFormat
Returns:
Tag[]

unformatContext

public DataElement unformatContext(java.lang.String aString,
                                   Context aContext)
                            throws DSEInvalidRequestException,
                                   DSEInvalidArgumentException
Unformats an XMLFormat updating data elements in the context.
Overrides:
unformatContext in class RecordFormat
Parameters:
aString - java.lang.String
aContext - com.ibm.dse.base.Context
Returns:
com.ibm.dse.base.DataElement
Throws:
com.ibm.dse.base.DSEInvalidRequestException. -  
com.ibm.dse.base.DSEInvalidArgumentException. -  

unformatKeyedCollection

public KeyedCollection unformatKeyedCollection(java.lang.String aString,
                                               KeyedCollection aKeyedCollection)
                                        throws DSEInvalidRequestException,
                                               DSEInvalidArgumentException
Unformats an XMLFormat updating data elements in the collection passed as a parameter.
Overrides:
unformatKeyedCollection in class RecordFormat
Parameters:
aString - java.lang.String
aContext - com.ibm.dse.base.Context
Returns:
com.ibm.dse.base.DataElement
Throws:
com.ibm.dse.base.DSEInvalidRequestException, -  
DSEInvalidArgumentException -  

unformatXML

public void unformatXML(java.lang.String aString,
                        DataElement aDataElement,
                        FormatElement aFormatElement)
                 throws DSEInvalidRequestException,
                        DSEInvalidArgumentException,
                        DSEObjectNotFoundException
This method unformats a String XML compliant format in aDataElement.
Parameters:
String - aString
aDataElement - com.ibm.dse.base.DataElement
aFormatElement - com.ibm.dse.base.FormatElement
Returns:
java.lang.String
Throws:
com.ibm.dse.base.DSEInvalidRequestException, -  
DSEInvalidArgumentException -  
DSEObjectNotFoundException -