org.apache.xerces.dom

Class DeferredDocumentImpl

Implemented Interfaces:
Cloneable, DeferredNode, org.w3c.dom.events.DocumentEvent, org.w3c.dom.ranges.DocumentRange, org.w3c.dom.traversal.DocumentTraversal, org.w3c.dom.Document, org.w3c.dom.events.EventTarget, org.w3c.dom.Node, org.w3c.dom.NodeList, Serializable

public class DeferredDocumentImpl
extends DocumentImpl
implements DeferredNode

The Document interface represents the entire HTML or XML document. Conceptually, it is the root of the document tree, and provides the primary access to the document's data.

Since elements, text nodes, comments, processing instructions, etc. cannot exist outside the context of a Document, the Document interface also contains the factory methods needed to create these objects. The Node objects created have a ownerDocument attribute which associates them with the Document within whose context they were created.

Version:
$Id: DeferredDocumentImpl.java 437729 2006-08-28 15:52:19Z mrglavas $
Since:
PR-DOM-Level-1-19980818.

Field Summary

protected static int
CHUNK_MASK
Chunk mask.
protected static int
CHUNK_SHIFT
Chunk shift.
protected static int
CHUNK_SIZE
Chunk size.
protected static int
INITIAL_CHUNK_COUNT
Initial chunk size.
protected int
fIdCount
Identifier count.
protected int[]
fIdElement
Identifier element indexes.
protected String[]
fIdName
Identifier name indexes.
protected boolean
fNamespacesEnabled
DOM2: For namespace support in the deferred case.
protected int
fNodeCount
Node count.
protected int[][]
fNodeExtra
Extra data.
protected int[][]
fNodeLastChild
Node first children.
protected Object[][]
fNodeName
Node names.
protected int[][]
fNodeParent
Node parents.
protected int[][]
fNodePrevSib
Node prev siblings.
protected int[][]
fNodeType
Node types.
protected Object[][]
fNodeURI
Node namespace URI.
protected Object[][]
fNodeValue
Node values.

Fields inherited from class org.apache.xerces.dom.DocumentImpl

eventListeners, iterators, mutationEvents, ranges

Fields inherited from class org.apache.xerces.dom.CoreDocumentImpl

actualEncoding, allowGrammarAccess, changes, docElement, docType, encoding, errorChecking, fDocumentURI, identifiers, standalone, userData, version, xmlVersionChanged

Fields inherited from class org.apache.xerces.dom.ParentNode

fNodeListCache, firstChild, ownerDocument

Fields inherited from class org.apache.xerces.dom.ChildNode

nextSibling, previousSibling

Fields inherited from class org.apache.xerces.dom.NodeImpl

DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_IS_CONTAINED, DOCUMENT_POSITION_PRECEDING, ELEMENT_DEFINITION_NODE, FIRSTCHILD, HASSTRING, ID, IGNORABLEWS, NORMALIZED, OWNED, READONLY, SPECIFIED, SYNCCHILDREN, SYNCDATA, TREE_POSITION_ANCESTOR, TREE_POSITION_DESCENDANT, TREE_POSITION_DISCONNECTED, TREE_POSITION_EQUIVALENT, TREE_POSITION_FOLLOWING, TREE_POSITION_PRECEDING, TREE_POSITION_SAME_NODE, flags, ownerNode

Fields inherited from interface org.apache.xerces.dom.DeferredNode

TYPE_NODE

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

Constructor Summary

DeferredDocumentImpl()
NON-DOM: Actually creating a Document is outside the DOM's spec, since it has to operate in terms of a particular implementation.
DeferredDocumentImpl(boolean namespacesEnabled)
NON-DOM: Actually creating a Document is outside the DOM's spec, since it has to operate in terms of a particular implementation.
DeferredDocumentImpl(boolean namespaces, boolean grammarAccess)
Experimental constructor.

Method Summary

