weka.core.xml
Class XMLDocument

java.lang.Object
  extended by weka.core.xml.XMLDocument
Direct Known Subclasses:
XMLInstances

public class XMLDocument
extends java.lang.Object

This class offers some methods for generating, reading and writing XML documents.
It can only handle UTF-8.

Version:
$Revision 1.0$
Author:
FracPete (fracpete at waikato dot ac dot nz)
See Also:
PI

Field Summary
static java.lang.String ATT_NAME
          the "name" attribute
static java.lang.String ATT_VERSION
          the "version" attribute
static java.lang.String DTD_ANY
          the ANY placeholder
static java.lang.String DTD_AT_LEAST_ONE
          the at least one marker
static java.lang.String DTD_ATTLIST
          the AttList definition
static java.lang.String DTD_CDATA
          the CDATA placeholder
static java.lang.String DTD_DOCTYPE
          the DocType definition
static java.lang.String DTD_ELEMENT
          the Element definition
static java.lang.String DTD_IMPLIED
          the #IMPLIED placeholder
static java.lang.String DTD_OPTIONAL
          the optional marker
static java.lang.String DTD_PCDATA
          the #PCDATA placeholder
static java.lang.String DTD_REQUIRED
          the #REQUIRED placeholder
static java.lang.String DTD_SEPARATOR
          the option separator
static java.lang.String DTD_ZERO_OR_MORE
          the zero or more marker
static java.lang.String PI
          the parsing instructions "<?xml version=\"1.0\" encoding=\"utf-8\"?>" (may not show up in Javadoc due to tags!)
static java.lang.String VAL_NO
          the value "no"
static java.lang.String VAL_YES
          the value "yes"
 
Constructor Summary
XMLDocument()
          initializes the factory with non-validating parser
XMLDocument(java.io.File file)
          Creates a new instance of XMLDocument
XMLDocument(java.io.InputStream stream)
          Creates a new instance of XMLDocument
XMLDocument(java.io.Reader reader)
          Creates a new instance of XMLDocument
XMLDocument(java.lang.String xml)
          Creates a new instance of XMLDocument
 
Method Summary
 void clear()
          sets up an empty DOM document, with the current DOCTYPE and root node
 javax.xml.parsers.DocumentBuilder getBuilder()
          returns the DocumentBuilder
static java.util.Vector getChildTags(org.w3c.dom.Node parent)
          returns all non tag-children from the given node
static java.util.Vector getChildTags(org.w3c.dom.Node parent, java.lang.String name)
          returns all non tag-children from the given node
static java.lang.String getContent(org.w3c.dom.Element node)
          returns the text between the opening and closing tag of a node (performs a trim() on the result)
 java.lang.String getDocType()
          returns the current DOCTYPE, can be null
 org.w3c.dom.Document getDocument()
          returns the parsed DOM document
 javax.xml.parsers.DocumentBuilderFactory getFactory()
          returns the DocumentBuilderFactory
 java.lang.String getRootNode()
          returns the current root node
 boolean getValidating()
          returns whether a validating parser is used
static void main(java.lang.String[] args)
          for testing only.
 org.w3c.dom.Document newDocument(java.lang.String docType, java.lang.String rootNode)
          creates a new Document with the given information
 void print()
          prints the current DOM document to standard out
 org.w3c.dom.Document read(java.io.File file)
          parses the given file and returns a DOM document
 org.w3c.dom.Document read(java.io.InputStream stream)
          parses the given stream and returns a DOM document
 org.w3c.dom.Document read(java.io.Reader reader)
          parses the given reader and returns a DOM document
 org.w3c.dom.Document read(java.lang.String xml)
          parses the given XML string (can be XML or a filename) and returns a DOM Document
 void setDocType(java.lang.String docType)
          sets the DOCTYPE-String to use in the XML output.
 void setDocument(org.w3c.dom.Document newDocument)
          sets the DOM document to use
 void setRootNode(java.lang.String rootNode)
          sets the root node to use in the XML output.
 void setValidating(boolean validating)
          sets whether to use a validating parser or not.
Note: this does clear the current DOM document!
 java.lang.String toString()
          returns the current DOM document as XML-string
 void write(java.io.File file)
          writes the current DOM document into the given file
 void write(java.io.OutputStream stream)
          writes the current DOM document into the given stream
 void write(java.lang.String file)
          writes the current DOM document into the given file
 void write(java.io.Writer writer)
          writes the current DOM document into the given writer
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

PI

