com.helger.commons.jaxb

Class JAXBNamespacePrefixMapperOracleRT

java.lang.Object

com.sun.xml.internal.bind.marshaller.NamespacePrefixMapper

com.helger.commons.jaxb.JAXBNamespacePrefixMapperOracleRT

public class JAXBNamespacePrefixMapperOracleRT
extends NamespacePrefixMapper

A special namespace prefix mapper for the Oracle runtime JAXB2 implementation.
Important note: this class works only, if the com.sun.xml.bind:jaxb-impl artifact is NOT in your classpath, because this class extends com.sun.xml.internal.bind.marshaller.NamespacePrefixMapper which is not available in the external JAXB, where the class is called com.sun.xml.bind.marshaller.NamespacePrefixMapper

Author:

Philip Helger

Constructor Summary

Constructors

Constructor and Description
JAXBNamespacePrefixMapperOracleRT(NamespaceContext aNC)

Method Summary

Methods

Modifier and Type	Method and Description
String	getPreferredPrefix(String sNamespaceUri, String sSuggestion, boolean bRequirePrefix) Returns a preferred prefix for the given namespace URI.

Methods inherited from class com.sun.xml.internal.bind.marshaller.NamespacePrefixMapper

getContextualNamespaceDecls, getPreDeclaredNamespaceUris, getPreDeclaredNamespaceUris2

Methods inherited from class java.lang.Object

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

Constructor Detail

JAXBNamespacePrefixMapperOracleRT

public JAXBNamespacePrefixMapperOracleRT(@Nonnull
                                 NamespaceContext aNC)

Method Detail

getPreferredPrefix

@Nullable
public String getPreferredPrefix(@Nonnull
                                 String sNamespaceUri,
                                 @Nullable
                                 String sSuggestion,
                                 boolean bRequirePrefix)

Description copied from class: NamespacePrefixMapper

Returns a preferred prefix for the given namespace URI. This method is intended to be overrided by a derived class.

As noted in the return value portion of the javadoc, there are several cases where the preference cannot be honored. Specifically, as of JAXB RI 2.0 and onward:

1. If the prefix returned is already in use as one of the in-scope namespace bindings. This is partly necessary for correctness (so that we don't unexpectedly change the meaning of QNames bound to String), partly to simplify the marshaller.
2. If the prefix returned is "" yet the current JAXBContext includes classes that use the empty namespace URI. This allows the JAXB RI to reserve the "" prefix for the empty namespace URI, which is the only possible prefix for the URI. This restriction is also to simplify the marshaller.

Specified by:

getPreferredPrefix in class NamespacePrefixMapper

Parameters:

sNamespaceUri - The namespace URI for which the prefix needs to be found. Never be null. "" is used to denote the default namespace.

sSuggestion - When the content tree has a suggestion for the prefix to the given namespaceUri, that suggestion is passed as a parameter. Typicall this value comes from the QName.getPrefix to show the preference of the content tree. This parameter may be null, and this parameter may represent an already occupied prefix.

bRequirePrefix - If this method is expected to return non-empty prefix. When this flag is true, it means that the given namespace URI cannot be set as the default namespace.

Returns:

null if there's no prefered prefix for the namespace URI. In this case, the system will generate a prefix for you. Otherwise the system will try to use the returned prefix, but generally there's no guarantee if the prefix will be actually used or not. return "" to map this namespace URI to the default namespace. Again, there's no guarantee that this preference will be honored. If this method returns "" when requirePrefix=true, the return value will be ignored and the system will generate one.