void
appendChild(int parentIndex, int childIndex)
Appends a child to the specified parent in the table.
protected static int
binarySearch(values[] , int start, int end, int target)
Performs a binary search for a target value in an array of values.
int
cloneNode(int nodeIndex, boolean deep)
Creates a clone of the specified node.
int
createDeferredAttribute(String attrName, String attrURI, String attrValue, boolean specified)
Creates an attribute with a URI in the table.
int
createDeferredAttribute(String attrName, String attrValue, boolean specified)
Creates an attribute in the table.
int
createDeferredCDATASection(String data)
Creates a CDATA section node in the table.
int
createDeferredComment(String data)
Creates a comment node in the table.
int
createDeferredDocument()
Creates a document node in the table.
int
createDeferredDocumentType(String rootElementName, String publicId, String systemId)
Creates a doctype.
int
createDeferredElement(String elementName)
int
createDeferredElement(String elementURI, String elementName)
int
createDeferredElement(String elementURI, String elementName, Object type)
Creates an element node with a URI in the table and type information.
int
createDeferredElementDefinition(String elementName)
Creates an element definition in the table.
int
createDeferredEntity(String entityName, String publicId, String systemId, String notationName, String baseURI)
Creates an entity in the table.
int
createDeferredEntityReference(String name, String baseURI)
Creates an entity reference node in the table.
int
createDeferredNotation(String notationName, String publicId, String systemId, String baseURI)
Creates a notation in the table.
int
createDeferredProcessingInstruction(String target, String data)
Creates a processing instruction node in the table.
int
createDeferredTextNode(String data, boolean ignorableWhitespace)
Creates a text node in the table.
protected int
createNode(short nodeType)
Creates a node of the specified type.
protected void
ensureCapacity(int chunk)
Ensures that the internal tables are large enough.
String
getAttribute(int elemIndex, String name)
Returns the attribute value of the given name.
String
getDeferredEntityBaseURI(int entityIndex)
org.w3c.dom.DOMImplementation
getImplementation()
Retrieve information describing the abilities of this particular DOM implementation.
int
getLastChild(int nodeIndex)
Returns the last child of the given node.
int
getLastChild(int nodeIndex, boolean free)
Returns the last child of the given node.
int
getNodeExtra(int nodeIndex)
Returns the extra info of the given node.
int
getNodeExtra(int nodeIndex, boolean free)
Returns the extra info of the given node.
int
getNodeIndex()
Returns the node index.
String
getNodeName(int nodeIndex)
Returns the name of the given node.
String
getNodeName(int nodeIndex, boolean free)
Returns the name of the given node.
DeferredNode
getNodeObject(int nodeIndex)
Instantiates the requested node object.
short
getNodeType(int nodeIndex)
Returns the type of the given node.
short
getNodeType(int nodeIndex, boolean free)
Returns the type of the given node.
String
getNodeURI(int nodeIndex)
Returns the URI of the given node.
String
getNodeURI(int nodeIndex, boolean free)
Returns the URI of the given node.
String
getNodeValue(int nodeIndex)
Returns the value of the given node.
String
getNodeValue(int nodeIndex, boolean free)
Returns the value of the given node.
String
getNodeValueString(int nodeIndex)
Returns the real value of the given node.
String
getNodeValueString(int nodeIndex, boolean free)
Returns the real value of the given node.
int
getParentNode(int nodeIndex)
Returns the parent node of the given node.
int
getParentNode(int nodeIndex, boolean free)
Returns the parent node of the given node.
int
getPrevSibling(int nodeIndex)
Returns the prev sibling of the given node.
int
getPrevSibling(int nodeIndex, boolean free)
Returns the prev sibling of the given node.
int
getRealPrevSibling(int nodeIndex)
Returns the real prev sibling of the given node, directly from the data structures.
int
getRealPrevSibling(int nodeIndex, boolean free)
Returns the real prev sibling of the given node.
Object
getTypeInfo(int nodeIndex)
Clears the type info that is stored in the fNodeValue array
int
insertBefore(int parentIndex, int newChildIndex, int refChildIndex)
Inserts a child before the specified node in the table.
int
lookupElementDefinition(String elementName)
Returns the index of the element definition in the table with the specified name index, or -1 if no such definition exists.
void
print()
Prints out the tables.
void
putIdentifier(String name, int elementNodeIndex)
Registers an identifier name with a specified element node.
void
setAsLastChild(int parentIndex, int childIndex)
Sets the last child of the parentIndex to childIndex.
int
setAttributeNode(int elemIndex, int attrIndex)
Adds an attribute node to the specified element.
int
setDeferredAttribute(int elementNodeIndex, String attrName, String attrURI, String attrValue, boolean specified)
int
setDeferredAttribute(int elementNodeIndex, String attrName, String attrURI, String attrValue, boolean specified, boolean id, Object type)
This method is used by the DOMParser to create attributes.
void
setEntityInfo(int currentEntityDecl, String version, String encoding)
void
setIdAttribute(int attrIndex)
Sets type of attribute
void
setIdAttributeNode(int elemIndex, int attrIndex)
Adds an attribute node to the specified element.
void
setInputEncoding(int currentEntityDecl, String value)
DOM Internal An attribute specifying the actual encoding of this document.
void
setInternalSubset(int doctypeIndex, String subset)
protected void
synchronizeChildren()
Synchronizes the node's children with the internal structure.
protected void
synchronizeChildren(AttrImpl a, int nodeIndex)
Synchronizes the node's children with the internal structure.
protected void
synchronizeChildren(ParentNode p, int nodeIndex)
Synchronizes the node's children with the internal structure.
protected void
synchronizeData()
Synchronizes the node's data.

