| 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.
Parameters:
requirePrefix - If this parameter is true, this method must assign a prefixto this namespace, even if it's already bound to the defaultnamespace. IOW, this method will never return null if thisflag is true. This functionality is necessary to declarenamespace URI used for attribute names.
Parameters:
preferedPrefix - If the caller has any particular preference to theprefix, pass that as a parameter. The callee will tryto honor it. Set null if there's no particular preference.returns the assigned prefix. If the namespace is bound tothe default namespace, null is returned. |