com.sun.xml.bind.serializer

Class NamespaceContextImpl

java.lang.Object

com.sun.xml.bind.serializer.NamespaceContextImpl

All Implemented Interfaces:

NamespaceContext2, NamespaceContext

Deprecated.

in JAXB1.0.1

public class NamespaceContextImpl
extends Object
implements NamespaceContext2

Implementation of the NamespaceContext2. This class also provides several utility methods for XMLSerializer-derived classes. The startElement method and the endElement method need to be called appropriately when used. See javadoc for those methods for details.

Since:

JAXB1.0

Constructor Summary

Constructors

Constructor and Description
NamespaceContextImpl() Deprecated.

Method Summary

Methods

Modifier and Type	Method and Description
String	declareNamespace(String namespaceUri, boolean requirePrefix) Deprecated. Declares a new namespace binding within the current context.
void	endElement() Deprecated. Ends the current element context and gets back to the parent context.
String	getNamespaceURI(String prefix) Deprecated. Obtains the namespace URI currently associated to the given prefix.
String	getPrefix(String namespaceUri) Deprecated.
Iterator	getPrefixes(String namespaceUri) Deprecated.
void	iterateDeclaredPrefixes(PrefixCallback callback) Deprecated. Iterates all newly declared namespace prefixes for this element.
void	startElement() Deprecated. Sets the current bindings aside and starts a new element context.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

NamespaceContextImpl

public NamespaceContextImpl()

Deprecated.

Method Detail

declareNamespace

public String declareNamespace(String namespaceUri,
                      boolean requirePrefix)

Deprecated.

Description copied from interface: NamespaceContext2

Declares a new namespace binding within the current context.

The prefix is automatically assigned by MarshallingContext. If a given namespace URI is already declared, nothing happens.

It is NOT an error to declare the same namespace URI more than once.

For marshalling to work correctly, all namespace bindings for an element must be declared between its startElement method and its endAttributes event. Calling the same method with the same parameter between the endAttributes and the endElement returns the same prefix.

Specified by:

declareNamespace in interface NamespaceContext2

requirePrefix - If this parameter is true, this method must assign a prefix to this namespace, even if it's already bound to the default namespace. IOW, this method will never return null if this flag is true. This functionality is necessary to declare namespace URI used for attribute names.

Returns:

returns the assigned prefix. If the namespace is bound to the default namespace, null is returned.

getPrefix

public String getPrefix(String namespaceUri)

Deprecated.

Specified by:

getPrefix in interface NamespaceContext

getNamespaceURI

public String getNamespaceURI(String prefix)

Deprecated.

Obtains the namespace URI currently associated to the given prefix. If no namespace URI is associated, return null.

Specified by:

getNamespaceURI in interface NamespaceContext

getPrefixes

public Iterator getPrefixes(String namespaceUri)

Deprecated.

Specified by:

getPrefixes in interface NamespaceContext

startElement

public void startElement()

Deprecated.

Sets the current bindings aside and starts a new element context. This method should be called at the beginning of the startElement method of the Serializer implementation.

endElement

public void endElement()

Deprecated.

Ends the current element context and gets back to the parent context. This method should be called at the end of the endElement method of derived classes.

iterateDeclaredPrefixes

public void iterateDeclaredPrefixes(PrefixCallback callback)
                             throws SAXException

Deprecated.

Iterates all newly declared namespace prefixes for this element.

Throws:

SAXException