IBM Branch Transformation Toolkit Javadoc

com.ibm.dse.base
Class XMLFormat

java.lang.Object
  extended bycom.ibm.dse.base.FormatElement
      extended bycom.ibm.dse.base.KeyedCollectionFormat
          extended bycom.ibm.dse.base.RecordFormat
              extended bycom.ibm.dse.base.XMLFormat
All Implemented Interfaces:
Cacheable, Externalizable, java.io.Externalizable, java.io.Serializable

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.KeyedCollectionFormat
dataElementEmpty, elements
 
Fields inherited from class com.ibm.dse.base.FormatElement
dataElementName, externalizer, 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, getDataElementEmpty, getElements, getEnumeration, reinitialize, removeAll, removeAt, setElements, size, unformat, unformat
 
Methods inherited from class com.ibm.dse.base.FormatElement
exceptionInfo, externalizer, format, getDataElementName, getExternalizer, getName, getTagName, isCacheable, isConstant, isItConstant, readExternal, readExternal, readObject, 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
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
DSEInvalidClassException
DSEInvalidRequestException

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
DSEInvalidClassException
DSEInvalidRequestException

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
Throws:
DSEInvalidClassException
DSEInvalidRequestException
DSEInvalidArgumentException

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
Throws:
DSEInvalidClassException
DSEInvalidRequestException
DSEInvalidArgumentException

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.

Returns:
java.lang.String

getPreTag

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

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

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.

Specified by:
initializeFrom in interface Externalizable
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.

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.

Specified by:
toStrings in interface Externalizable
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.
DSEInvalidRequestException
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
aKeyedCollection - com.ibm.dse.base.KeyedCollection
Returns:
com.ibm.dse.base.DataElement
Throws:
com.ibm.dse.base.DSEInvalidRequestException,
DSEInvalidArgumentException
DSEInvalidRequestException

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:
aDataElement - com.ibm.dse.base.DataElement
aFormatElement - com.ibm.dse.base.FormatElement
Returns:
java.lang.String
Throws:
com.ibm.dse.base.DSEInvalidRequestException,
DSEInvalidArgumentException
DSEObjectNotFoundException
DSEInvalidRequestException

IBM Branch Transformation Toolkit Javadoc

(c) Copyright IBM Corporation 1998, 2005