Methods inherited from class org.apache.xerces.dom.DocumentImpl

addEventListener, cloneNode, copyEventListeners, createEvent, createNodeIterator, createNodeIterator, createRange, createTreeWalker, createTreeWalker, dispatchAggregateEvents, dispatchAggregateEvents, dispatchEvent, dispatchEventToSubtree, dispatchingEventToSubtree, getEventListeners, getImplementation, removeEventListener, saveEnclosingAttr, setEventListeners

Methods inherited from class org.apache.xerces.dom.CoreDocumentImpl

abort, addEventListener, adoptNode, callUserDataHandlers, changed, changes, checkDOMNSErr, checkNamespaceWF, checkQName, clearIdentifiers, clone, cloneNode, cloneNode, copyEventListeners, createAttribute, createAttributeNS, createAttributeNS, createCDATASection, createComment, createDocumentFragment, createDocumentType, createElement, createElementDefinition, createElementNS, createElementNS, createEntity, createEntityReference, createNotation, createProcessingInstruction, createTextNode, dispatchEvent, getAsync, getBaseURI, getDoctype, getDocumentElement, getDocumentURI, getDomConfig, getElementById, getElementsByTagName, getElementsByTagNameNS, getEncoding, getErrorChecking, getFeature, getIdentifier, getIdentifiers, getImplementation, getInputEncoding, getNodeName, getNodeNumber, getNodeNumber, getNodeType, getOwnerDocument, getStandalone, getStrictErrorChecking, getTextContent, getUserData, getUserData, getUserDataRecord, getVersion, getXmlEncoding, getXmlStandalone, getXmlVersion, importNode, insertBefore, isKidOK, isValidQName, isXMLName, load, loadXML, normalizeDocument, putIdentifier, removeChild, removeEventListener, removeIdentifier, renameNode, replaceChild, saveXML, setAsync, setDocumentURI, setEncoding, setErrorChecking, setInputEncoding, setStandalone, setStrictErrorChecking, setTextContent, setUserData, setUserData, setVersion, setXmlEncoding, setXmlStandalone, setXmlVersion, undeferChildren

Methods inherited from class org.apache.xerces.dom.ParentNode

cloneNode, getChildNodes, getChildNodesUnoptimized, getFirstChild, getLastChild, getLength, getOwnerDocument, getTextContent, hasChildNodes, insertBefore, isEqualNode, item, normalize, removeChild, replaceChild, setOwnerDocument, setReadOnly, setTextContent, synchronizeChildren

Methods inherited from class org.apache.xerces.dom.ChildNode

cloneNode, getNextSibling, getParentNode, getPreviousSibling

Methods inherited from class org.apache.xerces.dom.NodeImpl