public static final java.lang.String PI
the parsing instructions "<?xml version=\"1.0\" encoding=\"utf-8\"?>" (may not show up in Javadoc due to tags!)

See Also:
Constant Field Values

DTD_DOCTYPE

public static final java.lang.String DTD_DOCTYPE
the DocType definition

See Also:
Constant Field Values

DTD_ELEMENT

public static final java.lang.String DTD_ELEMENT
the Element definition

See Also:
Constant Field Values

DTD_ATTLIST

public static final java.lang.String DTD_ATTLIST
the AttList definition

See Also:
Constant Field Values

DTD_OPTIONAL

public static final java.lang.String DTD_OPTIONAL
the optional marker

See Also:
Constant Field Values

DTD_AT_LEAST_ONE

public static final java.lang.String DTD_AT_LEAST_ONE
the at least one marker

See Also:
Constant Field Values

DTD_ZERO_OR_MORE

public static final java.lang.String DTD_ZERO_OR_MORE
the zero or more marker

See Also:
Constant Field Values

DTD_SEPARATOR

public static final java.lang.String DTD_SEPARATOR
the option separator

See Also:
Constant Field Values

DTD_CDATA

public static final java.lang.String DTD_CDATA
the CDATA placeholder

See Also:
Constant Field Values

DTD_ANY

public static final java.lang.String DTD_ANY
the ANY placeholder

See Also:
Constant Field Values

DTD_PCDATA

public static final java.lang.String DTD_PCDATA
the #PCDATA placeholder

See Also:
Constant Field Values

DTD_IMPLIED

public static final java.lang.String DTD_IMPLIED
the #IMPLIED placeholder

See Also:
Constant Field Values

DTD_REQUIRED

public static final java.lang.String DTD_REQUIRED
the #REQUIRED placeholder

See Also:
Constant Field Values

ATT_VERSION

public static final java.lang.String ATT_VERSION
the "version" attribute

See Also:
Constant Field Values

ATT_NAME

public static final java.lang.String ATT_NAME
the "name" attribute

See Also:
Constant Field Values

VAL_YES

public static final java.lang.String VAL_YES
the value "yes"

See Also:
Constant Field Values

VAL_NO

public static final java.lang.String VAL_NO
the value "no"

See Also:
Constant Field Values
Constructor Detail

XMLDocument

public XMLDocument()
            throws java.lang.Exception
initializes the factory with non-validating parser

Throws:
java.lang.Exception - if the construction fails

XMLDocument

public XMLDocument(java.lang.String xml)
            throws java.lang.Exception
Creates a new instance of XMLDocument

