org.springframework.oxm.jaxb

类 Jaxb2Marshaller

java.lang.Object

org.springframework.oxm.jaxb.Jaxb2Marshaller

所有已实现的接口:

org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.InitializingBean, GenericMarshaller, GenericUnmarshaller, Marshaller, MimeMarshaller, MimeUnmarshaller, Unmarshaller

public class Jaxb2Marshaller
extends Object
implements MimeMarshaller, MimeUnmarshaller, GenericMarshaller, GenericUnmarshaller, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.beans.factory.InitializingBean

Implementation of the GenericMarshaller interface for JAXB 2.2.

The typical usage will be to set either the "contextPath" or the "classesToBeBound" property on this bean, possibly customize the marshaller and unmarshaller by setting properties, schemas, adapters, and listeners, and to refer to it.

从以下版本开始:

3.0

作者:

Arjen Poutsma, Juergen Hoeller, Rossen Stoyanchev

另请参阅:

setContextPath(java.lang.String), setClassesToBeBound(java.lang.Class<?>...), setJaxbContextProperties(java.util.Map<java.lang.String, ?>), setMarshallerProperties(java.util.Map<java.lang.String, ?>), setUnmarshallerProperties(java.util.Map<java.lang.String, ?>), setSchema(org.springframework.core.io.Resource), setSchemas(org.springframework.core.io.Resource...), setMarshallerListener(javax.xml.bind.Marshaller.Listener), setUnmarshallerListener(javax.xml.bind.Unmarshaller.Listener), setAdapters(javax.xml.bind.annotation.adapters.XmlAdapter<?, ?>...)

字段概要

字段

限定符和类型	字段和说明
protected Log	logger Logger available to subclasses

构造器概要

构造器

构造器和说明
Jaxb2Marshaller()

方法概要

限定符和类型	方法和说明
void	afterPropertiesSet()
protected XmlMappingException	convertJaxbException(JAXBException ex) Convert the given JAXBException to an appropriate exception from the org.springframework.oxm hierarchy.
protected Marshaller	createMarshaller() Return a newly created JAXB marshaller.
protected Unmarshaller	createUnmarshaller() Return a newly created JAXB unmarshaller.
Class<?>[]	getClassesToBeBound() Return the list of Java classes to be recognized by a newly created JAXBContext.
String	getContextPath() Return the JAXB context path.
JAXBContext	getJaxbContext() Return the JAXBContext used by this marshaller, lazily building it if necessary.
String[]	getPackagesToScan() Return the packages to search for JAXB2 annotations.
protected void	initJaxbMarshaller(Marshaller marshaller) Template method that can be overridden by concrete JAXB marshallers for custom initialization behavior.
protected void	initJaxbUnmarshaller(Unmarshaller unmarshaller) Template method that can be overridden by concrete JAXB marshallers for custom initialization behavior.
boolean	isProcessExternalEntities() Return whether XML external entities are allowed.
boolean	isSupportDtd() Return whether DTD parsing is supported.
void	marshal(Object graph, Result result) Marshal the object graph with the given root into the provided Result.
void	marshal(Object graph, Result result, MimeContainer mimeContainer) Marshals the object graph with the given root into the provided Result, writing binary data to a MimeContainer.
void	setAdapters(XmlAdapter<?,?>... adapters) Specify the XmlAdapters to be registered with the JAXB Marshaller and Unmarshaller.
void	setBeanClassLoader(ClassLoader classLoader)
void	setCheckForXmlRootElement(boolean checkForXmlRootElement) Specify whether the supports(Class) should check for @XmlRootElement annotations.
void	setClassesToBeBound(Class<?>... classesToBeBound) Set the list of Java classes to be recognized by a newly created JAXBContext.
void	setContextPath(String contextPath) Set a JAXB context path.
void	setContextPaths(String... contextPaths) Set multiple JAXB context paths.
void	setJaxbContextProperties(Map<String,?> jaxbContextProperties) Set the JAXBContext properties.
void	setLazyInit(boolean lazyInit) Set whether to lazily initialize the JAXBContext for this marshaller.
void	setMappedClass(Class<?> mappedClass) Specify a JAXB mapped class for partial unmarshalling.
void	setMarshallerListener(Marshaller.Listener marshallerListener) Specify the Marshaller.Listener to be registered with the JAXB Marshaller.
void	setMarshallerProperties(Map<String,?> properties) Set the JAXB Marshaller properties.
void	setMtomEnabled(boolean mtomEnabled) Specify whether MTOM support should be enabled or not.
void	setPackagesToScan(String... packagesToScan) Set the packages to search for classes with JAXB2 annotations in the classpath.
void	setProcessExternalEntities(boolean processExternalEntities) Indicate whether external XML entities are processed when unmarshalling.
void	setSchema(org.springframework.core.io.Resource schemaResource) Set the schema resource to use for validation.
void	setSchemaLanguage(String schemaLanguage) Set the schema language.
void	setSchemaResourceResolver(LSResourceResolver schemaResourceResolver) Set the resource resolver, as used to load the schema resources.
void	setSchemas(org.springframework.core.io.Resource... schemaResources) Set the schema resources to use for validation.
void	setSupportDtd(boolean supportDtd) Indicate whether DTD parsing should be supported.
void	setSupportJaxbElementClass(boolean supportJaxbElementClass) Specify whether the supports(Class) returns true for the JAXBElement class.
void	setUnmarshallerListener(Unmarshaller.Listener unmarshallerListener) Set the Unmarshaller.Listener to be registered with the JAXB Unmarshaller.
void	setUnmarshallerProperties(Map<String,?> properties) Set the JAXB Unmarshaller properties.
void	setValidationEventHandler(ValidationEventHandler validationEventHandler) Set the JAXB validation event handler.
boolean	supports(Class<?> clazz) Indicate whether this marshaller can marshal instances of the supplied type.
boolean	supports(Type genericType) Indicates whether this marshaller can marshal instances of the supplied generic type.
Object	unmarshal(Source source) Unmarshal the given Source into an object graph.
Object	unmarshal(Source source, MimeContainer mimeContainer) Unmarshals the given provided Source into an object graph, reading binary attachments from a MimeContainer.
protected Object	unmarshalStaxSource(Unmarshaller jaxbUnmarshaller, Source staxSource)

