BEA WebLogic Integration documentation: Interface IDocument

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

WebLogic Integration

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.bea.document
Interface IDocument

All Known Implementing Classes:: com.bea.document.internal.Document

public interface IDocument
extends java.io.Serializable, java.lang.Cloneable

An IDocument represents an XML document. An IDocument can provide its document type name (which may be used to refer to a description of its structure and usage). In addition, IDocuments are mutable, and provide methods for retrieving, modifying, adding and removing data elements. All IDocument objects are queryable and updatable using XPath strings. Also, all IDocument instances are serializable to XML and unserializable from XML. IDocument objects should implement the java.io.Serializable interface.

An example of the usage of an IDocument follows. In this example, we are attempting to create an XML document that looks like this...

   <?xml version="1.0"?>
   <!DOCTYPE Person>     
   <Person name="Bob">      
     <Home squareFeet="2000"/>
     <Goal>My goal is to elliminate war and poverty</Goal>
     <Family>
       <Child name="Jimmy">
         <Stats sex="male" hair="brown" eyes="blue"/>
       </Child>
       <Child name="Susie">
         <Stats sex="female" hair="blonde" eyes="brown"/>
       </Child>
     </Family>
   </Person>

To construct this document, we would use the following code...

   // Create a blank IDocument (you will get xml header and DOCTYPE for free)
   IDocument person = DocumentFactory.createDocument();
   // Add <Person>
   person.addElement("", "Person");
   // Add <Person name="Bob">
   person.addAttribute("/Person", "name", "Bob");
   // Add <House/> under <Person>
   person.addElement("/Person", "House");
   // Add squareFeet="2000" to <House>
   person.addAttribute("/Person/House", "squareFeet", "2000");
   // Add <Goal>My goal is to elliminate war and poverty</Goal>
   // under <Person>
   person.addElement("/Person", "Goal", "My goal is to elliminate war and poverty");
   // Now add family
   person.addElement("/Person", "Family");
   // Add first child
   Element firstChild = person.addElement("/Person/Family", "Child");
   // Focus on first child
   person.setContextNode(firstChild);
   // Fill in statistics about first child. This add occurs relative to
   // the context node which we just set to firstChild.
   person.addElement("", "Stats");
   person.addAttribute("Stats", "sex", "male");
   person.addAttribute("Stats", "hair", "brown");
   person.addAttribute("Stats", "eyes", "blue");
   // Stop focusing on first child
   person.resetContextNode();
   // And second child
   Element secondChild = person.addElement("/Person/Family", "Child");
   // Focus on second child
   person.setContextNode(secondChild);
   // Fill in statistics about second child. This add occurs relative to
   // the context node which we just set to secondChild.
   person.addElement("", "Stats");
   person.addAttribute("Stats", "sex", "female");
   person.addAttribute("Stats", "hair", "blonde");
   person.addAttribute("Stats", "eyes", "brown");
   // Stop focusing on second child
   person.resetContextNode();

Note that if we already had the XML to represent this person, we could have used this code to create the IDocument...

   String personXML = ...get the XML from somewhere...
   IDocument person = DocumentFactory.createDocument(personXML);

To see the XML for this document, we use this code...

   System.out.println("The XML for person is: " + person.toXML());

