Package adams.data.conversion
Class XMLToDOM
-
- All Implemented Interfaces:
AdditionalInformationHandler
,CleanUpHandler
,Destroyable
,GlobalInfoSupporter
,LoggingLevelHandler
,LoggingSupporter
,OptionHandler
,QuickInfoSupporter
,ShallowCopySupporter<AbstractConversion>
,SizeOfHandler
,Stoppable
,Conversion
,ConversionFromString
,Serializable
public class XMLToDOM extends AbstractConversionFromString
Turns an XML string into a org.w3c.dom.Document DOM object.
Valid options are:
-logging-level <OFF|SEVERE|WARNING|INFO|CONFIG|FINE|FINER|FINEST> (property: loggingLevel) The logging level for outputting errors and debugging output. default: WARNING
-validating <boolean> (property: validating) If enabled, the parser will validate the XML. default: false
-name-space-aware <boolean> (property: nameSpaceAware) If enabled, the parser will be namespace aware. default: false
-x-include-aware <boolean> (property: XIncludeAware) If enabled, the parser will be X-include aware. default: false
-expand-entity-references <boolean> (property: expandEntityReferences) If enabled, the parser will expand entity references. default: false
-ignoring-comments <boolean> (property: ignoringComments) If enabled, the parser will ignore comments. default: false
-coalescing <boolean> (property: coalescing) If enabled, then parser will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node. default: false
-ignoring-whitespace <boolean> (property: ignoringWhitespace) If enabled, the parser will ignore whitespaces in element content. default: false
- Version:
- $Revision$
- Author:
- fracpete (fracpete at waikato dot ac dot nz)
- See Also:
- Serialized Form
-
-
Field Summary
Fields Modifier and Type Field Description protected boolean
m_Coalescing
Specifies that the parser produced by this code will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node.protected boolean
m_ExpandEntityReferences
Specifies that the parser produced by this code will expand entity reference nodes.protected boolean
m_IgnoringComments
Specifies that the parser produced by this code will ignore comments.protected boolean
m_IgnoringWhitespace
Specifies that the parsers created by this factory must eliminate whitespace in element content.protected boolean
m_NameSpaceAware
whether the parser is namespace aware.protected boolean
m_Validating
whether the parser is validating or not.protected boolean
m_XIncludeAware
Set state of XInclude processing.-
Fields inherited from class adams.data.conversion.AbstractConversion
m_Input, m_Output, m_Owner, m_Stopped
-
Fields inherited from class adams.core.option.AbstractOptionHandler
m_OptionManager
-
Fields inherited from class adams.core.logging.LoggingObject
m_Logger, m_LoggingIsEnabled, m_LoggingLevel
-
-
Constructor Summary
Constructors Constructor Description XMLToDOM()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description String
coalescingTipText()
Returns the tip text for this property.void
defineOptions()
Adds options to the internal list of options.protected Object
doConvert()
Performs the actual conversion.String
expandEntityReferencesTipText()
Returns the tip text for this property.Class
generates()
Returns the class that is generated as output.boolean
getCoalescing()
Returns whether a coalescing parser is used.boolean
getExpandEntityReferences()
Returns whether a parser expands entity references.boolean
getIgnoringComments()
Returns whether parser ignores commentsboolean
getIgnoringWhitespace()
Returns whether parser ignores whitespaces in element content.boolean
getNameSpaceAware()
Returns whether a namespace aware parser used.boolean
getValidating()
Returns whether a validating parser is used.boolean
getXIncludeAware()
Returns whether a X-include aware parser is used.String
globalInfo()
Returns a string describing the object.String
ignoringCommentsTipText()
Returns the tip text for this property.String
ignoringWhitespaceTipText()
Returns the tip text for this property.String
nameSpaceAwareTipText()
Returns the tip text for this property.void
setCoalescing(boolean value)
Sets whether to use a coalescing parser.void
setExpandEntityReferences(boolean value)
Sets whether to expand entity references.void
setIgnoringComments(boolean value)
Sets whether to ignore comments.void
setIgnoringWhitespace(boolean value)
Sets whether to ignore whitespaces in element content.void
setNameSpaceAware(boolean value)
Sets whether to use a namespace aware parser.void
setValidating(boolean value)
Sets whether to use a validating parser.void
setXIncludeAware(boolean value)
Sets whether to use a X-include aware parser.String
validatingTipText()
Returns the tip text for this property.String
XIncludeAwareTipText()
Returns the tip text for this property.-
Methods inherited from class adams.data.conversion.AbstractConversionFromString
accepts
-
Methods inherited from class adams.data.conversion.AbstractConversion
checkData, cleanUp, convert, getAdditionalInformation, getInput, getInput, getOutput, getOutput, getOwner, getQuickInfo, reset, setInput, setOwner, shallowCopy, shallowCopy, stopExecution
-
Methods inherited from class adams.core.option.AbstractOptionHandler
cleanUpOptions, destroy, finishInit, getDefaultLoggingLevel, getOptionManager, initialize, loggingLevelTipText, newOptionManager, setLoggingLevel, toCommandLine, toString
-
Methods inherited from class adams.core.logging.LoggingObject
configureLogger, getLogger, getLoggingLevel, initializeLogging, isLoggingEnabled, sizeOf
-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface adams.core.CleanUpHandler
cleanUp
-
Methods inherited from interface adams.data.conversion.Conversion
convert, getInput, getInput, getOutput, getOutput, getOwner, setInput, setOwner
-
Methods inherited from interface adams.core.logging.LoggingLevelHandler
getLoggingLevel
-
Methods inherited from interface adams.core.QuickInfoSupporter
getQuickInfo
-
Methods inherited from interface adams.core.Stoppable
stopExecution
-
-
-
-
Field Detail
-
m_Validating
protected boolean m_Validating
whether the parser is validating or not.
-
m_NameSpaceAware
protected boolean m_NameSpaceAware
whether the parser is namespace aware.
-
m_XIncludeAware
protected boolean m_XIncludeAware
Set state of XInclude processing.
-
m_ExpandEntityReferences
protected boolean m_ExpandEntityReferences
Specifies that the parser produced by this code will expand entity reference nodes.
-
m_IgnoringComments
protected boolean m_IgnoringComments
Specifies that the parser produced by this code will ignore comments.
-
m_Coalescing
protected boolean m_Coalescing
Specifies that the parser produced by this code will convert CDATA nodes to Text nodes and append it to the adjacent (if any) text node.
-
m_IgnoringWhitespace
protected boolean m_IgnoringWhitespace
Specifies that the parsers created by this factory must eliminate whitespace in element content.
-
-
Method Detail
-
globalInfo
public String globalInfo()
Returns a string describing the object.- Specified by:
globalInfo
in interfaceGlobalInfoSupporter
- Specified by:
globalInfo
in classAbstractOptionHandler
- Returns:
- a description suitable for displaying in the gui
-
defineOptions
public void defineOptions()
Adds options to the internal list of options.- Specified by:
defineOptions
in interfaceOptionHandler
- Overrides:
defineOptions
in classAbstractOptionHandler
-
setValidating
public void setValidating(boolean value)
Sets whether to use a validating parser.- Parameters:
value
- true if to use validating parser
-
getValidating
public boolean getValidating()
Returns whether a validating parser is used.- Returns:
- true if validating parser
-
validatingTipText
public String validatingTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setNameSpaceAware
public void setNameSpaceAware(boolean value)
Sets whether to use a namespace aware parser.- Parameters:
value
- true if to use namespace aware parser
-
getNameSpaceAware
public boolean getNameSpaceAware()
Returns whether a namespace aware parser used.- Returns:
- true if namespace aware
-
nameSpaceAwareTipText
public String nameSpaceAwareTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setXIncludeAware
public void setXIncludeAware(boolean value)
Sets whether to use a X-include aware parser.- Parameters:
value
- true if to use X-include aware parser
-
getXIncludeAware
public boolean getXIncludeAware()
Returns whether a X-include aware parser is used.- Returns:
- true if X-include aware parser
-
XIncludeAwareTipText
public String XIncludeAwareTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setExpandEntityReferences
public void setExpandEntityReferences(boolean value)
Sets whether to expand entity references.- Parameters:
value
- true if to expand entity references
-
getExpandEntityReferences
public boolean getExpandEntityReferences()
Returns whether a parser expands entity references.- Returns:
- true if parser expands entity references
-
expandEntityReferencesTipText
public String expandEntityReferencesTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setIgnoringComments
public void setIgnoringComments(boolean value)
Sets whether to ignore comments.- Parameters:
value
- true if to ignore comments
-
getIgnoringComments
public boolean getIgnoringComments()
Returns whether parser ignores comments- Returns:
- true if comments ignored
-
ignoringCommentsTipText
public String ignoringCommentsTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setCoalescing
public void setCoalescing(boolean value)
Sets whether to use a coalescing parser.- Parameters:
value
- true if to use coalescing parser
-
getCoalescing
public boolean getCoalescing()
Returns whether a coalescing parser is used.- Returns:
- true if coalescing parser
-
coalescingTipText
public String coalescingTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
setIgnoringWhitespace
public void setIgnoringWhitespace(boolean value)
Sets whether to ignore whitespaces in element content.- Parameters:
value
- true if to ignore whitespaces in element content
-
getIgnoringWhitespace
public boolean getIgnoringWhitespace()
Returns whether parser ignores whitespaces in element content.- Returns:
- true if whitespaces in element content ignored
-
ignoringWhitespaceTipText
public String ignoringWhitespaceTipText()
Returns the tip text for this property.- Returns:
- tip text for this property suitable for displaying in the GUI or for listing the options.
-
generates
public Class generates()
Returns the class that is generated as output.- Specified by:
generates
in interfaceConversion
- Specified by:
generates
in classAbstractConversion
- Returns:
- the class
-
doConvert
protected Object doConvert() throws Exception
Performs the actual conversion.- Specified by:
doConvert
in classAbstractConversion
- Returns:
- the converted data
- Throws:
Exception
- if something goes wrong with the conversion
-
-