Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance. Project price only 1 $
You can buy this project and download/modify it how often you want.
/**
* Copyright (C) 2006-2014 phloc systems
* http://www.phloc.com
* office[at]phloc[dot]com
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.phloc.commons.jaxb;
import java.nio.charset.Charset;
import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import javax.annotation.concurrent.Immutable;
import javax.xml.bind.Marshaller;
import javax.xml.bind.PropertyException;
/**
* This class contains utility methods for JAXB {@link Marshaller} objects. It
* allows for setting type-safe properties.
*
* @author Philip Helger
*/
@Immutable
public final class JAXBMarshallerUtils
{
private static final String JAXB_EXTERNAL_CLASS_NAME = "com.sun.xml.bind.v2.runtime.MarshallerImpl";
private static final String JAXB_INTERNAL_CLASS_NAME = "com.sun.xml.internal.bind.v2.runtime.MarshallerImpl";
// Sun specific property name (ripped from
// com.sun.xml.bind.v2.runtime.MarshallerImpl)
private static final String SUN_INDENT_STRING = "com.sun.xml.bind.indentString";
private static final String SUN_PREFIX_MAPPER = "com.sun.xml.bind.namespacePrefixMapper";
private static final String SUN_ENCODING_HANDLER2 = "com.sun.xml.bind.marshaller.CharacterEscapeHandler";
private static final String SUN_XML_HEADERS = "com.sun.xml.bind.xmlHeaders";
private static final String SUN_C14N = "com.sun.xml.bind.c14n";
private static final String SUN_OBJECT_IDENTITY_CYCLE_DETECTION = "com.sun.xml.bind.objectIdentitityCycleDetection";
private JAXBMarshallerUtils ()
{}
private static void _setProperty (@Nonnull final Marshaller aMarshaller,
@Nonnull final String sPropertyName,
@Nullable final Object aValue)
{
try
{
aMarshaller.setProperty (sPropertyName, aValue);
}
catch (final PropertyException ex)
{
throw new IllegalArgumentException ("Failed to set JAXB property '" + sPropertyName + "' to " + aValue, ex);
}
}
@Nullable
private static Object _getProperty (@Nonnull final Marshaller aMarshaller, @Nonnull final String sPropertyName)
{
try
{
return aMarshaller.getProperty (sPropertyName);
}
catch (final PropertyException ex)
{
throw new IllegalArgumentException ("Failed to get JAXB property '" + sPropertyName + "'", ex);
}
}
private static boolean _getBooleanProperty (@Nonnull final Marshaller aMarshaller, @Nonnull final String sPropertyName)
{
return ((Boolean) _getProperty (aMarshaller, sPropertyName)).booleanValue ();
}
private static String _getStringProperty (@Nonnull final Marshaller aMarshaller, @Nonnull final String sPropertyName)
{
return (String) _getProperty (aMarshaller, sPropertyName);
}
/**
* Set the standard property for the encoding charset.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param aEncoding
* the value to be set
*/
public static void setEncoding (@Nonnull final Marshaller aMarshaller, @Nullable final Charset aEncoding)
{
setEncoding (aMarshaller, aEncoding == null ? null : aEncoding.name ());
}
/**
* Set the standard property for the encoding charset.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param sEncoding
* the value to be set
*/
public static void setEncoding (@Nonnull final Marshaller aMarshaller, @Nullable final String sEncoding)
{
_setProperty (aMarshaller, Marshaller.JAXB_ENCODING, sEncoding);
}
public static String getEncoding (@Nonnull final Marshaller aMarshaller)
{
return _getStringProperty (aMarshaller, Marshaller.JAXB_ENCODING);
}
/**
* Set the standard property for formatting the output or not.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param bFormattedOutput
* the value to be set
*/
public static void setFormattedOutput (@Nonnull final Marshaller aMarshaller, final boolean bFormattedOutput)
{
_setProperty (aMarshaller, Marshaller.JAXB_FORMATTED_OUTPUT, Boolean.valueOf (bFormattedOutput));
}
public static boolean isFormattedOutput (@Nonnull final Marshaller aMarshaller)
{
return _getBooleanProperty (aMarshaller, Marshaller.JAXB_FORMATTED_OUTPUT);
}
/**
* Set the standard property for setting the namespace schema location
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param sSchemaLocation
* the value to be set
*/
public static void setSchemaLocation (@Nonnull final Marshaller aMarshaller, @Nullable final String sSchemaLocation)
{
_setProperty (aMarshaller, Marshaller.JAXB_SCHEMA_LOCATION, sSchemaLocation);
}
public static String getSchemaLocation (@Nonnull final Marshaller aMarshaller)
{
return _getStringProperty (aMarshaller, Marshaller.JAXB_SCHEMA_LOCATION);
}
/**
* Set the standard property for setting the no-namespace schema location
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param sSchemaLocation
* the value to be set
*/
public static void setNoNamespaceSchemaLocation (@Nonnull final Marshaller aMarshaller,
@Nullable final String sSchemaLocation)
{
_setProperty (aMarshaller, Marshaller.JAXB_NO_NAMESPACE_SCHEMA_LOCATION, sSchemaLocation);
}
public static String getNoNamespaceSchemaLocation (@Nonnull final Marshaller aMarshaller)
{
return _getStringProperty (aMarshaller, Marshaller.JAXB_NO_NAMESPACE_SCHEMA_LOCATION);
}
/**
* Set the standard property for marshalling a fragment only.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param bFragment
* the value to be set
*/
public static void setFragment (@Nonnull final Marshaller aMarshaller, final boolean bFragment)
{
_setProperty (aMarshaller, Marshaller.JAXB_FRAGMENT, Boolean.valueOf (bFragment));
}
public static boolean isFragment (@Nonnull final Marshaller aMarshaller)
{
return _getBooleanProperty (aMarshaller, Marshaller.JAXB_FRAGMENT);
}
/**
* Set the Sun specific property for the indent string.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param sIndentString
* the value to be set
*/
public static void setSunIndentString (@Nonnull final Marshaller aMarshaller, @Nullable final String sIndentString)
{
_setProperty (aMarshaller, SUN_INDENT_STRING, sIndentString);
}
public static String getSunIndentString (@Nonnull final Marshaller aMarshaller)
{
return _getStringProperty (aMarshaller, SUN_INDENT_STRING);
}
/**
* Set the Sun specific encoding handler. Value must implement
* com.sun.xml.bind.marshaller.CharacterEscapeHandler
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param aCharacterEscapeHandler
* the value to be set
*/
public static void setSunCharacterEscapeHandler (@Nonnull final Marshaller aMarshaller,
@Nonnull final Object aCharacterEscapeHandler)
{
_setProperty (aMarshaller, SUN_ENCODING_HANDLER2, aCharacterEscapeHandler);
}
public static Object getSunCharacterEscapeHandler (@Nonnull final Marshaller aMarshaller)
{
return _getProperty (aMarshaller, SUN_ENCODING_HANDLER2);
}
/**
* Set the Sun specific namespace prefix mapper. Value must implement either
* com.sun.xml.bind.marshaller.NamespacePrefixMapper or
* com.sun.xml.internal.bind.marshaller.NamespacePrefixMapper depending on the
* implementation type of Marshaller.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param aNamespacePrefixMapper
* the value to be set
* @see #isExternalSunJAXB2Marshaller(Marshaller)
* @see #isInternalSunJAXB2Marshaller(Marshaller)
*/
public static void setSunNamespacePrefixMapper (@Nonnull final Marshaller aMarshaller,
@Nonnull final Object aNamespacePrefixMapper)
{
_setProperty (aMarshaller, SUN_PREFIX_MAPPER, aNamespacePrefixMapper);
}
public static Object getSunNamespacePrefixMapper (@Nonnull final Marshaller aMarshaller)
{
return _getProperty (aMarshaller, SUN_PREFIX_MAPPER);
}
/**
* Set the Sun specific XML header string.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param sXMLHeaders
* the value to be set
*/
public static void setSunXMLHeaders (@Nonnull final Marshaller aMarshaller, @Nonnull final String sXMLHeaders)
{
_setProperty (aMarshaller, SUN_XML_HEADERS, sXMLHeaders);
}
public static String getSunXMLHeaders (@Nonnull final Marshaller aMarshaller)
{
return _getStringProperty (aMarshaller, SUN_XML_HEADERS);
}
/**
* Set the Sun specific canonicalization property.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param bCanonicalize
* the value to be set
*/
public static void setSunCanonicalization (@Nonnull final Marshaller aMarshaller, final boolean bCanonicalize)
{
_setProperty (aMarshaller, SUN_C14N, Boolean.valueOf (bCanonicalize));
}
public static boolean isSunCanonicalization (@Nonnull final Marshaller aMarshaller)
{
return _getBooleanProperty (aMarshaller, SUN_C14N);
}
/**
* Set the Sun specific canonicalization property.
*
* @param aMarshaller
* The marshaller to set the property. May not be null.
* @param bObjectIdentityCycleDetection
* the value to be set
*/
public static void setSunObjectIdentityCycleDetection (@Nonnull final Marshaller aMarshaller,
final boolean bObjectIdentityCycleDetection)
{
_setProperty (aMarshaller, SUN_OBJECT_IDENTITY_CYCLE_DETECTION, Boolean.valueOf (bObjectIdentityCycleDetection));
}
public static boolean isSunObjectIdentityCycleDetection (@Nonnull final Marshaller aMarshaller)
{
return _getBooleanProperty (aMarshaller, SUN_OBJECT_IDENTITY_CYCLE_DETECTION);
}
/**
* Check if the passed Marshaller is a Sun JAXB v2 marshaller. Use this method
* to determined, whether the Sun specific methods may be invoked or not.
*
* @param aMarshaller
* The marshaller to be checked. May be null.
* @return true if the passed marshaller is not null
* and is of the Sun class.
*/
public static boolean isSunJAXB2Marshaller (@Nullable final Marshaller aMarshaller)
{
if (aMarshaller == null)
return false;
final String sClassName = aMarshaller.getClass ().getName ();
// When using jaxb-impl explicitly
return sClassName.equals (JAXB_EXTERNAL_CLASS_NAME) ||
// When using the JAXB version integrated in the runtime
sClassName.equals (JAXB_INTERNAL_CLASS_NAME);
}
/**
* Check if the passed marshaller is external to the one contained in the
* runtime.
*
* @param aMarshaller
* The marshaller to check. May be null.
* @return true if it is a JAXB marshaller from an external
* package (e.g. by having jaxb-impl in the dependencies)
*/
public static boolean isExternalSunJAXB2Marshaller (@Nullable final Marshaller aMarshaller)
{
return aMarshaller != null && aMarshaller.getClass ().getName ().equals (JAXB_EXTERNAL_CLASS_NAME);
}
/**
* Check if the passed marshaller is an internal one contained in the runtime.
*
* @param aMarshaller
* The marshaller to check. May be null.
* @return true if it is a JAXB marshaller from the runtime
* library package
*/
public static boolean isInternalSunJAXB2Marshaller (@Nullable final Marshaller aMarshaller)
{
return aMarshaller != null && aMarshaller.getClass ().getName ().equals (JAXB_INTERNAL_CLASS_NAME);
}
}
