Class: Document (in XML)

• Inheritance
• Description
• Class protocol
  • instance creation
• Instance protocol
  • IDs
  • accessing
  • comparing
  • copying
  • enumerating
  • flags
  • initialization
  • printing
  • private helpers
  • testing
  • visiting

Inheritance:

   Object
   |
   +--XML::Node
      |
      +--XML::Document
         |
         +--XML::DocumentFragment

Package:

stx:goodies/xml/vw

Category:

XML-VW-Nodes

Version:

rev: 1.19 date: 2018/02/15 13:55:34

user: cg

file: Document.st directory: goodies/xml/vw

module: stx stc-classLibrary: vw

Description:

This class represents an XML document entity and serves as the root of the document entity tree. Each XML document has one entity (root) called the document entity, which serves as the starting point for the XML processor and may contain the whole document (nodes collection). 

According to the XML 1.0 specification, XML documents may and should begin with an XML declaration which specifies the version of XML (xmlVersion instance variable) being used. 

The XML document type declaration which must appear before the first element in a document contains or points to markup declarations that provide the grammar for this document. This grammar is known as document type definition (dtd instance variable). An XML document is valid if it has an associated document type declaration and if the document complies with the constraints expressed in it. If the document type declaration is not present, the document can be at most well formed.

Instance Variables:
	root    <XML.Node>  
	nodes   <Collection>  
	xmlVersion      <String>  
		Version of the XML specification to which the document is conformant
	dtd     <XML.DocumentType>
		Associated document type definition 
	ids     <Dictionary>  

Class protocol:

 new

Instance protocol:

 atID: key ifAbsent: aBlock

 registerID: attribute from: aParser

 updateIDs

 / elementName

XPath like access to the root element

 // elementName

XPath like access to all subelements named elementName

 addNamespaceDefinitions

 addNode: aNode

 document

 dtd

 dtd: aDTD

 elements

 pathName

 root

 selectNodes: aBlock

 xmlVersion

 xmlVersion: aString

 = anXmlDocument

 hash

 cloneTree

answer a copy of the tree, so that removal of child elements
from the copy does not affect the original node.

 nodesDo: aBlock

 nodesReverseDo: aBlock

 treePosition

answer a SequencableCollection which holds the position of the node
in the document tree

 hasDTD

 hasExternalDTD

 noteDTD

 noteExternalDTD

 notePEReference

 usesParameterEntities

 initialize

 prettyPrintOn: aStream

 printCanonicalOn: aStream

no version header in canonical XML;

 printHTMLOn: aStream

 printHeaderOn: aStream

 printNoIndentOn: aStream endSpacing: endSpacingBlock spacing: spacingBlock

 printOn: aStream

 treePositionOf: aNode

return a collection containing the position of the node in the document

 hasSubNodes

 isContent

 isDocument

 verifyContents

 acceptVisitor: aVisitor

Double dispatch back to the visitor, passing my type encoded in
the selector (visitor pattern)