DOMImplRef Interface

Table 2-7 summarizes the methods available through DOMImplRef interface.

Table 2-7 Summary of DOMImplRef Methods; Dom Package

Function Summary

DOMImplRef()

Constructor.

createDocument()

Create document reference.

createDocumentType()

Create DTD reference.

formDocument()

Forms document reference given a document pointer.

getImplementation()

Get DOMImplementation object associated with the document.

getNoMod()

Get the 'no modification allowed' flag value.

hasFeature()

Determine if DOM feature is implemented.

setContext()

Set another context to a node.

~DOMImplRef()

Public default destructor.



DOMImplRef()

Class constructor.

Syntax Description
DOMImplRef(
   Context* ctx_ptr,
   DOMImplementation< Node>* impl_ptr);
Creates reference object to DOMImplementation object in a given context. Returns reference to the implementation object.
DOMImplRef(
   const DOMImplRef< Context, Node>& iref);
It is needed to create other references to the implementation object; deletion flags are not copied.
DOMImplRef(
   const DOMImplRef< Context, Node>& iref,
   Context* ctx_ptr);
It is needed to create references to the implementation object in a different context; deletion flags are not copied.

Parameter Description
ctx_ptr
context pointer
impl_ptr
implementation

Returns

(DOMImplRef) reference to the implementation object


createDocument()

Creates document reference

Syntax

DocumentRef< Node>* createDocument(
   oratext* namespaceURI,
   oratext* qualifiedName,
   DocumentTypeRef< Node>& doctype)
throw (DOMException);
Parameter Description
namespaceURI
namespace URI of root element
qualifiedName
qualified name of root element
doctype
associated DTD node

Returns

(DocumentRef< Node>*) document reference


createDocumentType()

Creates DTD reference

Syntax

DocumentTypeRef< Node>* createDocumentType(
   oratext* qualifiedName,
   oratext* publicId,
   oratext* systemId)
throw (DOMException);
Parameter Description
qualifiedName
qualified name
publicId
external subset public Id
systemId
external subset system Id

Returns

(DocumentTypeRef< Node>*) DTD reference


formDocument()

Forms a document reference given a document pointer.

Syntax

DocumentRef< Node>* formDocument( Node* node);
Parameter Description
node
pointer to the document node

Returns

(DocumentRef< Node>*) pointer to the document reference


getImplementation()

Returns DOMImplementation object that was used to create this document. When the DOMImplementation object is destructed, all document trees associated with it are also destructed.

Syntax

DOMImplementation< Node>* getImplementation() const;

Returns

(DOMImplementation) DOMImplementation reference object


getNoMod()

Get the 'no modification allowed' flag value. This is an Oracle extension.

Syntax

boolean getNoMod() const;

Returns

TRUE if flag's value is TRUE, FALSE otherwise


hasFeature()

Determine if a DOM feature is implemented. Returns TRUE if the feature is implemented in the specified version, FALSE otherwise.

In level 1, the legal values for package are 'HTML' and 'XML' (case-insensitive), and the version is the string "1.0". If the version is not specified, supporting any version of the feature will cause the method to return TRUE.

DOM 1.0 features are "XML" and "HTML".

DOM 2.0 features are "Core", "XML", "HTML", "Views", "StyleSheets", "CSS", "CSS2", "Events", "UIEvents", "MouseEvents", "MutationEvents", "HTMLEvents", "Range", "Traversal"

Syntax

boolean hasFeature(
   oratext* feature, 
   oratext* version);
Parameter Description
feature
package name of feature
version
version of package

Returns

(boolean) is feature implemented?


setContext()

It is needed to create node references in a different context

Syntax

void setContext(
   NodeRef< Node>& nref, 
   Context* ctx_ptr);
Parameter Description
nref
reference node
ctx_ptr
context pointer


~DOMImplRef()

This is the default destructor. It cleans the reference to the implementation object. It is usually called by the environment. But it can be called by the user directly if necessary.

Syntax

~DOMImplRef();