To query the person's name and goal and number of kids, we use this code...

   System.out.println("The person's name: " + person.getStringFrom("/Person/@name");
   System.out.println("The person's goal: " + person.getStringFrom("/Person/Goal");
   System.out.println("Number of kids:    " + person.getIntegerFrom("count(/Person/Family/Child)");

To change the person's name and goal and second child's hair color, we use this code...

   person.setStringIn("/Person/@name", "BillyBob");
   person.setStringIn("/Person/Goal", "To ski 50 times this season");
   person.setStringIn("/Person/Family/Child[2]/@hair", "pink"); 
   System.out.println("The person's name: " + person.getStringFrom("/Person/@name");
   System.out.println("The person's goal: " + person.getStringFrom("/Person/Goal");
   System.out.println("Second childs hair:" + person.getStringFrom("/Person/Family/Child[2]/@hair");

To remove the person's goal, we use this code...

   person.removeDocumentData("/Person/Goal");

To get back the XML content from the document, we use this code...

   // Print the XML as a string
   System.out.println("Person XML: " + person.toXML());

   // Print the XML to a Writer (file)
   java.io.FileWriter fw = new java.io.FileWriter("myFile.xml");
   person.toXML(fw);

The default representation of the document represented by IDocument is a org.w3c.dom.Document (i.e. DOM). The IDocument may at times be in an unparsed state. This can happen if the IDocument was explicitly constructed this way (using DocumentFactory.createDocument(String, boolean) where the second arg is true. You can determine the internal state of an IDocument using the isParsed() method. If this returns true, then the content of the document has been parsed into a DOM, otherwise, the IDocument contains just the raw XML text.

In cases where an IDocument is in an unparsed state, you may want to parse the content using a SAX parsing scheme that allows you to build your own in-memory representation of the document (not DOM). The fromXML(ContentHandler) method is provided for this purpose, and allows you to parse the document's content manually using an implementation of the ContentHandler interface. Note that you could accomplish the same thing by getting the raw content from the IDocument, and creating/invoking your own SAX parser.

For more information see the W3C web site for XPath, XML, and DOM.

Author:: Copyright © 2000, 2001 BEA Systems, Inc. All Rights Reserved.
See Also:: XML Path Language (XPath), Extensible Markup Language (XML), Document Object Model (DOM), DocumentFactory, IDocumentDefinition

Method Summary
`org.w3c.dom.Attr`	`addAttribute(java.lang.String parentPath, java.lang.String attrName)` Add a new attribute to the parent data element referred to by parentPath.
`org.w3c.dom.Attr`	`addAttribute(java.lang.String parentPath, java.lang.String attrName, java.lang.String value)` Add a new attribute to the parent data element referred to by parentPath.
`void`	`addDocumentData(java.lang.String parentPath, DocumentData value)` Add the given value to the parent data element referred to by parentPath.
`org.w3c.dom.Element`	`addElement(java.lang.String parentPath, java.lang.String elementName)` Add a new element to the parent data element referred to by parentPath.
`org.w3c.dom.Element`	`addElement(java.lang.String parentPath, java.lang.String elementName, java.lang.String value)` Add a new element to the parent data element referred to by parentPath.
`void`	`addNode(java.lang.String parentPath, org.w3c.dom.Node node)` Add a new node to the parent data element referred to by parentPath.
`java.lang.Object`	`clone()` Clone this document.
`void`	`forceParsed()` Force this document into the parsed state by using a DOM parser with the document's internal content.
`void`	`fromXML(org.xml.sax.ContentHandler contentHandler)` Parse the (unparsed) internal content of this document using a SAX parser and the given ContentHandler.
`void`	`fromXML(java.io.File file)` Retrieves an XML document previously saved to a file.
`void`	`fromXML(java.io.File file, java.lang.String encoding)` Retrieves an XML document previously saved to a file.
`void`	`fromXML(org.xml.sax.InputSource inputSource)` Use the given SAX InputSource to import XML into this document (thus replacing any previous data elements in this document).
`void`	`fromXML(java.io.Reader reader)` Given an XML stream read from reader, import this representation into this document (thus replacing any previous data elements in this document).
`void`	`fromXML(java.lang.String xmlText)` Given an XML string, import this representation into this document (thus replacing any previous data elements in this document).
`boolean`	`getBooleanFrom(java.lang.String nodeName)` Return a boolean representing the given xpath.
`boolean`	`getBooleanFromFirst(java.lang.String nodeName)` Return a boolean representing the value of the first element found with the given name.
`java.util.Calendar`	`getDateFrom(java.lang.String nodeName)` Return a Calendar representing the value of the given xpath.
`java.util.Calendar`	`getDateFromFirst(java.lang.String nodeName)` Return a Calendar representing the value of the first element found with the given name.
`java.util.Calendar`	`getDateTimeFrom(java.lang.String nodeName)` Return a Calendar representing the value of the given xpath.
`java.util.Calendar`	`getDateTimeFromFirst(java.lang.String nodeName)` Return a Calendar representing the value of the first element found with the given name.
`org.w3c.dom.Document`	`getDocument()` Get the org.w3c.Document contained in this document.
`DocumentData`	`getDocumentData(java.lang.String path)` Return an object which encapsulates the data that corresponds to the given path (XPath syntax).
`IDocumentDefinition`	`getDocumentDefinition()` Get the IDocumentDefinition for this document which describes the structure and usage of this type of document.
`org.w3c.dom.Element`	`getDocumentElement()` Get the element that acts as the document root element for this document.
`java.lang.String`	`getDocumentTypeName()` Get the document type name for this document.
`double`	`getDoubleFrom(java.lang.String nodeName)` Return a double representing the value of the given xpath.
`double`	`getDoubleFromFirst(java.lang.String nodeName)` Return a double representing the value of the first element found with the given name.
`java.lang.String`	`getEncoding()` Returns the Java encoding value for this document.
`org.xml.sax.EntityResolver`	`getEntityResolver()` Get the EntityResolver used when unserializing.
`int`	`getIntegerFrom(java.lang.String nodeName)` Return an int representing the value of the given xpath.
`int`	`getIntegerFromFirst(java.lang.String nodeName)` Return an int representing the value of the first element found with the given name.
`java.lang.String`	`getPublicID()` Get the public id for this document.
`java.lang.String`	`getRawXML()` Get the raw XML for this document.
`java.lang.String`	`getRootElementName()` Get the root element tag name for this document.
`java.lang.String`	`getStringFrom(java.lang.String nodeName)` Return a string representing the value of the nodes found with the given xpath.
`java.lang.String`	`getStringFromFirst(java.lang.String nodeName)` Return a string representing the value of the first element found with the given name.
`IDocument[]`	`getSubDocuments(java.lang.String path)` Get an array of sub-documents representing the nodes that are referred to by the path argument.
`java.lang.String`	`getSystemID()` Get the system id for this document.
`java.util.Calendar`	`getTimeFrom(java.lang.String nodeName)` Return a Calendar representing the value of the given xpath.
`java.util.Calendar`	`getTimeFromFirst(java.lang.String nodeName)` Return a Calendar representing the value of the first element found with the given name.
`boolean`	`getValidating()` Is this IDocument validating content in calls to fromXML()?
`boolean`	`isParsed()` Is this document's XML parsed? If so, the getDocument() method may be used to retrieve the document's parsed XML as a DOM.
`void`	`removeDocumentData(java.lang.String path)` Remove the data element referred to by path.
`void`	`resetContextNode()` Resets the context node to the document root element.
`void`	`setBooleanIn(java.lang.String nodeName, boolean newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setBooleanInFirst(java.lang.String nodeName, boolean newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setContextNode(DocumentData data)` Sets the context node for use in all queries to data.
`void`	`setContextNode(org.w3c.dom.Node node)` Sets the context node for use in all queries to node. From this point on, until resetContextNode() is called, all calls to getDocumentData (direct or indirect) will be relative to the new context node.
`void`	`setContextNode(java.lang.String path)` Sets the context node for use in all queries to path.
`void`	`setDateIn(java.lang.String nodeName, java.util.Calendar newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setDateInFirst(java.lang.String nodeName, java.util.Calendar newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setDateTimeIn(java.lang.String nodeName, java.util.Calendar newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setDateTimeInFirst(java.lang.String nodeName, java.util.Calendar newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setDocumentData(java.lang.String path, DocumentData value)` Set the data element referred to by path to be value.
`void`	`setDocumentDefinition(IDocumentDefinition docDef)` Set the IDocumentDefinition for this document.
`void`	`setDocumentElement(org.w3c.dom.Element documentElement)` Set the element that will act as the document root element for this document.
`void`	`setDocumentTypeName(java.lang.String typeName)` Set the document type name for this document.
`void`	`setDoubleIn(java.lang.String nodeName, double newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setDoubleInFirst(java.lang.String nodeName, double newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setEntityResolver(org.xml.sax.EntityResolver entityResolver)` Set the EntityResolver to use when unserializing.
`void`	`setIntegerIn(java.lang.String nodeName, int newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setIntegerInFirst(java.lang.String nodeName, int newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setPublicID(java.lang.String id)` Get the system id for this document.
`void`	`setStringIn(java.lang.String nodeName, java.lang.String newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setStringInFirst(java.lang.String nodeName, java.lang.String newValue)` Set the first data element found with the given name to the string given by newValue.
`void`	`setSystemID(java.lang.String id)` Set the system id for this document.
`void`	`setTimeIn(java.lang.String nodeName, java.util.Calendar newValue)` Set the node value of all data nodes found for the given xpath to the string representation of the given newValue.
`void`	`setTimeInFirst(java.lang.String nodeName, java.util.Calendar newValue)` Set the first data element found with the given name to the string representation of the given newValue.
`void`	`setValidating(boolean validating)` Set this IDocument to validate/not-validate during calls to fromXML.
`java.lang.String`	`toXML()` Get the XML represented by this document as a String.
`void`	`toXML(java.io.Writer writer)` Get the XML represented by this document, and write it to the given Writer.
`void`	`toXML(java.io.Writer writer, int indentSize, java.lang.String encoding)` Get the XML represented by this document, and write it to the given Writer, using the given indent size and character encoding.

Method Detail

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Clone this document. This is a 'deep' clone, and the returned object is independent and unrelated to the original document.

Overrides:: clone in class java.lang.Object

getRootElementName

public java.lang.String getRootElementName()

Get the root element tag name for this document. If the root element has not yet been established, the root element name is 'Unknown'.

isParsed

public boolean isParsed()

Is this document's XML parsed? If so, the getDocument() method may be used to retrieve the document's parsed XML as a DOM. If not, the getRawXML() method may be used to retrieve the unparsed XML.

forceParsed

public void forceParsed()
                 throws DocumentParseException,
                        DocumentException

Force this document into the parsed state by using a DOM parser with the document's internal content. This method is only valid when the isParsed() method returns false. Otherwise, this method is a no-op.

getDocument

public org.w3c.dom.Document getDocument()

Get the org.w3c.Document contained in this document. This method only returns non-null if this document is in the 'parsed' state (as determined by the isParsed() method). If not, this method returns null, and the user must use the 'getRawXML()' method to retrieve the content for the document. The user can call the fromXML() method using the raw XML if they require immediate access to the parsed (DOM) content, and then use the getDocument() method.

getRawXML

public java.lang.String getRawXML()

Get the raw XML for this document. This method is not the same as toXML(), as it only returns the raw XML if the isParsed() method returns false. The toXML() method, by contrast, generates a new XML representation from the contents of the document.

getDocumentElement

public org.w3c.dom.Element getDocumentElement()

Get the element that acts as the document root element for this document.

getSystemID

public java.lang.String getSystemID()

Get the system id for this document.

setSystemID

public void setSystemID(java.lang.String id)

Set the system id for this document.

getPublicID

public java.lang.String getPublicID()

Get the public id for this document.

setPublicID

public void setPublicID(java.lang.String id)

Get the system id for this document.

getEntityResolver

public org.xml.sax.EntityResolver getEntityResolver()

Get the EntityResolver used when unserializing.

setDocumentElement

public void setDocumentElement(org.w3c.dom.Element documentElement)

Set the element that will act as the document root element for this document.

setEntityResolver

public void setEntityResolver(org.xml.sax.EntityResolver entityResolver)

Set the EntityResolver to use when unserializing.

getDocumentDefinition

public IDocumentDefinition getDocumentDefinition()

Get the IDocumentDefinition for this document which describes the structure and usage of this type of document.

setDocumentDefinition

public void setDocumentDefinition(IDocumentDefinition docDef)

Set the IDocumentDefinition for this document.

getDocumentTypeName

public java.lang.String getDocumentTypeName()

Get the document type name for this document. The document type name refers to a named IDocumentDefinition. This class does not define how you would retrieve or store IDocumentDefinitions.

setDocumentTypeName

public void setDocumentTypeName(java.lang.String typeName)

Set the document type name for this document. The document type refers to a named IDocumentDefinition. This class does not define how you would retrieve or store IDocumentDefinitions.

getEncoding

public java.lang.String getEncoding()

Returns the Java encoding value for this document. The encoding type (if found) is converted to Java encoding from Mime encoding if a translation is necessary. For example, if the document contains an encoding value of "UTF-8" this method would return "UTF8". If no encoding is specified for this document, this method returns null.

setContextNode

public void setContextNode(java.lang.String path)
                    throws DocumentException

Sets the context node for use in all queries to path. This path must refer to a node set. If the path refers to a node set of more than one node, the context node is set to the first node in the node set.
From this point on, until resetContextNode() is called, all calls to getDocumentData (direct or indirect) will be relative to the new context node. This can be very useful if adding large numbers of elements to the same parent, or if adding elements to a very deeply nested parent, or adding elements to a parent in a very large document.

setContextNode

public void setContextNode(DocumentData data)
                    throws DocumentException

Sets the context node for use in all queries to data. This data must be a node set. If the node set contains more than one node, the context node is set to the first node in the node set.
From this point on, until resetContextNode() is called, all calls to getDocumentData (direct or indirect) will be relative to the new context node. This can be very useful if adding large numbers of elements to the same parent, or if adding elements to a very deeply nested parent, or adding elements to a parent in a very large document.

See Also:: setContextNode(String)

setContextNode

public void setContextNode(org.w3c.dom.Node node)

Sets the context node for use in all queries to node.
From this point on, until resetContextNode() is called, all calls to getDocumentData (direct or indirect) will be relative to the new context node. This can be very useful if adding large numbers of elements to the same parent, or if adding elements to a very deeply nested parent, or adding elements to a parent in a very large document.

See Also:: setContextNode(DocumentData)

resetContextNode

public void resetContextNode()

Resets the context node to the document root element. All calls to getDocumentData (direct or indirect) will be relative to the document root element.

See Also:: setContextNode(Node)

getStringFromFirst

public java.lang.String getStringFromFirst(java.lang.String nodeName)
                                    throws DocumentException

Return a string representing the value of the first element found with the given name. If nodeName does not start with a '/', the characters '//' are prepended to nodeName. If nodeName does not end with ']', the characters '[1]' are appended to nodeName. This method never returns null, even if no data is found corresponding to the XPath in nodeName. In this case, an empty String is returned.
If it is necessary to determine if the data was found in the document, use the getDocumentData method instead.

See Also:: getDocumentData(String)

getIntegerFromFirst

public int getIntegerFromFirst(java.lang.String nodeName)
                        throws DocumentException

Return an int representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as an Integer. If the resultant string value is not a valid integer value (including empty string), a DocumentException will result.

See Also:: getStringFromFirst(String), getDocumentData(String)

getBooleanFromFirst

public boolean getBooleanFromFirst(java.lang.String nodeName)
                            throws DocumentException

Return a boolean representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as a Boolean. If the resultant string value is 'true' or 'yes' (ignoring case), then true is returned. Otherwise, false is returned.
If it is necessary to determine if the data was found in the document, use the getDocumentData method instead.

See Also:: getStringFromFirst(String), getDocumentData(String)

getDoubleFromFirst

public double getDoubleFromFirst(java.lang.String nodeName)
                          throws DocumentException

Return a double representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as a Double. If the resultant string value is not a valid double value (including empty string), a DocumentException will result.

See Also:: getStringFromFirst(String), getDocumentData(String)

getDateFromFirst

public java.util.Calendar getDateFromFirst(java.lang.String nodeName)
                                    throws DocumentException

Return a Calendar representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as a date (i.e. an element with XML schema datatype 'date'). If the resultant string value is not a valid date value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getDateTimeFromFirst

public java.util.Calendar getDateTimeFromFirst(java.lang.String nodeName)
                                        throws DocumentException

Return a Calendar representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as a dateTime (i.e. an element with XML schema datatype 'dateTime'). If the resultant string value is not a valid dateTime value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getTimeFromFirst

public java.util.Calendar getTimeFromFirst(java.lang.String nodeName)
                                    throws DocumentException

Return a Calendar representing the value of the first element found with the given name. This method is a convenience method that simply calls getStringFromFirst, and interprets the result as a time (i.e. an element with XML schema datatype 'time'). If the resultant string value is not a valid time value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getValidating

public boolean getValidating()

Is this IDocument validating content in calls to fromXML()?

getStringFrom

public java.lang.String getStringFrom(java.lang.String nodeName)
                               throws DocumentException

Return a string representing the value of the nodes found with the given xpath. This method never returns null, even if no data is found corresponding to the XPath in nodeName. In this case, an empty String is returned.
If it is necessary to determine if the data was found in the document, use the getDocumentData method instead.

See Also:: getDocumentData(String)

getIntegerFrom

public int getIntegerFrom(java.lang.String nodeName)
                   throws DocumentException

Return an int representing the value of the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as an Integer. If the resultant string value is not a valid integer value (including empty string), a DocumentException will result.

See Also:: getStringFrom(String), getDocumentData(String)

getBooleanFrom

public boolean getBooleanFrom(java.lang.String nodeName)
                       throws DocumentException

Return a boolean representing the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as a Boolean. If the resultant string value is 'true' or 'yes' (ignoring case), then true is returned. Otherwise, false is returned.
If it is necessary to determine if the data was found in the document, use the getDocumentData method instead.

See Also:: getStringFrom(String), getDocumentData(String)

getDoubleFrom

public double getDoubleFrom(java.lang.String nodeName)
                     throws DocumentException

Return a double representing the value of the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as a Double. If the resultant string value is not a valid double value (including empty string), a DocumentException will result.

See Also:: getStringFrom(String), getDocumentData(String)

getDateFrom

public java.util.Calendar getDateFrom(java.lang.String nodeName)
                               throws DocumentException

Return a Calendar representing the value of the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as a date (i.e. an element with XML schema datatype 'date'). If the resultant string value is not a valid date value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getDateTimeFrom

public java.util.Calendar getDateTimeFrom(java.lang.String nodeName)
                                   throws DocumentException

Return a Calendar representing the value of the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as a dateTime (i.e. an element with XML schema datatype 'dateTime'). If the resultant string value is not a valid dateTime value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getTimeFrom

public java.util.Calendar getTimeFrom(java.lang.String nodeName)
                               throws DocumentException

Return a Calendar representing the value of the given xpath. This method is a convenience method that simply calls getStringFrom, and interprets the result as a time (i.e. an element with XML schema datatype 'time'). If the resultant string value is not a valid time value (including empty string), a DocumentException will result.

Returns:: a java.util.Calendar; a Calendar is provided because it provides better control over date functionality than a java.util.Date object. If the node does not exist, then null is returned.
See Also:: getStringFromFirst(String), getDocumentData(String)

getSubDocuments

public IDocument[] getSubDocuments(java.lang.String path)
                            throws DocumentException

Get an array of sub-documents representing the nodes that are referred to by the path argument.

getDocumentData

public DocumentData getDocumentData(java.lang.String path)
                             throws DocumentException

Return an object which encapsulates the data that corresponds to the given path (XPath syntax). This object is NEVER null and has a type of either: MESSAGE_DATA_TYPE_XXX where XXX is:

BOOLEAN - call bool DocumentData.toBool()
NODESET - call org.w3c.NodeList DocumentData.toNodeSet()
NULL - null result
NUMBER - call double DocumentData.toNumber()
RTREEFRAG - call org.w3c.dom.DocumentFragment DocumentData.toRtree()
STRING - call String DocumentData.toStr()
UNKNOWN - unknown result

setStringInFirst

public void setStringInFirst(java.lang.String nodeName,
                             java.lang.String newValue)
                      throws DocumentException

Set the first data element found with the given name to the string given by newValue.

setIntegerInFirst

public void setIntegerInFirst(java.lang.String nodeName,
                              int newValue)
                       throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setBooleanInFirst

public void setBooleanInFirst(java.lang.String nodeName,
                              boolean newValue)
                       throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setDoubleInFirst

public void setDoubleInFirst(java.lang.String nodeName,
                             double newValue)
                      throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setDateInFirst

public void setDateInFirst(java.lang.String nodeName,
                           java.util.Calendar newValue)
                    throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setDateTimeInFirst

public void setDateTimeInFirst(java.lang.String nodeName,
                               java.util.Calendar newValue)
                        throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setTimeInFirst

public void setTimeInFirst(java.lang.String nodeName,
                           java.util.Calendar newValue)
                    throws DocumentException

Set the first data element found with the given name to the string representation of the given newValue.

setValidating

public void setValidating(boolean validating)

Set this IDocument to validate/not-validate during calls to fromXML.