org.eclipse.persistence.jaxb

Class JAXBContextProperties

java.lang.Object

org.eclipse.persistence.jaxb.JAXBContextProperties

public class JAXBContextProperties
extends java.lang.Object

These are properties that may be passed in to create a JAXBContext:

 Map<String, Object> properties = new HashMap<String, Object>(1);
 properties.put();
 JAXBContext jc = JAXBContext.newInstance(new Class[] {Foo.class}, properties);
 

Since:

2.4.0

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ANNOTATION_HELPER The name of the property used to specify an AnnotationHelper instance.
static java.lang.String	DEFAULT_TARGET_NAMESPACE The name of the property used to specify a default target namespace.
static java.lang.String	JSON_ATTRIBUTE_PREFIX The name of the property used to specify a value that will be prepended to all keys that are mapped to an XML attribute.
static java.lang.String	JSON_INCLUDE_ROOT The name of the property used to specify in the root node should be included in the message (default is true).
static java.lang.String	JSON_NAMESPACE_SEPARATOR The name of the property used to specify the character (default is '.')
static java.lang.String	JSON_VALUE_WRAPPER The name of the property used to specify the key that will correspond to the property mapped with @XmlValue.
static java.lang.String	JSON_WRAPPER_AS_ARRAY_NAME The Constant JSON_WRAPPER_AS_ARRAY_NAME.
static java.lang.String	MEDIA_TYPE The name of the property used to specify the type of binding to be performed.
static java.lang.String	NAMESPACE_PREFIX_MAPPER The Constant NAMESPACE_PREFIX_MAPPER.
static java.lang.String	OBJECT_GRAPH The name of the property used to specify an ObjectGraph instance or name of an ObjectGraph to be used on Unmarshallers and Marshallers created by the context.
static java.lang.String	OXM_METADATA_SOURCE The name of the property used to specify one or more EclipseLink OXM metadata sources.
static java.lang.String	SESSION_EVENT_LISTENER The name of the property used to specify a SessionEventListener that can be used to customize the metadata before or after it has been initialized.
static java.lang.String	XML_ACCESSOR_FACTORY_SUPPORT The name of the boolean property used to enable custom XmlAccessorFactories.

Constructor Summary

Constructors

Constructor and Description
JAXBContextProperties()

Method Summary

Methods inherited from class java.lang.Object

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

Field Detail

JSON_ATTRIBUTE_PREFIX

public static final java.lang.String JSON_ATTRIBUTE_PREFIX

The name of the property used to specify a value that will be prepended to all keys that are mapped to an XML attribute. By default there is no attribute prefix. There is no effect when media type is "application/xml". When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this attribute prefix.

Since:

2.4

See Also:

org.eclipse.persistence.jaxb.MarshallerProperties.JSON_ATTRIBUTE_PREFIX, org.eclipse.persistence.jaxb.UnmarshallerProperties.JSON_ATTRIBUTE_PREFIX, Constant Field Values

JSON_INCLUDE_ROOT

public static final java.lang.String JSON_INCLUDE_ROOT

The name of the property used to specify in the root node should be included in the message (default is true). There is no effect when media type is "application/xml". When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this setting.

Since:

2.4

See Also:

org.eclipse.persistence.jaxb.JAXBContextProperties.JSON_INCLUDE_ROOT, org.eclipse.persistence.jaxb.UnmarshallerProperties.JSON_INCLUDE_ROOT, Constant Field Values

JSON_NAMESPACE_SEPARATOR

public static final java.lang.String JSON_NAMESPACE_SEPARATOR

The name of the property used to specify the character (default is '.') that separates the prefix from the key name. It is only used if namespace qualification has been enabled be setting a namespace prefix mapper. When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this setting.

Since:

2.4

See Also:

org.eclipse.persistence.jaxb.MarshallerProperties.NAMESPACE_SEPARATOR, org.eclipse.persistence.jaxb.UnmarshallerProperties.NAMESPACE_SEPARATOR, Constant Field Values

JSON_VALUE_WRAPPER

public static final java.lang.String JSON_VALUE_WRAPPER

The name of the property used to specify the key that will correspond to the property mapped with @XmlValue. This key will only be used if there are other mapped properties. When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this setting.

Since:

2.4

See Also:

org.eclipse.persistence.jaxb.MarshallerPropertes.JSON_VALUE_WRAPPER, org.eclipse.persistence.jaxb.UnmarshallerPropertes.JSON_VALUE_WRAPPER, Constant Field Values

MEDIA_TYPE

public static final java.lang.String MEDIA_TYPE

The name of the property used to specify the type of binding to be performed. When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this media type. Supported values are:

