PBDOM_OBJECT, the base class for PBDOM objects that represent XML nodes, inherits from the PowerBuilder NonVisualObject class. PBDOM represents node types by the following classes:
You use methods from these classes to access objects in a PBDOM node tree.
The PBDOM_BUILDER class does not represent DOM nodes but can be used to build a PBDOM object tree from XML. It inherits from the PowerBuilder NonVisualObject class.
The PBDOM_EXCEPTION class inherits from the PowerBuilder Exception class and provides a method that obtains error codes.
Each of these classes and their methods are described in the chapters that follow.
Comparing PBDOM objects with W3C DOM and JDOM objects
The following table shows the W3C DOM and JDOM objects that correspond to each PBDOM object that represents a node in the DOM tree. Note that although these W3C DOM and JDOM objects correspond to PBDOM objects, they are not equivalent to the PBDOM objects.
PBDOM |
W3C DOM |
JDOM |
---|---|---|
PBDOM_ATTRIBUTE |
ATTRIBUTE_NODE |
Attribute |
PBDOM_BUILDER |
None |
DOMBuilder |
PBDOM_CDATA |
CDATA_SECTION_NODE |
CDATA |
PBDOM_CHARACTERDATA |
CHARACTER_DATA_NODE |
None |
PBDOM_COMMENT |
COMMENT_NODE |
Comment |
PBDOM_DOCUMENT |
DOCUMENT_NODE |
Document |
PBDOM_DOCTYPE |
DOCUMENT_TYPE_NODE |
DocType |
PBDOM_ELEMENT |
ELEMENT_NODE |
Element |
PBDOM_ENTITYREFERENCE |
ENTITY_REFERENCE_NODE |
EntityRef |
PBDOM_OBJECT |
NODE |
None |
PBDOM_PROCESSINGINSTURCTION |
PROCESSING_INSTRUCTION_NODE |
Processinginstruction |
PBDOM_TEXT |
TEXT_NODE |
Text |
The W3C DOM and JDOM object hierarchies also differ from the PBDOM object hierarchy, which is shown in the following illustration.
Figure: The PBDOM object hierarchy
For more information about working with PBDOM, see the chapter on PowerBuilder XML services in Application Techniques.