On Tue, 2002-02-19 at 22:38, Tinny Ng wrote: > Re: Proposal: C++ Language Binding for DOM Level 2 - in term of IDOMI also heard >other similar complaints about the name "IDOM". > > I've no idea why it was named "IDOM", my binding proposal just inherits whatever >already implemented there .....
Can you at least tell us what IDOM is? How is it different/better than the old DOM stuff? > If we are going to give it a new name, then it means all existing IDOM files (e.g. >IDOM_Node.hpp) and IDOM classes (e.g. class IDOM_Node) will be renamed accordingly. >Then all existing IDOM users need to do such global rename migration after the >binding proposal is approved by the mailing list. > > Since the IDOM was still in "experimental" state in Xerces-C++ 1.6.0 and thus >considerable API changes should be expected, may be such "global rename migration" is >acceptable to IDOM users?? > > If most existing IDOM users vote for the rename, then we can pick a more reasonable >name. Maybe it's also time to review the C++ namespaces issue. At this time are there still significant numbers of people using old compilers that don't support C++ namespaces, with no upgrade path? > How about prefix it with "DOM" (not "DOM_" as in the old DOM)? For example > > DOMDocument > DOMElement > DOMNode > DOMAttribute > DOMRange > ... > etc. > ?? > > Tinny > ----- Original Message ----- > From: James Berry > To: Xerces C Dev > Sent: Sunday, February 17, 2002 1:33 PM > Subject: Re: Proposal: C++ Language Binding for DOM Level 2 - in term ofIDOM > > > Hi Tinny, > > The purest in me is somewhat concerned with regard to whether the name "IDOM" is >appropriate for something that might be on the way to becoming a standard DOM binding >for C++. (I guess, also, that I don't know what the "I" in "IDOM" stands for... ;) > > Is the existing "DOM" interface recognized as an official binding in any way for >C++? > > If the Xerces "DOM" interface goes away, or becomes deprecated, which it seems >destined to, it would seem logical for the "IDOM" interface to become named "DOM" >instead, rather than the randomly named (???) IDOM. > > Maybe my concerns will be cleared up if someone convinces me that there's a valid >naming convention behind "IDOM". Is that "interface"? "interim"? "investigatory"? >"improved"? What about "CppDOM", "StdDOM". > > Comments? > > -jdb > > On 2/15/02 8:31 AM, "Tinny Ng" <[EMAIL PROTECTED]> wrote: > > > Hi, > > W3C DOM Recommendation has only defined JAVA and ECMAScript language bindings. >For all other languages, W3C has links to binding owners' web sites in >http://www.w3.org/DOM/Bindings. > > In order to populate Xerces-C++ IDOM as a formal C++ language binding to more >open source users, I would like to post the attached document to Apache Xerces-C++ >web site, and then send the URL to http://www.w3.org/DOM/Bindings. > > The proposed document is almost the same as our existing IDOM interfaces, with >the following exceptions: > 1. Introduce the type "IDOMSize_t" which is an implementation-dependent >unsigned integral type. And use it in interfaces like: > IDOM_Node* IDOM_NodeList::item(IDOMSize_t index) = 0; > IDOMSize_t IDOM_NodeList::getLength() = 0; > > 2. Added abstract classes IDOM_DocumentTraversal and IDOM_DocumentRange, and >derived IDOM_Document from these two abstract classes in addition to IDOM_Node in the >implementation. These two interfaces were not there in existing IDOM and this is to >fix such deviation. > > Please review and let me know any comment. I hope to have this in place >together with Xerces-C++ 1.7 announcement. Thanks! > > > Regards, > > Tinny Ng > XML Parsers Development > IBM Toronto Laboratory, email: [EMAIL PROTECTED] > > > > ---------------------------------------------------------------------------- > C++ Language Binding for DOM Level 2 > This document contains the complete C++ Language binding for the Level 2 >Document Object Model Core, and for the Level 2 Document Object Model Traversal and >Range. The definitions are divided into Core <#A: Document Object Mode: Core> , >Traversal <#B: Document Object Model: Traversal> , and Range <#C: Document Object >Model: Range> . > > The headers are also available in Apache Xerces-C++ IDOM distribution: >http://cvs.apache.org/viewcvs.cgi/xml-xerces/c/src/idom/ ><http://cvs.apache.org/viewcvs.cgi/xml-xerces/c/src/idom> > > Note: > > 1.. Constructor and Destructors are implementation specific > 2.. String is represented by "XMLCh*" which is a pointerto unsigned 16 bit >type holding utf-16 values, null terminated. > > 1.. typedef unsigned int XMLCh > > 3.. IDOMSize_t is an implementation-dependent unsignedintegral type > > 1.. typedef unsigned long IDOMSize_t > > > ---------------------------------------------------------------------------- > A: Document Object Mode: Core <#C++ Language Binding for DOM Level 2> > IDOM_DOMException.hpp: > class IDOM_DOMException > { > public: > // ExceptionCode > enum ExceptionCode { > INDEX_SIZE_ERR = 1, > DOMSTRING_SIZE_ERR = 2, > HIERARCHY_REQUEST_ERR = 3, > WRONG_DOCUMENT_ERR = 4, > INVALID_CHARACTER_ERR = 5, > NO_DATA_ALLOWED_ERR = 6, > NO_MODIFICATION_ALLOWED_ERR = 7, > NOT_FOUND_ERR = 8, > NOT_SUPPORTED_ERR = 9, > INUSE_ATTRIBUTE_ERR = 10, > INVALID_STATE_ERR = 11, > SYNTAX_ERR = 12, > INVALID_MODIFICATION_ERR = 13, > NAMESPACE_ERR = 14, > INVALID_ACCESS_ERR = 15 > }; > const XMLCh* msg; > ExceptionCode code; > }; > IDOM_DOMImplementation.hpp: > class IDOM_DOMImplementation > { > public: > virtual bool hasFeature(const XMLCh* feature, > const XMLCh* version) = 0; > virtual IDOM_DocumentType* createDocumentType(const XMLCh* qualifiedName, > const XMLCh* publicId, > const XMLCh* systemId) = 0; > virtual IDOM_Document* createDocument(const XMLCh* namespaceURI, > const XMLCh* qualifiedName, > IDOM_DocumentType* doctype) = 0; > }; > IDOM_DocumentFragment.hpp: > class IDOM_DocumentFragment : IDOM_Node > { > }; > IDOM_Document.hpp: > class IDOM_Document : IDOM_Node > { > public: > virtual IDOM_DocumentType* getDoctype() const = 0; > virtual IDOM_DOMImplementation* getImplementation() const = 0; > virtual IDOM_Element* getDocumentElement() const = 0; > virtual IDOM_Element* createElement(const XMLCh* tagName) = 0; > virtual IDOM_DocumentFragment* createDocumentFragment() = 0; > virtual IDOM_Text* createTextNode(const XMLCh* data) = 0; > virtual IDOM_Comment* createComment(const XMLCh* data) = 0; > virtual IDOM_CDATASection* createCDATASection(const XMLCh* data) = 0; > virtual IDOM_ProcessingInstruction* createProcessingInstruction(const XMLCh* >target, > const XMLCh* >data) = 0; > virtual IDOM_Attr* createAttribute(const XMLCh* name) = 0; > virtual IDOM_EntityReference* createEntityReference(const XMLCh* name) = 0; > virtual IDOM_NodeList* getElementsByTagName(const XMLCh* tagname) >const = 0; > virtual IDOM_Node* importNode(IDOM_Node* importedNode, bool deep) >= 0; > virtual IDOM_Element* createElementNS(const XMLCh* namespaceURI, > const XMLCh* qualifiedName) = >0; > virtual IDOM_Attr* createAttributeNS(const XMLCh* namespaceURI, > const XMLCh* qualifiedName) >= 0; > virtual IDOM_NodeList* getElementsByTagNameNS(const XMLCh* >namespaceURI, > const XMLCh* >localName) const = 0; > virtual IDOM_Element* getElementById(const XMLCh* elementId) const = >0; > }; > IDOM_Node.hpp: > class IDOM_Node > { > public: > // NodeType > enum NodeType { > ELEMENT_NODE = 1, > ATTRIBUTE_NODE = 2, > TEXT_NODE = 3, > CDATA_SECTION_NODE = 4, > ENTITY_REFERENCE_NODE = 5, > ENTITY_NODE = 6, > PROCESSING_INSTRUCTION_NODE = 7, > COMMENT_NODE = 8, > DOCUMENT_NODE = 9, > DOCUMENT_TYPE_NODE = 10, > DOCUMENT_FRAGMENT_NODE = 11, > NOTATION_NODE = 12 > }; > virtual const XMLCh* getNodeName() const = 0; > virtual const XMLCh* getNodeValue() const = 0; > virtual void setNodeValue(const XMLCh* nodeValue) = 0; > virtual short getNodeType() const = 0; > virtual IDOM_Node* getParentNode() const = 0; > virtual IDOM_NodeList* getChildNodes() const = 0; > virtual IDOM_Node* getFirstChild() const = 0; > virtual IDOM_Node* getLastChild() const = 0; > virtual IDOM_Node* getPreviousSibling() const = 0; > virtual IDOM_Node* getNextSibling() const = 0; > virtual IDOM_NamedNodeMap* getAttributes() const = 0; > virtual IDOM_Document* getOwnerDocument() const = 0; > virtual IDOM_Node* insertBefore(IDOM_Node* newChild, > IDOM_Node* refChild) = 0; > virtual IDOM_Node* replaceChild(IDOM_Node* newChild, > IDOM_Node* oldChild) = 0; > virtual IDOM_Node* removeChild(IDOM_Node* oldChild) = 0; > virtual IDOM_Node* appendChild(IDOM_Node* newChild) = 0; > virtual bool hasChildNodes() const = 0; > virtual IDOM_Node* cloneNode(bool deep) const = 0; > virtual void normalize() = 0; > virtual bool isSupported(const XMLCh* feature, > const XMLCh* version) const = 0; > virtual const XMLCh* getNamespaceURI() const = 0; > virtual const XMLCh* getPrefix() const = 0; > virtual void setPrefix(const XMLCh* prefix) = 0; > virtual const XMLCh* getLocalName() const = 0; > virtual bool hasAttributes() const = 0; > > }; > IDOM_NodeList.hpp: > class IDOM_NodeList > { > public: > virtual IDOM_Node* item(IDOMSize_t index) = 0; > virtual IDOMSize_t getLength() = 0; > }; > IDOM_NamedNodeMap.hpp: > class IDOM_NamedNodeMap > { > public: > virtual IDOM_Node* getNamedItem(const XMLCh* name) const = 0; > virtual IDOM_Node* setNamedItem(IDOM_Node* arg) = 0; > virtual IDOM_Node* removeNamedItem(const XMLCh* name) = 0; > virtual IDOM_Node* item(IDOMSize_t index) const = 0; > virtual IDOMSize_t getLength() const = 0; > virtual IDOM_Node* getNamedItemNS(const XMLCh* namespaceURI, > const XMLCh* localName) const = 0; > virtual IDOM_Node* setNamedItemNS(IDOM_Node* arg) = 0; > virtual IDOM_Node* removeNamedItemNS(const XMLCh* namespaceURI, > const XMLCh* localName) = 0; > }; > IDOM_CharacterData.hpp: > class IDOM_CharacterData : IDOM_Node > { > public: > virtual const XMLCh* getData() const = 0; > virtual void setData(const XMLCh* data) = 0; > virtual IDOMSize_t getLength() const = 0; > virtual const XMLCh* substringData(IDOMSize_t offset, > IDOMSize_t count) const = 0; > virtual void appendData(const XMLCh* arg) = 0; > virtual void insertData(IDOMSize_t offset, > const XMLCh* arg) = 0; > virtual void deleteData(IDOMSize_t offset, > IDOMSize_t count) = 0; > virtual void replaceData(IDOMSize_t offset, > IDOMSize_t count, > const XMLCh* arg) = 0; > }; > IDOM_Attr.hpp: > class IDOM_Attr : IDOM_Node > { > public: > virtual const XMLCh* getName() const = 0; > virtual bool getSpecified() const = 0; > virtual const XMLCh* getValue() const = 0; > virtual void setValue(const XMLCh* value) = 0; > virtual IDOM_Element* getOwnerElement() const = 0; > }; > IDOM_Element.hpp: > class IDOM_Element: IDOM_Node > { > public: > virtual const XMLCh* getTagName() const = 0; > virtual const XMLCh* getAttribute(const XMLCh* name) const = 0; > virtual void setAttribute(const XMLCh* name, > const XMLCh* value) = 0; > virtual void removeAttribute(const XMLCh* name) = 0; > virtual IDOM_Attr* getAttributeNode(const XMLCh* name) const = 0; > virtual IDOM_Attr* setAttributeNode(IDOM_Attr* newAttr) = 0; > virtual IDOM_Attr* removeAttributeNode(IDOM_Attr* oldAttr) = 0; > virtual IDOM_NodeList* getElementsByTagName(const XMLCh* name) const = 0; > virtual const XMLCh* getAttributeNS(const XMLCh* namespaceURI, > const XMLCh* localName) const = 0; > virtual void setAttributeNS(const XMLCh* namespaceURI, > const XMLCh* qualifiedName, > const XMLCh* value) = 0; > virtual void removeAttributeNS(const XMLCh* namespaceURI, > const XMLCh* localName) = 0; > virtual IDOM_Attr* getAttributeNodeNS(const XMLCh* namespaceURI, > const XMLCh* localName) const = 0; > virtual IDOM_Attr* setAttributeNodeNS(IDOM_Attr* newAttr) = 0; > virtual IDOM_NodeList* getElementsByTagNameNS(const XMLCh* namespaceURI, > const XMLCh* localName) const >=0; > virtual bool hasAttribute(const XMLCh* name) const = 0; > virtual bool hasAttributeNS(const XMLCh* namespaceURI, > const XMLCh* localName) const = 0; > }; > IDOM_Text.hpp: > class IDOM_Text: IDOM_CharacterData > { > public: > virtual IDOM_Text* splitText(IDOMSize_t offset) = 0; > }; > IDOM_Comment.hpp: > class IDOM_Comment: IDOM_CharacterData > { > }; > IDOM_CDATASection.hpp: > class IDOM_CDATASection: IDOM_Text > { > }; > IDOM_DocumentType.hpp: > class IDOM_DocumentType: IDOM_Node > { > public: > virtual const XMLCh* getName() const = 0; > virtual IDOM_NamedNodeMap* getEntities() const = 0; > virtual IDOM_NamedNodeMap* getNotations() const = 0; > virtual const XMLCh* getPublicId() const = 0; > virtual const XMLCh* getSystemId() const = 0; > virtual const XMLCh* getInternalSubset() const = 0; > }; > IDOM_Notation.hpp: > class IDOM_Notation: IDOM_Node > { > public: > virtual const XMLCh* getPublicId() const = 0; > virtual const XMLCh* getSystemId() const = 0; > }; > IDOM_Entity.hpp: > class IDOM_Entity: IDOM_Node > { > public: > virtual const XMLCh* getPublicId() const = 0; > virtual const XMLCh* getSystemId() const = 0; > virtual const XMLCh* getNotationName() const = 0; > }; > IDOM_EntityReference.hpp: > class IDOM_EntityReference: IDOM_Node > { > }; > IDOM_ProcessingInstruction.hpp: > class IDOM_ProcessingInstruction: IDOM_Node > { > public: > virtual const XMLCh* getTarget() const = 0; > virtual const XMLCh* getData() const = 0; > virtual void setData(const XMLCh* data) = 0; > }; > > ---------------------------------------------------------------------------- > B: Document Object Model: Traversal <#C++ Language Binding for DOM Level 2> > IDOM_NodeIterator.hpp: > class IDOM_NodeIterator > { > public: > virtual IDOM_Node* getRoot() const = 0; > virtual unsigned long getWhatToShow() const = 0; > virtual IDOM_NodeFilter* getFilter() const = 0; > virtual bool getExpandEntityReferences() const = 0; > virtual IDOM_Node* nextNode() = 0; > virtual IDOM_Node* previousNode() = 0; > virtual void detach() = 0; > }; > IDOM_NodeFilter.hpp: > class IDOM_NodeFilter > { > public: > // FilterAction > enum FilterAction { > FILTER_ACCEPT = 1, > FILTER_REJECT = 2, > FILTER_SKIP = 3 > }; > // ShowType > enum ShowType { > SHOW_ALL = 0x0000FFFF, > SHOW_ELEMENT = 0x00000001, > SHOW_ATTRIBUTE = 0x00000002, > SHOW_TEXT = 0x00000004, > SHOW_CDATA_SECTION = 0x00000008, > SHOW_ENTITY_REFERENCE = 0x00000010, > SHOW_ENTITY = 0x00000020, > SHOW_PROCESSING_INSTRUCTION = 0x00000040, > SHOW_COMMENT = 0x00000080, > SHOW_DOCUMENT = 0x00000100, > SHOW_DOCUMENT_TYPE = 0x00000200, > SHOW_DOCUMENT_FRAGMENT = 0x00000400, > SHOW_NOTATION = 0x00000800 > }; > virtual short acceptNode (const IDOM_Node* node) const = 0; > }; > IDOM_TreeWalker.hpp: > class IDOM_TreeWalker > { > public: > virtual IDOM_Node* getRoot() const = 0; > virtual unsigned long getWhatToShow()const = 0; > virtual IDOM_NodeFilter* getFilter()const = 0; > virtual bool getExpandEntityReferences()const = 0; > virtual IDOM_Node* getCurrentNode()const = 0; > virtual void setCurrentNode(IDOM_Node* currentNode)= 0; > virtual IDOM_Node* parentNode()= 0; > virtual IDOM_Node* firstChild()= 0; > virtual IDOM_Node* lastChild()= 0; > virtual IDOM_Node* previousSibling()= 0; > virtual IDOM_Node* nextSibling()= 0; > virtual IDOM_Node* previousNode()= 0; > virtual IDOM_Node* nextNode()= 0; > }; > IDOM_DocumentTraversal.hpp: > // This interface can be obtained from the object implementing the > // Document interface using binding-specific casting methods. > class IDOM_DocumentTraversal > { > public: > virtual IDOM_NodeIterator* createNodeIterator(IDOM_Node* root, > unsigned long whatToShow, > IDOM_NodeFilter* filter, > bool >entityReferenceExpansion) = 0; > virtual IDOM_TreeWalker* createTreeWalker(IDOM_Node* root, > unsigned long whatToShow, > IDOM_NodeFilter* filter, > bool >entityReferenceExpansion) = 0; > };; > > ---------------------------------------------------------------------------- > C: Document Object Model: Range <#C++ Language Binding for DOM Level 2> > IDOM_RangeException.hpp: > class IDOM_RangeException : IDOM_DOMException > { > public: > // IDOM_RangeExceptionCode > enum IDOM_RangeExceptionCode { > BAD_BOUNDARYPOINTS_ERR = 1, > INVALID_NODE_TYPE_ERR = 2 > }; > IDOM_RangeExceptionCode code; > }; > IDOM_Range.hpp: > class IDOM_Range > { > public: > // CompareHow > enum CompareHow { > START_TO_START = 0, > START_TO_END = 1, > END_TO_END = 2, > END_TO_START = 3 > }; > virtual IDOM_Node* getStartContainer() const = 0; > virtual IDOMSize_t getStartOffset() const = 0; > virtual IDOM_Node* getEndContainer() const = 0; > virtual IDOMSize_t getEndOffset() const = 0; > virtual bool getCollapsed() const = 0; > virtual const IDOM_Node* getCommonAncestorContainer() const = 0; > virtual void setStart(const IDOM_Node* parent, > IDOMSize_t offset) = 0; > virtual void setEnd(const IDOM_Node* parent, > IDOMSize_t offset) = 0; > virtual void setStartBefore(const IDOM_Node* refNode) = 0; > virtual void setStartAfter(const IDOM_Node* refNode) = 0; > virtual void setEndBefore(const IDOM_Node* refNode) = 0; > virtual void setEndAfter(const IDOM_Node* refNode) = 0; > virtual void collapse(bool toStart) = 0; > virtual void selectNode(const IDOM_Node* node) = 0; > virtual void selectNodeContents(const IDOM_Node* node) = 0; > virtual short compareBoundaryPoints(CompareHow how, > const IDOM_Range* range) const >= 0; > virtual void deleteContents() = 0; > virtual IDOM_DocumentFragment* extractContents() = 0; > virtual IDOM_DocumentFragment* cloneContents() const = 0; > virtual void insertNode(IDOM_Node* node) = 0; > virtual void surroundContents(IDOM_Node* node) = 0; > virtual IDOM_Range* cloneRange() const = 0; > virtual const XMLCh* toString() const = 0; > virtual void detach() = 0; > > }; > IDOM_DocumentRange.hpp: > // This interface can be obtained from the object implementing the > // Document interface using binding-specific casting methods. > class IDOM_DocumentRange > { > public: > virtual IDOM_Range* createRange() = 0; > }; > > ---------------------------------------------------------------------------- > > > ---------------------------------------------------------------------------- > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > > > > -- > /********************************** > James D. Berry > mailto:[EMAIL PROTECTED] > vox:503.265.1213 fax:503.222.3020 > **********************************/ > > -- Murray Cumming [EMAIL PROTECTED] www.murrayc.com --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
