Xalan-C++ API Documentation

The Xalan C++ XSLT Processor Version 1.11


XercesAttrBridge.hpp
Go to the documentation of this file.
1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one
3  * or more contributor license agreements. See the NOTICE file
4  * distributed with this work for additional information
5  * regarding copyright ownership. The ASF licenses this file
6  * to you under the Apache License, Version 2.0 (the "License");
7  * you may not use this file except in compliance with the License.
8  * You may obtain a copy of the License at
9  *
10  * http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing, software
13  * distributed under the License is distributed on an "AS IS" BASIS,
14  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15  * See the License for the specific language governing permissions and
16  * limitations under the License.
17  */
18 #if !defined(XERCESATTRBRIDGE_HEADER_GUARD_1357924680)
19 #define XERCESATTRBRIDGE_HEADER_GUARD_1357924680
20 
21 
22 
24 
25 
26 
27 #if XERCES_VERSION_MAJOR >= 2
28 #include <xercesc/dom/deprecated/DOM_Attr.hpp>
29 #else
30 #include <xercesc/dom/DOM_Attr.hpp>
31 #endif
32 
33 
34 
36 
37 
38 
41 
42 
43 
44 XALAN_CPP_NAMESPACE_BEGIN
45 
46 
47 
49 class XalanElement;
50 
51 
52 /**
53  * This class is deprecated.
54  *
55  * @deprecated This class is part of the deprecated Xerces DOM bridge.
56  */
58 {
59 public:
60 
62  const DOM_AttrType& theXercesAttr,
63  const XercesBridgeNavigator& theNavigator);
64 
65  virtual
67 
68 
69  // These interfaces are inherited from XalanNode...
70  virtual const XalanDOMString&
71  getNodeName() const;
72 
73  /**
74  * Gets the value of this node, depending on its type.
75  */
76  virtual const XalanDOMString&
77  getNodeValue() const;
78 
79  /**
80  * An enum value representing the type of the underlying object.
81  */
82  virtual NodeType
83  getNodeType() const;
84 
85  /**
86  * Gets the parent of this node.
87  *
88  * All nodes, except <code>Document</code>,
89  * <code>DocumentFragment</code>, and <code>Attr</code> may have a parent.
90  * However, if a node has just been created and not yet added to the tree,
91  * or if it has been removed from the tree, a <code>null</code> DOM_Node
92  * is returned.
93  */
94  virtual XalanNode*
95  getParentNode() const;
96 
97  /**
98  * Gets a <code>NodeList</code> that contains all children of this node.
99  *
100  * If there
101  * are no children, this is a <code>NodeList</code> containing no nodes.
102  * The content of the returned <code>NodeList</code> is "live" in the sense
103  * that, for instance, changes to the children of the node object that
104  * it was created from are immediately reflected in the nodes returned by
105  * the <code>NodeList</code> accessors; it is not a static snapshot of the
106  * content of the node. This is true for every <code>NodeList</code>,
107  * including the ones returned by the <code>getElementsByTagName</code>
108  * method.
109  */
110  virtual const XalanNodeList*
111  getChildNodes() const;
112 
113  /**
114  * Gets the first child of this node.
115  *
116  * If there is no such node, this returns <code>null</code>.
117  */
118  virtual XalanNode*
119  getFirstChild() const;
120 
121  /**
122  * Gets the last child of this node.
123  *
124  * If there is no such node, this returns <code>null</code>.
125  */
126  virtual XalanNode*
127  getLastChild() const;
128 
129  /**
130  * Gets the node immediately preceding this node.
131  *
132  * If there is no such node, this returns <code>null</code>.
133  */
134  virtual XalanNode*
135  getPreviousSibling() const;
136 
137  /**
138  * Gets the node immediately following this node.
139  *
140  * If there is no such node, this returns <code>null</code>.
141  */
142  virtual XalanNode*
143  getNextSibling() const;
144 
145  /**
146  * Gets a <code>NamedNodeMap</code> containing the attributes of this node (if it
147  * is an <code>Element</code>) or <code>null</code> otherwise.
148  */
149  virtual const XalanNamedNodeMap*
150  getAttributes() const;
151 
152  /**
153  * Gets the <code>DOM_Document</code> object associated with this node.
154  *
155  * This is also
156  * the <code>DOM_Document</code> object used to create new nodes. When this
157  * node is a <code>DOM_Document</code> or a <code>DOM_DocumentType</code>
158  * which is not used with any <code>DOM_Document</code> yet, this is
159  * <code>null</code>.
160  */
161  virtual XalanDocument*
162  getOwnerDocument() const;
163 
164  //@}
165  /** @name Cloning function. */
166  //@{
167 
168  /**
169  * Returns a duplicate of this node.
170  *
171  * This function serves as a generic copy constructor for nodes.
172  *
173  * The duplicate node has no parent (
174  * <code>parentNode</code> returns <code>null</code>.).
175  * <br>Cloning an <code>Element</code> copies all attributes and their
176  * values, including those generated by the XML processor to represent
177  * defaulted attributes, but this method does not copy any text it contains
178  * unless it is a deep clone, since the text is contained in a child
179  * <code>Text</code> node. Cloning any other type of node simply returns a
180  * copy of this node.
181  * @param deep If <code>true</code>, recursively clone the subtree under the
182  * specified node; if <code>false</code>, clone only the node itself (and
183  * its attributes, if it is an <code>Element</code>).
184  * @return The duplicate node.
185  */
186 #if defined(XALAN_NO_COVARIANT_RETURN_TYPE)
187  virtual XalanNode*
188 #else
189  virtual XercesAttrBridge*
190 #endif
191  cloneNode(bool deep) const;
192 
193  //@}
194  /** @name Functions to modify the DOM Node. */
195  //@{
196 
197  /**
198  * Inserts the node <code>newChild</code> before the existing child node
199  * <code>refChild</code>.
200  *
201  * If <code>refChild</code> is <code>null</code>,
202  * insert <code>newChild</code> at the end of the list of children.
203  * <br>If <code>newChild</code> is a <code>DocumentFragment</code> object,
204  * all of its children are inserted, in the same order, before
205  * <code>refChild</code>. If the <code>newChild</code> is already in the
206  * tree, it is first removed. Note that a <code>DOM_Node</code> that
207  * has never been assigned to refer to an actual node is == null.
208  * @param newChild The node to insert.
209  * @param refChild The reference node, i.e., the node before which the new
210  * node must be inserted.
211  * @return The node being inserted.
212  */
213  virtual XalanNode*
214  insertBefore(
215  XalanNode* newChild,
216  XalanNode* refChild);
217 
218  /**
219  * Replaces the child node <code>oldChild</code> with <code>newChild</code>
220  * in the list of children, and returns the <code>oldChild</code> node.
221  *
222  * If <CODE>newChild</CODE> is a <CODE>DOM_DocumentFragment</CODE> object,
223  * <CODE>oldChild</CODE> is replaced by all of the <CODE>DOM_DocumentFragment</CODE>
224  * children, which are inserted in the same order.
225  *
226  * If the <code>newChild</code> is already in the tree, it is first removed.
227  * @param newChild The new node to put in the child list.
228  * @param oldChild The node being replaced in the list.
229  * @return The node replaced.
230  */
231  virtual XalanNode*
232  replaceChild(
233  XalanNode* newChild,
234  XalanNode* oldChild);
235 
236  /**
237  * Removes the child node indicated by <code>oldChild</code> from the list
238  * of children, and returns it.
239  *
240  * @param oldChild The node being removed.
241  * @return The node removed.
242  */
243  virtual XalanNode*
244  removeChild(XalanNode* oldChild);
245 
246  /**
247  * Adds the node <code>newChild</code> to the end of the list of children of
248  * this node.
249  *
250  * If the <code>newChild</code> is already in the tree, it is
251  * first removed.
252  * @param newChild The node to add.If it is a <code>DocumentFragment</code>
253  * object, the entire contents of the document fragment are moved into
254  * the child list of this node
255  * @return The node added.
256  */
257  virtual XalanNode*
258  appendChild(XalanNode* newChild);
259 
260  //@}
261  /** @name Query functions. */
262  //@{
263 
264  /**
265  * This is a convenience method to allow easy determination of whether a
266  * node has any children.
267  *
268  * @return <code>true</code> if the node has any children,
269  * <code>false</code> if the node has no children.
270  */
271  virtual bool
272  hasChildNodes() const;
273 
274 
275  //@}
276  /** @name Set functions. */
277  //@{
278 
279 
280  /**
281  * Sets the value of the node.
282  *
283  * Any node which can have a nodeValue (@see getNodeValue) will
284  * also accept requests to set it to a string. The exact response to
285  * this varies from node to node -- Attribute, for example, stores
286  * its values in its children and has to replace them with a new Text
287  * holding the replacement value.
288  *
289  * For most types of Node, value is null and attempting to set it
290  * will throw DOMException(NO_MODIFICATION_ALLOWED_ERR). This will
291  * also be thrown if the node is read-only.
292  */
293  virtual void
294  setNodeValue(const XalanDOMString& nodeValue);
295 
296  //@}
297  /** @name Functions introduced in DOM Level 2. */
298  //@{
299 
300  /**
301  * Puts all <CODE>DOM_Text</CODE>
302  * nodes in the full depth of the sub-tree underneath this <CODE>DOM_Node</CODE>,
303  * including attribute nodes, into a "normal" form where only markup (e.g.,
304  * tags, comments, processing instructions, CDATA sections, and entity
305  * references) separates <CODE>DOM_Text</CODE>
306  * nodes, i.e., there are no adjacent <CODE>DOM_Text</CODE>
307  * nodes. This can be used to ensure that the DOM view of a document is the
308  * same as if it were saved and re-loaded, and is useful when operations
309  * (such as XPointer lookups) that depend on a particular document tree
310  * structure are to be used.
311  * <P><B>Note:</B> In cases where the document contains <CODE>DOM_CDATASections</CODE>,
312  * the normalize operation alone may not be sufficient, since XPointers do
313  * not differentiate between <CODE>DOM_Text</CODE>
314  * nodes and <CODE>DOM_CDATASection</CODE> nodes.</P>
315  */
316  virtual void
317  normalize();
318 
319  /**
320  * Tests whether the DOM implementation implements a specific
321  * feature and that feature is supported by this node.
322  * @param feature The string of the feature to test. This is the same
323  * name as what can be passed to the method <code>hasFeature</code> on
324  * <code>DOMImplementation</code>.
325  * @param version This is the version number of the feature to test. In
326  * Level 2, version 1, this is the string "2.0". If the version is not
327  * specified, supporting any version of the feature will cause the
328  * method to return <code>true</code>.
329  * @return Returns <code>true</code> if the specified feature is supported
330  * on this node, <code>false</code> otherwise.
331  */
332  virtual bool
333  isSupported(
334  const XalanDOMString& feature,
335  const XalanDOMString& version) const;
336 
337  /**
338  * Get the <em>namespace URI</em> of
339  * this node, or <code>null</code> if it is unspecified.
340  * <p>
341  * This is not a computed value that is the result of a namespace lookup
342  * based on an examination of the namespace declarations in scope. It is
343  * merely the namespace URI given at creation time.
344  * <p>
345  * For nodes of any type other than <CODE>ELEMENT_NODE</CODE> and
346  * <CODE>ATTRIBUTE_NODE</CODE> and nodes created with a DOM Level 1 method,
347  * such as <CODE>createElement</CODE> from the <CODE>Document</CODE>
348  * interface, this is always <CODE>null</CODE>.
349  */
350  virtual const XalanDOMString&
351  getNamespaceURI() const;
352 
353  /**
354  * Get the <em>namespace prefix</em>
355  * of this node, or <code>null</code> if it is unspecified.
356  */
357  virtual const XalanDOMString&
358  getPrefix() const;
359 
360  /**
361  * Returns the local part of the <em>qualified name</em> of this node.
362  * <p>
363  * For nodes created with a DOM Level 1 method, such as
364  * <code>createElement</code> from the <code>DOM_Document</code> interface,
365  * it is null.
366  */
367  virtual const XalanDOMString&
368  getLocalName() const;
369 
370  /**
371  * Set the <em>namespace prefix</em> of this node.
372  * <p>
373  * Note that setting this attribute, when permitted, changes
374  * the <CODE>nodeName</CODE> attribute, which holds the <EM>qualified
375  * name</EM>, as well as the <CODE>tagName</CODE> and <CODE>name</CODE>
376  * attributes of the <CODE>DOM_Element</CODE> and <CODE>DOM_Attr</CODE>
377  * interfaces, when applicable.
378  * <p>
379  * Note also that changing the prefix of an
380  * attribute, that is known to have a default value, does not make a new
381  * attribute with the default value and the original prefix appear, since the
382  * <CODE>namespaceURI</CODE> and <CODE>localName</CODE> do not change.
383  *
384  * @param prefix The prefix of this node.
385  * @exception DOMException
386  * INVALID_CHARACTER_ERR: Raised if the specified prefix contains
387  * an illegal character.
388  * <br>
389  * NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
390  * <br>
391  * NAMESPACE_ERR: Raised if the specified <CODE>prefix</CODE> is
392  * malformed, if the specified prefix is "xml" and the
393  * <CODE>namespaceURI</CODE> of this node is different from
394  * "http://www.w3.org/XML/1998/namespace", if specified prefix is
395  * "xmlns" and the <CODE>namespaceURI</CODE> is neither
396  * <CODE>null</CODE> nor an empty string, or if the
397  * <CODE>localName</CODE> is <CODE>null</CODE>.
398  */
399  virtual void
400  setPrefix(const XalanDOMString& prefix);
401 
402  virtual bool
403  isIndexed() const;
404 
405  virtual IndexType
406  getIndex() const;
407 
408  //@}
409 
410  // These interfaces are inherited from XalanAttr...
411 
412  /** @name Getter functions */
413  //@{
414  /**
415 
416  * Returns the name of this attribute.
417  */
418  virtual const XalanDOMString&
419  getName() const;
420 
421  /**
422  *
423  * Returns true if the attribute received its value explicitly in the
424  * XML document, or if a value was assigned programatically with
425  * the setValue function. Returns false if the attribute value
426  * came from the default value declared in the document's DTD.
427  */
428  virtual bool
429  getSpecified() const;
430 
431  /**
432  * Returns the value of the attribute.
433  *
434  * The value of the attribute is returned as a string.
435  * Character and general entity references are replaced with their values.
436  */
437  virtual const XalanDOMString&
438  getValue() const;
439 
440  //@}
441  /** @name Setter functions */
442  //@{
443 
444  /**
445  * Sets the value of the attribute. A text node with the unparsed contents
446  * of the string will be created.
447  *
448  * @param value The value of the DOM attribute to be set
449  */
450  virtual void
451  setValue(const XalanDOMString& value);
452 
453  //@}
454 
455  /** @name Functions introduced in DOM Level 2. */
456  //@{
457  /**
458  * The <code>Element</code> node this attribute is attached to or
459  * <code>null</code> if this attribute is not in use.
460  */
461  virtual XalanElement*
462  getOwnerElement() const;
463  //@}
464 
465  /**
466  * Get the Xerces node this instance represent.
467  *
468  * @return The Xerces node
469  */
472  {
473  return m_xercesNode;
474  }
475 
476 private:
477 
478  // Not implemented...
479  XercesAttrBridge(const XercesAttrBridge& theSource);
480 
482  operator=(const XercesAttrBridge& theSource);
483 
484  bool
485  operator==(const XercesAttrBridge& theRHS) const;
486 
487  // Data members...
488  DOM_AttrType m_xercesNode;
489 
490  XercesNodeListBridge m_children;
491 
492  const XercesBridgeNavigator& m_navigator;
493 };
494 
495 
496 
497 XALAN_CPP_NAMESPACE_END
498 
499 
500 
501 #endif // !defined(XERCESATTRBRIDGE_HEADER_GUARD_1357924680)
virtual bool isIndexed() const =0
Determine if the document is node-order indexed.
virtual const XalanNamedNodeMap * getAttributes() const =0
Gets a XalanNamedNodeMap containing the attributes of this node (if it is an XalanElement) or a null ...
XALAN_CPP_NAMESPACE_BEGIN typedef XERCES_CPP_NAMESPACE_QUALIFIER DOM_Attr DOM_AttrType
#define XALAN_XERCESPARSERLIAISON_EXPORT
virtual const XalanDOMString & getName() const =0
Returns the name of this attribute.
virtual const XalanDOMString & getNamespaceURI() const =0
Get the namespace URI of this node.
virtual const XalanDOMString & getNodeValue() const =0
Gets the value of this node, depending on its type.
virtual XalanNode * getNextSibling() const =0
Gets the node immediately following this node.
virtual XalanElement * getOwnerElement() const =0
The XalanElement node this attribute is attached to.
virtual XalanNode * getLastChild() const =0
Gets the last child of this node.
virtual const XalanDOMString & getPrefix() const =0
Get the namespace prefix of this node.
This class is deprecated.
This class is deprecated.
virtual const XalanDOMString & getValue() const =0
Returns the value of the attribute.
virtual NodeType getNodeType() const =0
An enum value representing the type of the underlying object.
virtual IndexType getIndex() const =0
Get the node&#39;s index.
virtual const XalanDOMString & getNodeName() const =0
Gets the name of this node, depending on its type.
virtual XalanNode * getParentNode() const =0
Gets the parent of this node.
virtual XalanNode * getFirstChild() const =0
Gets the first child of this node.
virtual const XalanNodeList * getChildNodes() const =0
Gets a XalanNodeList that contains all children of this node.
unsigned long IndexType
Definition: XalanNode.hpp:64
This class is deprecated.
DOM_AttrType getXercesNode() const
Get the Xerces node this instance represent.
virtual const XalanDOMString & getLocalName() const =0
Returns the local part of the qualified name of this node.
bool operator==(const XalanAttr &theRHS) const
virtual XalanDocument * getOwnerDocument() const =0
Gets the XalanDocument object associated with this node.
virtual XalanNode * getPreviousSibling() const =0
Gets the node immediately preceding this node.
XalanAttr & operator=(const XalanAttr &theSource)

Interpreting class diagrams

Doxygen and GraphViz are used to generate this API documentation from the Xalan-C header files.

Xalan-C++ XSLT Processor Version 1.11
Copyright © 1999-2012 The Apache Software Foundation.
All Rights Reserved.

Apache Logo