addEventListener, appendChild, changed, changes, cloneNode, compareDocumentPosition, compareTreePosition, dispatchEvent, getAttributes, getBaseURI, getChildNodes, getContainer, getFeature, getFirstChild, getLastChild, getLength, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeNumber, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getReadOnly, getTextContent, getUserData, getUserData, getUserDataRecord, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, item, lookupNamespaceURI, lookupPrefix, needsSyncChildren, normalize, removeChild, removeEventListener, replaceChild, setNodeValue, setOwnerDocument, setPrefix, setReadOnly, setTextContent, setUserData, setUserData, synchronizeData, toString

Field Details

CHUNK_MASK

protected static final int CHUNK_MASK
Chunk mask.
Field Value:
2047

CHUNK_SHIFT

protected static final int CHUNK_SHIFT
Chunk shift.
Field Value:
11

CHUNK_SIZE

protected static final int CHUNK_SIZE
Chunk size.
Field Value:
2048

INITIAL_CHUNK_COUNT

protected static final int INITIAL_CHUNK_COUNT
Initial chunk size.
Field Value:
32

fIdCount

protected int fIdCount
Identifier count.

fIdElement

protected int[] fIdElement
Identifier element indexes.

fIdName

protected String[] fIdName
Identifier name indexes.

fNamespacesEnabled

protected boolean fNamespacesEnabled
DOM2: For namespace support in the deferred case.

fNodeCount

protected int fNodeCount
Node count.

fNodeExtra

protected int[][] fNodeExtra
Extra data.

fNodeLastChild

protected int[][] fNodeLastChild
Node first children.

fNodeName

protected Object[][] fNodeName
Node names.

fNodeParent

protected int[][] fNodeParent
Node parents.

fNodePrevSib

protected int[][] fNodePrevSib
Node prev siblings.

fNodeType

protected int[][] fNodeType
Node types.

fNodeURI

protected Object[][] fNodeURI
Node namespace URI.

fNodeValue

protected Object[][] fNodeValue
Node values.

Constructor Details

DeferredDocumentImpl

public DeferredDocumentImpl()
NON-DOM: Actually creating a Document is outside the DOM's spec, since it has to operate in terms of a particular implementation.

DeferredDocumentImpl

public DeferredDocumentImpl(boolean namespacesEnabled)
NON-DOM: Actually creating a Document is outside the DOM's spec, since it has to operate in terms of a particular implementation.

DeferredDocumentImpl

public DeferredDocumentImpl(boolean namespaces,
                            boolean grammarAccess)
Experimental constructor.

Method Details

appendChild

public void appendChild(int parentIndex,
                        int childIndex)
Appends a child to the specified parent in the table.

binarySearch

protected static int binarySearch(values[] ,
                                  int start,
                                  int end,
                                  int target)
Performs a binary search for a target value in an array of values. The array of values must be in ascending sorted order before calling this method and all array values must be non-negative.
Parameters:
start - The starting offset of the search.
end - The ending offset of the search.
target - The target value.
Returns:
This function will return the first occurrence of the target value, or -1 if the target value cannot be found.

cloneNode

public int cloneNode(int nodeIndex,
                     boolean deep)
Creates a clone of the specified node.

createDeferredAttribute

public int createDeferredAttribute(String attrName,
                                   String attrURI,
                                   String attrValue,
                                   boolean specified)
Creates an attribute with a URI in the table.

createDeferredAttribute

public int createDeferredAttribute(String attrName,
                                   String attrValue,
                                   boolean specified)
Creates an attribute in the table.

createDeferredCDATASection

public int createDeferredCDATASection(String data)
Creates a CDATA section node in the table.

createDeferredComment

public int createDeferredComment(String data)
Creates a comment node in the table.

createDeferredDocument

public int createDeferredDocument()
Creates a document node in the table.

createDeferredDocumentType

public int createDeferredDocumentType(String rootElementName,
                                      String publicId,
                                      String systemId)
Creates a doctype.

createDeferredElement

public int createDeferredElement(String elementName)

createDeferredElement

