vcdom 0.2.0

data/lib/vcdom/minidom/minidom_standard_error.rb

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+
+module VCDOM
+  module MiniDOM
+    class MiniDOMStandardError < StandardError
+      
+    end
+  end
+end

data/lib/vcdom/minidom/mod_child_node.rb

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+
+require "vcdom/minidom/mod_parent_node"
+
+module VCDOM
+  module MiniDOM
+    module ModChildNode
+      
+      # Attr, Document, DocumentFragment, Entity, Notation 以外のクラスに Mixed-in される
+      
+      include ModParentNode::ParentNodeManageable
+      
+      # parentNode of type Node, readonly
+      #   The parent of this node. 
+      #   All nodes, except Attr, Document, DocumentFragment, Entity, and Notation may 
+      #   have a parent. 
+      #   However, if a node has just been created and not yet added to the tree, 
+      #   or if it has been removed from the tree, this is null.
+      def parent_node
+        return @parent_node
+      end
+      
+      # previousSibling of type Node, readonly
+      #   The node immediately preceding this node. 
+      #   If there is no such node, this returns null.
+      def previous_sibling
+        if ! @parent_node.nil? then
+          if idx = @parent_node.get_index_of( self ) then
+            return @parent_node.child_nodes.item( idx - 1 )
+          end
+        end
+        return nil
+      end
+      # nextSibling of type Node, readonly
+      #   The node immediately following this node. If there is no such node, this returns null.
+      def next_sibling
+        if ! @parent_node.nil? then
+          if idx = @parent_node.get_index_of( self ) then
+            return @parent_node.child_nodes.item( idx + 1 )
+          end
+        end
+        return nil
+      end
+      
+      def init_mod_child_node()
+        @parent_node = nil
+      end
+      
+    end
+  end
+end

data/lib/vcdom/minidom/mod_elements_getter.rb

@@ -0,0 +1,49 @@
+# -*- coding: utf-8 -*-
+
+require "vcdom/minidom/node_list"
+
+module VCDOM
+  module MiniDOM
+    module ModElementsGetter
+      
+      # Document, Element に Mixed-in
+      
+      def get_elements_by_tagname( tagname )
+        list = []
+        _add_matched_descendant_elems_to_list( self, list, tagname )
+        return NodeList.new( list )
+      end
+      
+      def get_elements_by_tagname_ns( namespace_uri, local_name )
+        list = []
+        _add_matched_descendant_elems_to_list_ns( self, list, namespace_uri, local_name )
+        return NodeList.new( list )
+      end
+      
+      private
+      def _add_matched_descendant_elems_to_list( elem, list, tagname )
+        elem.child_nodes.each do |item|
+          if item.node_type == Node::ELEMENT_NODE and 
+                ( tagname == '*' or item.tagname == tagname ) then
+            list << item
+          end
+          _add_matched_descendant_elems_to_list( item, list, tagname )
+        end
+      end
+      def _add_matched_descendant_elems_to_list_ns( elem, list, namespace_uri, local_name )
+        elem.child_nodes.each do |item|
+          if item.node_type == Node::ELEMENT_NODE then
+            if namespace_uri == '*' or ( namespace_uri.nil? and item.namespace_uri.nil? ) or
+                  namespace_uri == item.namespace_uri then
+              if local_name == '*' or local_name == item.local_name then
+                list << item
+              end
+            end
+          end
+          _add_matched_descendant_elems_to_list_ns( item, list, namespace_uri, local_name )
+        end
+      end
+      
+    end
+  end
+end

data/lib/vcdom/minidom/mod_namespaceuri_manageable.rb