从类继承的方法 java.lang.Object

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

字段详细资料

logger

protected final Log logger

Logger available to subclasses

构造器详细资料

Jaxb2Marshaller

public Jaxb2Marshaller()

方法详细资料

setContextPaths

public void setContextPaths(String... contextPaths)

Set multiple JAXB context paths. The given array of context paths gets converted to a colon-delimited string, as supported by JAXB.

setContextPath

public void setContextPath(@Nullable
                           String contextPath)

Set a JAXB context path.

Setting either this property, "classesToBeBound" or "packagesToScan" is required.

getContextPath

@Nullable
public String getContextPath()

Return the JAXB context path.

setClassesToBeBound

public void setClassesToBeBound(@Nullable
                                Class<?>... classesToBeBound)

Set the list of Java classes to be recognized by a newly created JAXBContext.

Setting either this property, "contextPath" or "packagesToScan" is required.

getClassesToBeBound

@Nullable
public Class<?>[] getClassesToBeBound()

Return the list of Java classes to be recognized by a newly created JAXBContext.

setPackagesToScan

public void setPackagesToScan(@Nullable
                              String... packagesToScan)

Set the packages to search for classes with JAXB2 annotations in the classpath. This is using a Spring-bases search and therefore analogous to Spring's component-scan feature (org.springframework.context.annotation.ClassPathBeanDefinitionScanner).

Setting either this property, "contextPath" or "classesToBeBound" is required.

getPackagesToScan

@Nullable
public String[] getPackagesToScan()

Return the packages to search for JAXB2 annotations.

setJaxbContextProperties

public void setJaxbContextProperties(Map<String,?> jaxbContextProperties)

Set the JAXBContext properties. These implementation-specific properties will be set on the underlying JAXBContext.

setMarshallerProperties

public void setMarshallerProperties(Map<String,?> properties)

Set the JAXB Marshaller properties.

These properties will be set on the underlying JAXB Marshaller, and allow for features such as indentation.

参数:

properties - the properties

另请参阅:

Marshaller.setProperty(String, Object), Marshaller.JAXB_ENCODING, Marshaller.JAXB_FORMATTED_OUTPUT, Marshaller.JAXB_NO_NAMESPACE_SCHEMA_LOCATION, Marshaller.JAXB_SCHEMA_LOCATION

setUnmarshallerProperties

public void setUnmarshallerProperties(Map<String,?> properties)

Set the JAXB Unmarshaller properties.

These properties will be set on the underlying JAXB Unmarshaller.

参数:

properties - the properties

另请参阅:

Unmarshaller.setProperty(String, Object)

setMarshallerListener

public void setMarshallerListener(Marshaller.Listener marshallerListener)

Specify the Marshaller.Listener to be registered with the JAXB Marshaller.

setUnmarshallerListener

public void setUnmarshallerListener(Unmarshaller.Listener unmarshallerListener)

Set the Unmarshaller.Listener to be registered with the JAXB Unmarshaller.

setValidationEventHandler

public void setValidationEventHandler(ValidationEventHandler validationEventHandler)

Set the JAXB validation event handler. This event handler will be called by JAXB if any validation errors are encountered during calls to any of the marshal APIs.

setAdapters

public void setAdapters(XmlAdapter<?,?>... adapters)

Specify the XmlAdapters to be registered with the JAXB Marshaller and Unmarshaller.

setSchema

public void setSchema(org.springframework.core.io.Resource schemaResource)

Set the schema resource to use for validation.

setSchemas

public void setSchemas(org.springframework.core.io.Resource... schemaResources)

Set the schema resources to use for validation.

setSchemaLanguage

public void setSchemaLanguage(String schemaLanguage)

Set the schema language. Default is the W3C XML Schema: http://www.w3.org/2001/XMLSchema".

另请参阅:

XMLConstants.W3C_XML_SCHEMA_NS_URI, XMLConstants.RELAXNG_NS_URI

setSchemaResourceResolver

public void setSchemaResourceResolver(LSResourceResolver schemaResourceResolver)

Set the resource resolver, as used to load the schema resources.

另请参阅:

SchemaFactory.setResourceResolver(org.w3c.dom.ls.LSResourceResolver), setSchema(org.springframework.core.io.Resource), setSchemas(org.springframework.core.io.Resource...)

setLazyInit

public void setLazyInit(boolean lazyInit)

Set whether to lazily initialize the JAXBContext for this marshaller. Default is false to initialize on startup; can be switched to true.

Early initialization just applies if afterPropertiesSet() is called.

setMtomEnabled

public void setMtomEnabled(boolean mtomEnabled)

Specify whether MTOM support should be enabled or not. Default is false: marshalling using XOP/MTOM not being enabled.

setSupportJaxbElementClass

public void setSupportJaxbElementClass(boolean supportJaxbElementClass)

Specify whether the supports(Class) returns true for the JAXBElement class.

Default is false, meaning that supports(Class) always returns false for JAXBElement classes (though supports(Type) can return true, since it can obtain the type parameters of JAXBElement).

This property is typically enabled in combination with usage of classes like MarshallingView, since the ModelAndView does not offer type parameter information at runtime.

另请参阅:

supports(Class), supports(Type)

setCheckForXmlRootElement

public void setCheckForXmlRootElement(boolean checkForXmlRootElement)

Specify whether the supports(Class) should check for @XmlRootElement annotations.

Default is true, meaning that supports(Class) will check for this annotation. However, some JAXB implementations (i.e. EclipseLink MOXy) allow for defining the bindings in an external definition file, thus keeping the classes annotations free. Setting this property to false supports these JAXB implementations.

另请参阅:

supports(Class), supports(Type)

setMappedClass

public void setMappedClass(Class<?> mappedClass)

Specify a JAXB mapped class for partial unmarshalling.

另请参阅:

Unmarshaller.unmarshal(javax.xml.transform.Source, Class)

setSupportDtd

public void setSupportDtd(boolean supportDtd)

Indicate whether DTD parsing should be supported.

Default is false meaning that DTD is disabled.

isSupportDtd

public boolean isSupportDtd()

Return whether DTD parsing is supported.

setProcessExternalEntities

public void setProcessExternalEntities(boolean processExternalEntities)

Indicate whether external XML entities are processed when unmarshalling.

Default is false, meaning that external entities are not resolved. Note that processing of external entities will only be enabled/disabled when the Source passed to unmarshal(Source) is a SAXSource or StreamSource. It has no effect for DOMSource or StAXSource instances.

Note: setting this option to true also automatically sets setSupportDtd(boolean) to true.

isProcessExternalEntities

public boolean isProcessExternalEntities()

Return whether XML external entities are allowed.

setBeanClassLoader

public void setBeanClassLoader(ClassLoader classLoader)

指定者:

setBeanClassLoader 在接口中 org.springframework.beans.factory.BeanClassLoaderAware

afterPropertiesSet

public void afterPropertiesSet()
                        throws Exception

指定者:

afterPropertiesSet 在接口中 org.springframework.beans.factory.InitializingBean

抛出:

Exception

getJaxbContext

public JAXBContext getJaxbContext()

Return the JAXBContext used by this marshaller, lazily building it if necessary.

supports

public boolean supports(Class<?> clazz)

从接口复制的说明: Marshaller

Indicate whether this marshaller can marshal instances of the supplied type.

指定者:

supports 在接口中 Marshaller

指定者:

supports 在接口中 Unmarshaller

参数:

clazz - the class that this marshaller is being asked if it can marshal

返回:

true if this marshaller can indeed marshal instances of the supplied class; false otherwise

supports

public boolean supports(Type genericType)

从接口复制的说明: GenericMarshaller

Indicates whether this marshaller can marshal instances of the supplied generic type.

指定者:

supports 在接口中 GenericMarshaller

指定者:

supports 在接口中 GenericUnmarshaller

参数:

genericType - the type that this marshaller is being asked if it can marshal

返回:

true if this marshaller can indeed marshal instances of the supplied type; false otherwise

marshal

public void marshal(Object graph,
                    Result result)
             throws XmlMappingException

从接口复制的说明: Marshaller

Marshal the object graph with the given root into the provided Result.

指定者:

marshal 在接口中 Marshaller

参数:

graph - the root of the object graph to marshal

result - the result to marshal to

抛出:

XmlMappingException - if the given object cannot be marshalled to the result

marshal

public void marshal(Object graph,
                    Result result,
                    @Nullable
                    MimeContainer mimeContainer)
             throws XmlMappingException

从接口复制的说明: MimeMarshaller

Marshals the object graph with the given root into the provided Result, writing binary data to a MimeContainer.

指定者:

marshal 在接口中 MimeMarshaller

参数:

graph - the root of the object graph to marshal

result - the result to marshal to

mimeContainer - the MIME container to write extracted binary content to

抛出:

XmlMappingException - if the given object cannot be marshalled to the result

createMarshaller

protected Marshaller createMarshaller()

Return a newly created JAXB marshaller.

Note: JAXB marshallers are not necessarily thread-safe.

initJaxbMarshaller

protected void initJaxbMarshaller(Marshaller marshaller)
                           throws JAXBException

Template method that can be overridden by concrete JAXB marshallers for custom initialization behavior. Gets called after creation of JAXB Marshaller, and after the respective properties have been set.

The default implementation sets the defined properties, the validation event handler, the schemas, listener, and adapters.

抛出:

JAXBException

unmarshal

public Object unmarshal(Source source)
                 throws XmlMappingException

从接口复制的说明: Unmarshaller

Unmarshal the given Source into an object graph.

指定者:

unmarshal 在接口中 Unmarshaller

参数:

source - the source to marshal from

返回:

the object graph

抛出:

XmlMappingException - if the given source cannot be mapped to an object

unmarshal

public Object unmarshal(Source source,
                        @Nullable
                        MimeContainer mimeContainer)
                 throws XmlMappingException

从接口复制的说明: MimeUnmarshaller

Unmarshals the given provided Source into an object graph, reading binary attachments from a MimeContainer.

指定者:

unmarshal 在接口中 MimeUnmarshaller

参数:

source - the source to marshal from

mimeContainer - the MIME container to read extracted binary content from

返回:

the object graph

抛出:

XmlMappingException - if the given source cannot be mapped to an object

createUnmarshaller

protected Unmarshaller createUnmarshaller()

Return a newly created JAXB unmarshaller.

Note: JAXB unmarshallers are not necessarily thread-safe.

unmarshalStaxSource

protected Object unmarshalStaxSource(Unmarshaller jaxbUnmarshaller,
                                     Source staxSource)
                              throws JAXBException

抛出:

JAXBException

initJaxbUnmarshaller

protected void initJaxbUnmarshaller(Unmarshaller unmarshaller)
                             throws JAXBException

Template method that can be overridden by concrete JAXB marshallers for custom initialization behavior. Gets called after creation of JAXB Marshaller, and after the respective properties have been set.

The default implementation sets the defined properties, the validation event handler, the schemas, listener, and adapters.

抛出:

JAXBException

convertJaxbException

protected XmlMappingException convertJaxbException(JAXBException ex)

Convert the given JAXBException to an appropriate exception from the org.springframework.oxm hierarchy.

参数:

ex - JAXBException that occurred

返回:

the corresponding XmlMappingException