public int createDeferredElement(String elementURI,
                                 String elementName)

createDeferredElement

public int createDeferredElement(String elementURI,
                                 String elementName,
                                 Object type)
Creates an element node with a URI in the table and type information.

createDeferredElementDefinition

public int createDeferredElementDefinition(String elementName)
Creates an element definition in the table.

createDeferredEntity

public int createDeferredEntity(String entityName,
                                String publicId,
                                String systemId,
                                String notationName,
                                String baseURI)
Creates an entity in the table.

createDeferredEntityReference

public int createDeferredEntityReference(String name,
                                         String baseURI)
Creates an entity reference node in the table.

createDeferredNotation

public int createDeferredNotation(String notationName,
                                  String publicId,
                                  String systemId,
                                  String baseURI)
Creates a notation in the table.

createDeferredProcessingInstruction

public int createDeferredProcessingInstruction(String target,
                                               String data)
Creates a processing instruction node in the table.

createDeferredTextNode

public int createDeferredTextNode(String data,
                                  boolean ignorableWhitespace)
Creates a text node in the table.

createNode

protected int createNode(short nodeType)
Creates a node of the specified type.

ensureCapacity

protected void ensureCapacity(int chunk)
Ensures that the internal tables are large enough.

getAttribute

public String getAttribute(int elemIndex,
                           String name)
Returns the attribute value of the given name.

getDeferredEntityBaseURI

public String getDeferredEntityBaseURI(int entityIndex)

getImplementation

public org.w3c.dom.DOMImplementation getImplementation()
Retrieve information describing the abilities of this particular DOM implementation. Intended to support applications that may be using DOMs retrieved from several different sources, potentially with different underlying representations.
Specified by:
getImplementation in interface org.w3c.dom.Document
Overrides:
getImplementation in interface DocumentImpl

getLastChild

public int getLastChild(int nodeIndex)
Returns the last child of the given node.

getLastChild

public int getLastChild(int nodeIndex,
                        boolean free)
Returns the last child of the given node.
Parameters:
free - True to free child index.

getNodeExtra

public int getNodeExtra(int nodeIndex)
Returns the extra info of the given node. Used by AttrImpl to store specified value (1 == true).

getNodeExtra

public int getNodeExtra(int nodeIndex,
                        boolean free)
Returns the extra info of the given node.
Parameters:
free - True to free the value index.

getNodeIndex

public int getNodeIndex()
Returns the node index.
Specified by:
getNodeIndex in interface DeferredNode

getNodeName

public String getNodeName(int nodeIndex)
Returns the name of the given node.

getNodeName

public String getNodeName(int nodeIndex,
                          boolean free)
Returns the name of the given node.
Parameters:
free - True to free the string index.

getNodeObject

public DeferredNode getNodeObject(int nodeIndex)
Instantiates the requested node object.

getNodeType

public short getNodeType(int nodeIndex)
Returns the type of the given node.

getNodeType

public short getNodeType(int nodeIndex,
                         boolean free)
Returns the type of the given node.
Parameters:
free - True to free type index.

getNodeURI

public String getNodeURI(int nodeIndex)
Returns the URI of the given node.

getNodeURI

public String getNodeURI(int nodeIndex,
                         boolean free)
Returns the URI of the given node.
Parameters:
free - True to free URI index.

getNodeValue

public String getNodeValue(int nodeIndex)
Returns the value of the given node.

getNodeValue

public String getNodeValue(int nodeIndex,
                           boolean free)
Returns the value of the given node.
Parameters:
free - True to free the value index.

getNodeValueString

public String getNodeValueString(int nodeIndex)
Returns the real value of the given node.

getNodeValueString

public String getNodeValueString(int nodeIndex,
                                 boolean free)
Returns the real value of the given node.
Parameters:
free - True to free the string index.

getParentNode

public int getParentNode(int nodeIndex)
Returns the parent node of the given node. Calling this method does not free the parent index.

getParentNode

public int getParentNode(int nodeIndex,
                         boolean free)
Returns the parent node of the given node.
Parameters:
free - True to free parent node.

getPrevSibling