• MediaType.APPLICATION_XML (default)
• MediaType.APPLICATION_JSON
• "application/xml"
• "application/json"

Since:

2.4

See Also:

org.eclipse.persistence.jaxb.MarshallerProperties.MEDIA_TYPE, org.eclipse.persistence.jaxb.UnmarshallerProperties.MEDIA_TYPE, MediaType, Constant Field Values

NAMESPACE_PREFIX_MAPPER

public static final java.lang.String NAMESPACE_PREFIX_MAPPER

The Constant NAMESPACE_PREFIX_MAPPER. Provides a means to customize the namespace prefixes used while marshalling to XML. Used for both marshal and unmarshal when mediaType is set to "application/json". Value is either a Map<String, String> of URIs to prefixes, or an implementation of org.eclipse.persistence.oxm.NamespacePrefixMapper.

Since:

2.4

See Also:

NamespacePrefixMapper, Constant Field Values

SESSION_EVENT_LISTENER

public static final java.lang.String SESSION_EVENT_LISTENER

The name of the property used to specify a SessionEventListener that can be used to customize the metadata before or after it has been initialized.

Since:

2.4

See Also:

SessionEventListener, Constant Field Values

OXM_METADATA_SOURCE

public static final java.lang.String OXM_METADATA_SOURCE

The name of the property used to specify one or more EclipseLink OXM metadata sources. The metadata source can be one of the following:

• java.io.File
• java.io.InputStream
• java.io.Reader
• java.lang.String
• java.net.URL
• javax.xml.stream.XMLEventReader
• javax.xml.stream.XMLStreamReader
• javax.xml.transform.Source
• org.eclipse.persistence.jaxb.metadata.MetadataSource
• org.w3c.dom.Node
• org.xml.sax.InputSource

To specify multiple metadata sources, the following can be used:

• java.util.Map<String, Object>
• java.util.List

Since:

2.4, replaces JAXBContextFactory.ECLIPSELINK_OXM_XML_KEY

See Also:

Constant Field Values

DEFAULT_TARGET_NAMESPACE

public static final java.lang.String DEFAULT_TARGET_NAMESPACE

The name of the property used to specify a default target namespace.

Since:

2.4, replaces JAXBContextFactory.DEFAULT_TARGET_NAMESPACE_KEY

See Also:

Constant Field Values

ANNOTATION_HELPER

public static final java.lang.String ANNOTATION_HELPER

The name of the property used to specify an AnnotationHelper instance. An AnnotationHelper is responsible for returning Annotations from AnnotatedElements.

Since:

2.4, replaces JAXBContextFactory.ANNOTATION_HELPER_KEY

See Also:

AnnotationHelper, Annotation, AnnotatedElement, Constant Field Values

XML_ACCESSOR_FACTORY_SUPPORT

public static final java.lang.String XML_ACCESSOR_FACTORY_SUPPORT

The name of the boolean property used to enable custom XmlAccessorFactories.

Since:

2.4.2

See Also:

com.sun.xml.bind.XmlAccessorFactory, Constant Field Values

OBJECT_GRAPH

public static final java.lang.String OBJECT_GRAPH

The name of the property used to specify an ObjectGraph instance or name of an ObjectGraph to be used on Unmarshallers and Marshallers created by the context.

See Also:

Constant Field Values

JSON_WRAPPER_AS_ARRAY_NAME

public static final java.lang.String JSON_WRAPPER_AS_ARRAY_NAME

The Constant JSON_WRAPPER_AS_ARRAY_NAME. If true the grouping element will be used as the JSON key. There is no effect when media type is "application/xml". When this property is specified at the JAXBContext level all instances of Marshaller and Unmarshaller will default to this.

Example

Given the following class:

 @XmlAccessorType(XmlAccessType.FIELD)
 public class Customer {
 
     @XmlElementWrapper(name="phone_numbers")
     @XmlElement(name="phone_number")
     private List<PhoneNumber> phoneNumbers;
 
 }
 

If the property is set to false (the default) the JSON output will be:

 {
     "phone-numbers" : {
         "phone-number" : [ {
             ...
         }, {
             ...
         }]
     }
 }
 

And if the property is set to true, then the JSON output will be:

 {
     "phone-numbers" : [ {
         ...
     }, {
         ...
     }]
 }
 

Since:

2.4.2

See Also:

org.eclipse.persistence.jaxb.MarshallerProperties.JSON_WRAPPER_AS_ARRAY_NAME, org.eclipse.persistence.jaxb.UnmarshallerProperties.JSON_WRAPPER_AS_ARRAY_NAME, Constant Field Values

Constructor Detail

JAXBContextProperties

public JAXBContextProperties()