@@ -0,0 +1,152 @@
+# -*- coding: utf-8 -*-
+
+module VCDOM
+  module MiniDOM
+    module ModNamespaceURIManageable
+      
+      # namespaceURI of type DOMString, readonly, introduced in DOM Level 2
+      #   The namespace URI of this node, or null if it is unspecified (see XML Namespaces).
+      #   This is not a computed value that is the result of a namespace lookup based on 
+      #   an examination of the namespace declarations in scope. 
+      #   It is merely the namespace URI given at creation time.
+      #   For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and 
+      #   nodes created with a DOM Level 1 method, such as Document.createElement(), 
+      #   this is always null.
+      #   
+      #   Note: Per the Namespaces in XML Specification [XML Namespaces] an attribute 
+      #         does not inherit its namespace from the element it is attached to. 
+      #         If an attribute is not explicitly given a namespace, it simply has 
+      #         no namespace.
+      def namespace_uri
+        return @namespace_uri
+      end
+      
+      # localName of type DOMString, readonly, introduced in DOM Level 2
+      #   Returns the local part of the qualified name of this node.
+      #   For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes 
+      #   created with a DOM Level 1 method, such as Document.createElement(), 
+      #   this is always null.
+      def local_name
+        qname_arr = self.node_name.split(/:/u)
+        return qname_arr[-1]
+      end
+      
+      # prefix of type DOMString, introduced in DOM Level 2
+      #   The namespace prefix of this node, or null if it is unspecified. 
+      #     #=> このノードの名前空間接頭辞, または null (指定されていない場合) です.
+      #   When it is defined to be null, setting it has no effect, including if the node is read-only.
+      #     #=> null と明示されている場合, およびノードが読み取り専用の場合は, 値の代入は何の効果もありません.  
+      #   Note that setting this attribute, when permitted, changes the nodeName attribute, 
+      #   which holds the qualified name, as well as the tagName and name attributes of the Element 
+      #   and Attr interfaces, when applicable.
+      #     #=> (代入可能な場合に) 値の代入を行うと, nodeName 属性 (qualified name を保持している) が変化します.
+      #     #=> Element インターフェイスの tagName 属性や Attr インターフェイスの name 属性も同様です. (それらに応用可能な場合)
+      #   Setting the prefix to null makes it unspecified, setting it to an empty string is implementation dependent.
+      #   Note also that changing the prefix of an attribute that is known to have a default value, 
+      #   does not make a new attribute with the default value and the original prefix appear, 
+      #   since the namespaceURI and localName do not change.
+      #   For nodes of any type other than ELEMENT_NODE and ATTRIBUTE_NODE and nodes created 
+      #   with a DOM Level 1 method, such as createElement from the Document interface, this is always null.
+      #   
+      #   Exceptions on setting
+      #     DOMException
+      #       INVALID_CHARACTER_ERR:
+      #         Raised if the specified prefix contains an illegal character according to the XML version 
+      #         in use specified in the Document.xmlVersion attribute.
+      #       NO_MODIFICATION_ALLOWED_ERR: 
+      #         Raised if this node is readonly.
+      #       NAMESPACE_ERR: 
+      #         Raised if the specified prefix is malformed per the Namespaces in XML specification, 
+      #         if the namespaceURI of this node is null, if the specified prefix is "xml" and 
+      #         the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace", 
+      #         if this node is an attribute and the specified prefix is "xmlns" and 
+      #         the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/", 
+      #         or if this node is an attribute and the qualifiedName of this node is "xmlns" [XML Namespaces].
+      def prefix
+        qname_arr = self.node_name.split(/:/u)
+        return qname_arr[-2]
+      end
+      def prefix=( value )
+        if self.is_readonly then
+          raise DOMException.new( DOMException::NO_MODIFICATION_ALLOWED_ERR, 
+                  'This node is readonly.' )
+        end
+        unless value.nil? or value.is_a? String then
+          begin
+            value = value.to_str()
+          rescue
+            raise TypeError.new( 'The argument value must be String object or nil.' )
+          end
+        end
+        if value.nil? or value.length == 0 then
+          self.node_name = self.local_name
+        end
+        if XMLRegExp::NCNAME =~ value then
+          if self.namespace_uri.nil? then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The namespace URI of this node is null, so an prefix can\'t be set.' )
+          end
+          if value == "xml" and self.namespace_uri != "http://www.w3.org/XML/1998/namespace" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The specified prefix is "xml" and the namespace URI of this node is different from "http://www.w3.org/XML/1998/namespace"' )
+          end
+          if self.node_type == Node::ATTRIBUTE_NODE then
+            if value == 'xmlns' and self.namespace_uri != "http://www.w3.org/2000/xmlns/" then
+              raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                      'The specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/".' )
+            end
+            if self.node_name == 'xmlns' then
+              raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                      'The qualifiedName of this node is "xmlns".' )
+            end
+          end
+          self.tagname = value + ':' + self.local_name
+        else
+          raise DOMException.new( DOMException::INVALID_CHARACTER_ERR, 
+                  'The specified prefix "' + value + '" contains an illegal character.' )
+        end
+      end
+      
+      def init_mod_namespaceuri_manageable( namespace_uri, qualified_name )
+        # namespace_uri が空文字列であるならば, nil として扱う
+        @namespace_uri = ( namespace_uri == '' ? nil : namespace_uri )
+        if /\A([^:]+)(?::([^:]+))?\Z/u =~ qualified_name then
+          name_prefix = ( $2.nil? ? nil : $1 )
+        else
+          # the qualified name is malformed
+          raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                  'The qualified name "' + qualified_name + '" is malformed.' )
+        end
+        if ! name_prefix.nil? then
+          if @namespace_uri.nil? then
+            # the qualified name has a prefix and the namespace URI is null
+            raise DOMException.new( DOMException::NAMESPACE_ERR,
+                    'The qualified name "' + qualified_name + '" has a prefix, but the namespace URI is null.' )
+          end
+          if name_prefix == 'xml' and @namespace_uri != "http://www.w3.org/XML/1998/namespace" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The qualified name has a prefix "xml", but the namespace URI is different from "http://www.w3.org/XML/1998/namespace".' )
+          end
+          if name_prefix == 'xmlns' and @namespace_uri != "http://www.w3.org/2000/xmlns/" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The qualified name has a prefix "xmlns", but the namespace URI is different from "http://www.w3.org/2000/xmlns/".' )
+          end
+          if name_prefix != 'xmlns' and @namespace_uri == "http://www.w3.org/2000/xmlns/" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The namespace URI is "http://www.w3.org/2000/xmlns/", but the prefix of the qualified name is not "xmlns".' )
+          end
+        else
+          if qualified_name == 'xmlns' and @namespace_uri != "http://www.w3.org/2000/xmlns/" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The qualified name is "xmlns", but the namespace URI is different from "http://www.w3.org/2000/xmlns/".' )
+          end
+          if qualified_name != 'xmlns' and @namespace_uri == "http://www.w3.org/2000/xmlns/" then
+            raise DOMException.new( DOMException::NAMESPACE_ERR, 
+                    'The namespace URI is "http://www.w3.org/2000/xmlns/", but the qualified name is not "xmlns".' )
+          end
+        end
+      end
+      
+    end
+  end
+end

