org.openxml.dom

Interface ElementFactory

Deprecated.

Alternative API will be introduced in OpenXML 1.1

@Deprecated
public interface ElementFactory

Defines an element factory for constructing new elements. An application document may elect to use this factory to create user elements derived from the class ElementImpl.

The createElement(org.w3c.dom.Document, java.lang.String, java.lang.String) will be called to create any element and may behave in one of three manners:

• Create and return a new element from a class that extends ElementImpl
• Return null and a standard element will be created
• Throw an exception to indicate that elements of this type are not supported in this document (this behavior is highly discouraged)

Author:

Assaf Arkin

See Also:

ElementImpl

Method Summary

Modifier and Type	Method and Description
Element	createElement(Document owner, String namespaceURI, String qualifiedName) Deprecated. Called to create an element with the specified tag name.

Method Detail

createElement

Element createElement(Document owner,
                      String namespaceURI,
                      String qualifiedName)

Deprecated.

Called to create an element with the specified tag name. Returned element is of class derived from Element. If null is returned, an element of type Element will be created.

When creating a new element, the parameters owner and tagName must be passed as is to the Element constructor.

Parameters:

owner - The owner document

namespaceURI - The namespace URI if specified, or null

qualifiedName - The qualified element tag name

Returns:

New element or null