public int getPrevSibling(int nodeIndex)
Returns the prev sibling of the given node. This is post-normalization of Text Nodes.

getPrevSibling

public int getPrevSibling(int nodeIndex,
                          boolean free)
Returns the prev sibling of the given node.
Parameters:
free - True to free sibling index.

getRealPrevSibling

public int getRealPrevSibling(int nodeIndex)
Returns the real prev sibling of the given node, directly from the data structures. Used by TextImpl#getNodeValue() to normalize values.

getRealPrevSibling

public int getRealPrevSibling(int nodeIndex,
                              boolean free)
Returns the real prev sibling of the given node.
Parameters:
free - True to free sibling index.

getTypeInfo

public Object getTypeInfo(int nodeIndex)
Clears the type info that is stored in the fNodeValue array
Parameters:
nodeIndex -
Returns:
Object - type information for the attribute/element node

insertBefore

public int insertBefore(int parentIndex,
                        int newChildIndex,
                        int refChildIndex)
Inserts a child before the specified node in the table.

lookupElementDefinition

public int lookupElementDefinition(String elementName)
Returns the index of the element definition in the table with the specified name index, or -1 if no such definition exists.

print

public void print()
Prints out the tables.

putIdentifier

public void putIdentifier(String name,
                          int elementNodeIndex)
Registers an identifier name with a specified element node.

setAsLastChild

public void setAsLastChild(int parentIndex,
                           int childIndex)
Sets the last child of the parentIndex to childIndex.

setAttributeNode

public int setAttributeNode(int elemIndex,
                            int attrIndex)
Adds an attribute node to the specified element.

setDeferredAttribute

public int setDeferredAttribute(int elementNodeIndex,
                                String attrName,
                                String attrURI,
                                String attrValue,
                                boolean specified)

setDeferredAttribute

public int setDeferredAttribute(int elementNodeIndex,
                                String attrName,
                                String attrURI,
                                String attrValue,
                                boolean specified,
                                boolean id,
                                Object type)
This method is used by the DOMParser to create attributes.
Parameters:
elementNodeIndex -
attrName -
attrURI -
attrValue -
specified -
id -
type -
Returns:
int

setEntityInfo

public void setEntityInfo(int currentEntityDecl,
                          String version,
                          String encoding)

setIdAttribute

public void setIdAttribute(int attrIndex)
Sets type of attribute

setIdAttributeNode

public void setIdAttributeNode(int elemIndex,
                               int attrIndex)
Adds an attribute node to the specified element.

setInputEncoding

public void setInputEncoding(int currentEntityDecl,
                             String value)
DOM Internal An attribute specifying the actual encoding of this document. This is null otherwise.
This attribute represents the property [character encoding scheme] defined in .

setInternalSubset

public void setInternalSubset(int doctypeIndex,
                              String subset)

synchronizeChildren

protected void synchronizeChildren()
Synchronizes the node's children with the internal structure. Fluffing the children at once solves a lot of work to keep the two structures in sync. The problem gets worse when editing the tree -- this makes it a lot easier.
Overrides:
synchronizeChildren in interface ParentNode

synchronizeChildren

protected final void synchronizeChildren(AttrImpl a,
                                         int nodeIndex)
Synchronizes the node's children with the internal structure. Fluffing the children at once solves a lot of work to keep the two structures in sync. The problem gets worse when editing the tree -- this makes it a lot easier. This is not directly used in this class but this method is here so that it can be shared by all deferred subclasses of AttrImpl.

synchronizeChildren

protected final void synchronizeChildren(ParentNode p,
                                         int nodeIndex)
Synchronizes the node's children with the internal structure. Fluffing the children at once solves a lot of work to keep the two structures in sync. The problem gets worse when editing the tree -- this makes it a lot easier. This is not directly used in this class but this method is here so that it can be shared by all deferred subclasses of ParentNode.

synchronizeData

protected void synchronizeData()
Synchronizes the node's data.
Overrides:
synchronizeData in interface NodeImpl

Copyright B) 1999-2006 The Apache Software Foundation. All Rights Reserved.