data/lib/vcdom/minidom/mod_parent_node.rb

@@ -0,0 +1,307 @@
+# -*- coding: utf-8 -*-
+
+require "vcdom/minidom/node_list"
+
+module VCDOM
+  module MiniDOM
+    module ModParentNode
+      
+      # Document, DocumentFragment, EntityReference, Element, Attr, Entity に
+      # Mixed-in される 
+      
+      module ParentNodeManageable
+        protected
+        def parent_node=( pn )
+          @parent_node = pn
+        end
+        def get_index_of( child_node )
+          @child_nodes.each_index do |index|
+            if @child_nodes[index].equal? child_node then
+              return index
+            end
+          end
+          return nil
+        end
+      end
+      
+      include ParentNodeManageable
+      
+      # childNodes of type NodeList, readonly
+      #   A NodeList that contains all children of this node. If there are no children, this is a NodeList containing no nodes.
+      def child_nodes; return @child_nodes_wrapper end
+      
+      # firstChild of type Node, readonly
+      #   The first child of this node. If there is no such node, this returns null.
+      def first_child; return @child_nodes[0] end
+      
+      # lastChild of type Node, readonly
+      #   The last child of this node. If there is no such node, this returns null.
+      def last_child; return @child_nodes[-1] end
+      
+      # hasChildNodes
+      #   
+      #   Returns whether this node has any children.
+      #   
+      #   Return Value
+      #     boolean
+      #       Returns true if this node has any children, false otherwise.
+      #   No Parameters
+      #   No Exceptions
+      def has_child_nodes()
+        return ( @child_nodes.length > 0 ) ? true : false
+      end
+      
+      # textContent of type DOMString, introduced in DOM Level 3
+      #   
+      #   This attribute returns the text content of this node and its descendants. 
+      #   When it is defined to be null, setting it has no effect. 
+      #   On setting, any possible children this node may have are removed and, 
+      #   if it the new string is not empty or null, replaced by a single Text node 
+      #   containing the string this attribute is set to.
+      #   On getting, no serialization is performed, the returned string does not 
+      #   contain any markup. No whitespace normalization is performed and the 
+      #   returned string does not contain the white spaces in element content 
+      #   (see the attribute Text.isElementContentWhitespace). 
+      #   Similarly, on setting, no parsing is performed either, the input string 
+      #   is taken as pure textual content.
+      #   
+      #   The string returned is made of the text content of this node depending on 
+      #   its type, as defined below:
+      #       
+      #        Node type                        Content
+      #        ---------------------------------------------------
+      #        ELEMENT_NODE, ATTRIBUTE_NODE,    concatenation of the textContent attribute value
+      #         ENTITY_NODE,                     of every child node, excluding COMMENT_NODE and 
+      #         ENTITY_REFERENCE_NODE,           PROCESSING_INSTRUCTION_NODE nodes. This is the  
+      #         DOCUMENT_FRAGMENT_NODE           empty string if the node has no children.
+      #   
+      #   Exceptions on setting
+      #     DOMException
+      #       NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
+      #   Exceptions on retrieval
+      #     DOMException
+      #       DOMSTRING_SIZE_ERR: Raised when it would return more characters 
+      #                 than fit in a DOMString variable on the implementation platform.
+      # 
+      # Document node でオーバーライド
+      def text_content
+        value = String.new()
+        @child_nodes.each do |node|
+          case node.node_type
+            when Node::COMMENT_NODE, Node::PROCESSING_INSTRUCTION_NODE then
+              # do nothing
+            else
+              value << node.text_content
+          end
+        end
+        return value
+      end
+      def text_content=( value )
+        if self.is_readonly then
+          raise DOMException.new( NO_MODIFICATION_ALLOWED_ERR, 'This node is readonly.' )
+        end
+        while self.has_child_nodes do
+          self.remove_child( self.first_child )
+        end
+        unless value.nil? or value.length == 0 then
+          self.append_child( self.owner_document.create_text_node( value ) )
+        end
+      end
+      
+      # appendChild modified in DOM Level 3
+      #   
+      #   Adds the node newChild to the end of the list of children of this node. 
+      #   If the newChild is already in the tree, it is first removed.
+      #   
+      #   Parameters
+      #     newChild of type Node
+      #       The node to add.
+      #       If it is a DocumentFragment object, the entire contents of the document fragment are moved 
+      #       into the child list of this node
+      #   Return Value
+      #     Node
+      #       The node added.
+      #   Exceptions
+      #     DOMException
+      #       HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not 
+      #                 allow children of the type of the newChild node, or if the 
+      #                 node to append is one of this node's ancestors or this node 
+      #                 itself, or if this node is of type Document and the DOM 
+      #                 application attempts to append a second DocumentType or 
+      #                 Element node.
+      #         #=> newNode がこのノードの子になれない nodeType である場合や, newNode がこのノードの先祖である場合や自分自身
+      #         #=> である場合, また, もしこのノードのタイプが Document で 2 つ目の DocumentType や Element を追加しようとした場合など
+      #         #=> にこの例外が発生する.
+      #       WRONG_DOCUMENT_ERR: Raised if newChild was created from a different 
+      #                 document than the one that created this node.
+      #       (DOMImplementation より
+      #            WRONG_DOCUMENT_ERR: Raised if doctype has already been used with a different 
+      #                  document or was created from a different implementation.
+      #       NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or if the 
+      #                 previous parent of the node being inserted is readonly.
+      #       NOT_SUPPORTED_ERR: if the newChild node is a child of the Document node, this exception might 
+      #                 be raised if the DOM implementation doesn't support the removal of the DocumentType 
+      #                 child or Element child.
+      def append_child( new_child )
+        new_child_list = []
+        if new_child.node_type == Node::DOCUMENT_FRAGMENT_NODE then
+          while new_child.has_child_nodes do
+            new_child_list << new_child.remove_child( new_child.first_child )
+          end
+        else
+          new_child_list << new_child
+        end
+        new_child_list.each do |nc|
+          # Hierarchy request err のチェック
+          begin
+            check_hierarchy( nc )
+          rescue => err
+            raise err
+          end
+          # Wrong document err のチェック
+          cdoc = ( self.owner_document or self )
+          if nc.node_type != Node::DOCUMENT_TYPE_NODE then
+            if nc.owner_document != cdoc then
+              raise DOMException.new( DOMException::WRONG_DOCUMENT_ERR, 
+                      'The new child was created from a different document than the one that created this node.' )
+            end
+          end
+        end
+        new_child_list.each do |nc|
+          # 親が居る場合, まず取り除く
+          if ! nc.parent_node.nil? then
+            nc.parent_node.remove_child( nc )
+          end
+          @child_nodes << nc
+          nc.parent_node = self
+        end
+        #$stdout << "ModParentNode#append_child: " << new_child << "\n"
+        #$stdout << "ModParentNode#append_child: " << new_child.node_name << "\n"
+        return new_child
+      end
+      
+      # insertBefore modified in DOM Level 3
+      #   
+      #   Inserts the node newChild before the existing child node refChild. If refChild is null, 
+      #   insert newChild at the end of the list of children.
+      #   If newChild is a DocumentFragment object, all of its children are inserted, in the same 
+      #   order, before refChild. If the newChild is already in the tree, it is first removed.
+      #   
+      #   Note: Inserting a node before itself is implementation dependent.
+      #   
+      #   Parameters
+      #     newChild of type Node
+      #       The node to insert.
+      #     refChild of type Node
+      #       The reference node, i.e., the node before which the new node must be inserted.
+      #   Return Value
+      #     Node
+      #       The node being inserted.
+      #   Exceptions
+      #     DOMException
+      #       HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children 
+      #                 of the type of the newChild node, or if the node to insert is one of this node's 
+      #                 ancestors or this node itself, or if this node is of type Document and the DOM 
+      #                 application attempts to insert a second DocumentType or Element node.
+      #       WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the 
+      #                 one that created this node.
+      #       NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly or if the parent of the node 
+      #                 being inserted is readonly.
+      #       NOT_FOUND_ERR: Raised if refChild is not a child of this node.
+      #       NOT_SUPPORTED_ERR: if this node is of type Document, this exception might be raised if the 
+      #                 DOM implementation doesn't support the insertion of a DocumentType or Element node.
+      def insert_before( new_child, ref_child )
+        # aRefChild の index 取得. なければ例外発生
+        ( idx = @child_nodes.index( ref_child ) )\
+           or raise DOMException.new( DOMException::NOT_FOUND_ERR, "NOT_FOUND_ERR" )
+        # 追加処理
+        return add_child_at( idx, new_child )
+      end
+      
+      # removeChild modified in DOM Level 3
+      #   
+      #   Removes the child node indicated by oldChild from the list of children, and returns it.
+      #   
+      #   Parameters
+      #     oldChild of type Node
+      #       The node being removed.
+      #   Return Value
+      #     Node
+      #       The node removed.
+      #   Exceptions
+      #     DOMException
+      #       NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
+      #       NOT_FOUND_ERR: Raised if oldChild is not a child of this node.
+      #       NOT_SUPPORTED_ERR: if this node is of type Document, this exception 
+      #                 might be raised if the DOM implementation doesn't support 
+      #                 the removal of the DocumentType child or the Element child.
+      def remove_child( old_child )
+        # aOldChild の index を取得. 子ノードに含まれなければ例外発生
+        ( idx = get_index_of( old_child ) ) or 
+                raise DOMException.new( DOMException::NOT_FOUND_ERR, "The old child is not a child of this node." )
+        # 削除
+        @child_nodes.delete_at( idx )
+        old_child.parent_node = nil
+        return old_child
+      end
+      
+      # replaceChild modified in DOM Level 3
+      #   
+      #   Replaces the child node oldChild with newChild in the list of children, and returns the oldChild node.
+      #     #=> 子ノードのうち、oldChild を newChild で置き換え、oldChild を返す.
+      #   If newChild is a DocumentFragment object, oldChild is replaced by all of the DocumentFragment children, 
+      #   which are inserted in the same order. 
+      #     #=> もし newChild が DocumentFragment オブジェクトならば, oldChild は newChild の全ての子をそのままの順で置き換えられる.
+      #   If the newChild is already in the tree, it is first removed.
+      #     #=> もし newChild が既に DOM 木の中に存在するならば, まず最初に取り除かれる.
+      #   
+      #   Note: Replacing a node with itself is implementation dependent.
+      #     #=> Note: 自分自身を自分自身で置き換えようとしたときの動作は, 実装に依存する.
+      #   
+      #   Parameters
+      #     newChild of type Node
+      #       The new node to put in the child list.
+      #     oldChild of type Node
+      #       The node being replaced in the list.
+      #   Return Value
+      #     Node
+      #       The node replaced.
+      #   Exceptions
+      #     DOMException
+      #       HIERARCHY_REQUEST_ERR: Raised if this node is of a type that does not allow children of the type 
+      #               of the newChild node, or if the node to put in is one of this node's ancestors or this 
+      #               node itself, or if this node is of type Document and the result of the replacement 
+      #               operation would add a second DocumentType or Element on the Document node.
+      #       WRONG_DOCUMENT_ERR: Raised if newChild was created from a different document than the one that 
+      #               created this node.
+      #       NO_MODIFICATION_ALLOWED_ERR: Raised if this node or the parent of the new node is readonly.
+      #       NOT_FOUND_ERR: Raised if oldChild is not a child of this node.
+      #       NOT_SUPPORTED_ERR: if this node is of type Document, this exception might be raised if the DOM 
+      #               implementation doesn't support the replacement of the DocumentType child or Element child.
+      def replace_child( new_child, old_child )
+# 未実装
+      end
+      
+      private
+      # サブクラスでオーバーライドしなければならない
+      def check_hierarchy( new_child, is_overrided = false )
+        raise "The internal error in VCDOM::MiniDOM is occured." unless is_overrided
+        # new_child が自分の先祖でないかどうかのチェック
+        elem = self
+        while ! elem.nil? do
+          if elem.equal? new_child then
+            raise DOMException.new( DOMException::HIERARCHY_REQUEST_ERR, 
+                    'The node to append is one of this node\'s ancestors or this node itself.' )
+          end
+          elem = elem.parent_node
+        end
+      end
+      
+      def init_mod_parent_node()
+        @child_nodes = []
+        @child_nodes_wrapper = NodeList.new( @child_nodes )
+      end
+      
+    end
+  end
+end