Parameters:
xml - the xml to parse (if "Throws:
java.lang.Exception - if the construction of the DocumentBuilder fails
See Also:
setValidating(boolean)

XMLDocument

public XMLDocument(java.io.File file)
            throws java.lang.Exception
Creates a new instance of XMLDocument

Parameters:
file - the XML file to parse
Throws:
java.lang.Exception - if the construction of the DocumentBuilder fails
See Also:
setValidating(boolean)

XMLDocument

public XMLDocument(java.io.InputStream stream)
            throws java.lang.Exception
Creates a new instance of XMLDocument

Parameters:
stream - the XML stream to parse
Throws:
java.lang.Exception - if the construction of the DocumentBuilder fails
See Also:
setValidating(boolean)

XMLDocument

public XMLDocument(java.io.Reader reader)
            throws java.lang.Exception
Creates a new instance of XMLDocument

Parameters:
reader - the XML reader to parse
Throws:
java.lang.Exception - if the construction of the DocumentBuilder fails
See Also:
setValidating(boolean)
Method Detail

getFactory

public javax.xml.parsers.DocumentBuilderFactory getFactory()
returns the DocumentBuilderFactory

Returns:
the DocumentBuilderFactory

getBuilder

public javax.xml.parsers.DocumentBuilder getBuilder()
returns the DocumentBuilder

Returns:
the DocumentBuilder

getValidating

public boolean getValidating()
returns whether a validating parser is used

Returns:
whether a validating parser is used

setValidating

public void setValidating(boolean validating)
                   throws java.lang.Exception
sets whether to use a validating parser or not.
Note: this does clear the current DOM document!

Parameters:
validating - whether to use a validating parser
Throws:
java.lang.Exception - if the instantiating of the DocumentBuilder fails

getDocument

public org.w3c.dom.Document getDocument()
returns the parsed DOM document

Returns:
the parsed DOM document

setDocument

public void setDocument(org.w3c.dom.Document newDocument)
sets the DOM document to use

Parameters:
newDocument - the DOM document to use

setDocType

public void setDocType(java.lang.String docType)
sets the DOCTYPE-String to use in the XML output. Performs NO checking! if it is null the DOCTYPE is omitted.

Parameters:
docType - the DOCTYPE definition to use in XML output

getDocType

public java.lang.String getDocType()
returns the current DOCTYPE, can be null

Returns:
the current DOCTYPE definition, can be null

setRootNode

public void setRootNode(java.lang.String rootNode)
sets the root node to use in the XML output. Performs NO checking with DOCTYPE!

Parameters:
rootNode - the root node to use in the XML output

getRootNode

public java.lang.String getRootNode()
returns the current root node

Returns:
the current root node

clear

public void clear()
sets up an empty DOM document, with the current DOCTYPE and root node

See Also:
setRootNode(String), setDocType(String)

newDocument

public org.w3c.dom.Document newDocument(java.lang.String docType,
                                        java.lang.String rootNode)
creates a new Document with the given information

Parameters:
docType - the DOCTYPE definition (no checking happens!), can be null
rootNode - the name of the root node (must correspond to the one given in docType)
Returns:
returns the just created DOM document for convenience

read

public org.w3c.dom.Document read(java.lang.String xml)
                          throws java.lang.Exception
parses the given XML string (can be XML or a filename) and returns a DOM Document

Parameters:
xml - the xml to parse (if "Returns:
the parsed DOM document
Throws:
java.lang.Exception - if something goes wrong with the parsing

read

public org.w3c.dom.Document read(java.io.File file)
                          throws java.lang.Exception
parses the given file and returns a DOM document

Parameters:
file - the XML file to parse
Returns:
the parsed DOM document
Throws:
java.lang.Exception - if something goes wrong with the parsing

read

public org.w3c.dom.Document read(java.io.InputStream stream)
                          throws java.lang.Exception
parses the given stream and returns a DOM document

Parameters:
stream - the XML stream to parse
Returns:
the parsed DOM document
Throws:
java.lang.Exception - if something goes wrong with the parsing

read

public org.w3c.dom.Document read(java.io.Reader reader)
                          throws java.lang.Exception
parses the given reader and returns a DOM document

Parameters:
reader - the XML reader to parse
Returns:
the parsed DOM document
Throws:
java.lang.Exception - if something goes wrong with the parsing

write

public void write(java.lang.String file)
           throws java.lang.Exception
writes the current DOM document into the given file

Parameters:
file - the filename to write to
Throws:
java.lang.Exception - if something goes wrong with the parsing

write

public void write(java.io.File file)
           throws java.lang.Exception
writes the current DOM document into the given file

Parameters:
file - the filename to write to
Throws:
java.lang.Exception - if something goes wrong with the parsing

write

public void write(java.io.OutputStream stream)
           throws java.lang.Exception
writes the current DOM document into the given stream

Parameters:
stream - the filename to write to
Throws:
java.lang.Exception - if something goes wrong with the parsing

write

public void write(java.io.Writer writer)
           throws java.lang.Exception
writes the current DOM document into the given writer

Parameters:
writer - the filename to write to
Throws:
java.lang.Exception - if something goes wrong with the parsing

getChildTags

public static java.util.Vector getChildTags(org.w3c.dom.Node parent)
returns all non tag-children from the given node

Parameters:
parent - the node to get the children from
Returns:
a vector containing all the non-text children

getChildTags

public static java.util.Vector getChildTags(org.w3c.dom.Node parent,
                                            java.lang.String name)
returns all non tag-children from the given node

Parameters:
parent - the node to get the children from
name - the name of the tags to return, "" for all
Returns:
a vector containing all the non-text children

getContent

public static java.lang.String getContent(org.w3c.dom.Element node)
returns the text between the opening and closing tag of a node (performs a trim() on the result)

Parameters:
node - the node to get the text from
Returns:
the content of the given node

print

public void print()
prints the current DOM document to standard out


toString

public java.lang.String toString()
returns the current DOM document as XML-string

Overrides:
toString in class java.lang.Object
Returns:
the document as XML-string representation
Throws:
java.lang.Exception - if anything goes wrong initializing the parsing

main

public static void main(java.lang.String[] args)
                 throws java.lang.Exception
for testing only. takes the name of an XML file as first arg, reads that file, prints it to stdout and if a second filename is given, writes the parsed document to that again.

Throws:
java.lang.Exception