EclipseLink 1.2.0, build 'v20091016-r5565' API Reference

org.eclipse.persistence.jaxb
Class JAXBMarshaller

java.lang.Object
  extended by org.eclipse.persistence.jaxb.JAXBMarshaller
All Implemented Interfaces:
Marshaller

public class JAXBMarshaller
extends java.lang.Object
implements Marshaller

INTERNAL:

Purpose:To Provide an implementation of the JAXB 2.0 Marshaller Interface

Responsibilities:

This implementation of the JAXB 2.0 Marshaller interface provides the required functionality by acting as a thin wrapper on the existing XMLMarshaller API.

See Also:
Marshaller, XMLMarshaller
Author:
mmacivor
Since:
Oracle TopLink 11.1.1.0.0

Nested Class Summary
 
Nested classes/interfaces inherited from interface javax.xml.bind.Marshaller
Marshaller.Listener
 
Field Summary
static java.lang.String XML_JAVATYPE_ADAPTERS
           
 
Fields inherited from interface javax.xml.bind.Marshaller
JAXB_ENCODING, JAXB_FORMATTED_OUTPUT, JAXB_FRAGMENT, JAXB_NO_NAMESPACE_SCHEMA_LOCATION, JAXB_SCHEMA_LOCATION
 
Constructor Summary
JAXBMarshaller(XMLMarshaller newXMLMarshaller, JAXBIntrospector newIntrospector)
          This constructor initializes various settings on the XML marshaller, and stores the provided JAXBIntrospector instance for usage in marshal() calls.
 
Method Summary
 XmlAdapter getAdapter(java.lang.Class javaClass)
          Gets the adapter associated with the specified type.
 AttachmentMarshaller getAttachmentMarshaller()
           
 ValidationEventHandler getEventHandler()
          Return the current event handler or the default event handler if one hasn't been set.
 Marshaller.Listener getListener()
          Return Marshaller.Listener registered with this Marshaller.
 org.w3c.dom.Node getNode(java.lang.Object object)
          Get a DOM tree view of the content tree(Optional).
 java.lang.Object getProperty(java.lang.String key)
          Get the particular property in the underlying implementation of Marshaller.
 javax.xml.validation.Schema getSchema()
          Get the JAXP 1.3 Schema object being used to perform marshal-time validation.
 XMLMarshaller getXMLMarshaller()
           
 void marshal(java.lang.Object object, org.xml.sax.ContentHandler contentHandler)
          Marshal the content tree rooted at jaxbElement into SAX2 events.
 void marshal(java.lang.Object object, java.io.File file)
          Marshal the content tree rooted at jaxbElement into a file.
 void marshal(java.lang.Object object, org.w3c.dom.Node node)
          Marshal the content tree rooted at jaxbElement into a DOM tree.
 void marshal(java.lang.Object object, java.io.OutputStream outputStream)
          Marshal the content tree rooted at jaxbElement into an output stream.
 void marshal(java.lang.Object object, javax.xml.transform.Result result)
          Marshal the content tree rooted at jaxbElement into the specified javax.xml.transform.Result.
 void marshal(java.lang.Object object, java.io.Writer writer)
          Marshal the content tree rooted at jaxbElement into a Writer.
 void marshal(java.lang.Object object, javax.xml.stream.XMLEventWriter eventWriter)
          Marshal the content tree rooted at jaxbElement into a XMLEventWriter.
 void marshal(java.lang.Object object, javax.xml.stream.XMLStreamWriter streamWriter)
          Marshal the content tree rooted at jaxbElement into a XMLStreamWriter.
 void setAdapter(java.lang.Class javaClass, XmlAdapter adapter)
          Associates a configured instance of XmlAdapter with this marshaller.
 void setAdapter(XmlAdapter adapter)
          Associates a configured instance of XmlAdapter with this marshaller.
 void setAttachmentMarshaller(AttachmentMarshaller attachmentMarshaller)
          Associate a context that enables binary data within an XML document to be transmitted as XML-binary optimized attachment.
 void setEventHandler(ValidationEventHandler newValidationEventHandler)
          Allow an application to register a validation event handler.
 void setJaxbContext(JAXBContext jaxbContext)
           
 void setListener(Marshaller.Listener listener)
           Register marshal event callback Marshaller.Listener with this Marshaller.
 void setMarshalCallbacks(java.util.HashMap callbacks)
           
 void setProperty(java.lang.String key, java.lang.Object value)
          Set the particular property in the underlying implementation of Marshaller.
 void setQNameToGeneratedClasses(java.util.HashMap<javax.xml.namespace.QName,java.lang.Class> qNameToClass)
           
 void setSchema(javax.xml.validation.Schema schema)
          Specify the JAXP 1.3 Schema object that should be used to validate subsequent marshal operations against.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

XML_JAVATYPE_ADAPTERS

public static final java.lang.String XML_JAVATYPE_ADAPTERS
See Also:
Constant Field Values
Constructor Detail

JAXBMarshaller

public JAXBMarshaller(XMLMarshaller newXMLMarshaller,
                      JAXBIntrospector newIntrospector)
This constructor initializes various settings on the XML marshaller, and stores the provided JAXBIntrospector instance for usage in marshal() calls.

Parameters:
newXMLMarshaller -
newIntrospector -
Method Detail

getAdapter

public XmlAdapter getAdapter(java.lang.Class javaClass)
Description copied from interface: Marshaller
Gets the adapter associated with the specified type. This is the reverse operation of the Marshaller.setAdapter(javax.xml.bind.annotation.adapters.XmlAdapter) method.

Specified by:
getAdapter in interface Marshaller

getAttachmentMarshaller

public AttachmentMarshaller getAttachmentMarshaller()
Specified by:
getAttachmentMarshaller in interface Marshaller

getEventHandler

public ValidationEventHandler getEventHandler()
                                       throws JAXBException
Description copied from interface: Marshaller
Return the current event handler or the default event handler if one hasn't been set.

Specified by:
getEventHandler in interface Marshaller
Returns:
the current ValidationEventHandler or the default event handler if it hasn't been set
Throws:
JAXBException - if an error was encountered while getting the current event handler

getListener

public Marshaller.Listener getListener()
Description copied from interface: Marshaller

Return Marshaller.Listener registered with this Marshaller.

Specified by:
getListener in interface Marshaller
Returns:
registered Marshaller.Listener or null if no Listener is registered with this Marshaller.

getNode

public org.w3c.dom.Node getNode(java.lang.Object object)
                         throws JAXBException
Description copied from interface: Marshaller
Get a DOM tree view of the content tree(Optional). If the returned DOM tree is updated, these changes are also visible in the content tree. Use Marshaller.marshal(Object, org.w3c.dom.Node) to force a deep copy of the content tree to a DOM representation.

Specified by:
getNode in interface Marshaller
Parameters:
object - - JAXB Java representation of XML content
Returns:
the DOM tree view of the contentTree
Throws:
JAXBException - If any unexpected problem occurs

getProperty

public java.lang.Object getProperty(java.lang.String key)
                             throws PropertyException
Description copied from interface: Marshaller
Get the particular property in the underlying implementation of Marshaller. This method can only be used to get one of the standard JAXB defined properties above or a provider specific property. Attempting to get an undefined property will result in a PropertyException being thrown. See Supported Properties.

Specified by:
getProperty in interface Marshaller
Parameters:
key - the name of the property to retrieve
Returns:
the value of the requested property
Throws:
PropertyException - when there is an error retrieving the given property or value property name

getSchema

public javax.xml.validation.Schema getSchema()
Description copied from interface: Marshaller
Get the JAXP 1.3 Schema object being used to perform marshal-time validation. If there is no Schema set on the marshaller, then this method will return null indicating that marshal-time validation will not be performed.

Specified by:
getSchema in interface Marshaller
Returns:
the Schema object being used to perform marshal-time validation or null if not present.

marshal

public void marshal(java.lang.Object object,
                    org.xml.sax.ContentHandler contentHandler)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into SAX2 events.

Specified by:
marshal in interface Marshaller
Parameters:
object - The root of content tree to be marshalled.
contentHandler - XML will be sent to this handler as SAX2 events.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    javax.xml.stream.XMLEventWriter eventWriter)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into a XMLEventWriter.

Specified by:
marshal in interface Marshaller
Parameters:
object - The content tree rooted at jaxbElement to be marshalled.
eventWriter - XML will be sent to this writer.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    org.w3c.dom.Node node)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into a DOM tree.

Specified by:
marshal in interface Marshaller
Parameters:
object - The content tree to be marshalled.
node - DOM nodes will be added as children of this node. This parameter must be a Node that accepts children (Document, DocumentFragment, or Element)
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal jaxbElement (or any object reachable from jaxbElement). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    java.io.OutputStream outputStream)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into an output stream.

Specified by:
marshal in interface Marshaller
Parameters:
object - The root of content tree to be marshalled.
outputStream - XML will be added to this stream.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    java.io.File file)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into a file.

Specified by:
marshal in interface Marshaller
Parameters:
object - The root of content tree to be marshalled.
file - File to be written. If this file already exists, it will be overwritten.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    javax.xml.transform.Result result)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into the specified javax.xml.transform.Result.

All JAXB Providers must at least support DOMResult, SAXResult, and StreamResult. It can support other derived classes of Result as well.

Specified by:
marshal in interface Marshaller
Parameters:
object - The root of content tree to be marshalled.
result - XML will be sent to this Result
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    javax.xml.stream.XMLStreamWriter streamWriter)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into a XMLStreamWriter.

Specified by:
marshal in interface Marshaller
Parameters:
object - The content tree to be marshalled.
streamWriter - XML will be sent to this writer.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

marshal

public void marshal(java.lang.Object object,
                    java.io.Writer writer)
             throws JAXBException
Description copied from interface: Marshaller
Marshal the content tree rooted at jaxbElement into a Writer.

Specified by:
marshal in interface Marshaller
Parameters:
object - The root of content tree to be marshalled.
writer - XML will be sent to this writer.
Throws:
JAXBException - If any unexpected problem occurs during the marshalling.
MarshalException - If the ValidationEventHandler returns false from its handleEvent method or the Marshaller is unable to marshal obj (or any object reachable from obj). See Marshalling a JAXB element.

setAdapter

public void setAdapter(java.lang.Class javaClass,
                       XmlAdapter adapter)
Description copied from interface: Marshaller
Associates a configured instance of XmlAdapter with this marshaller.

Every marshaller internally maintains a Map<Class,XmlAdapter>, which it uses for marshalling classes whose fields/methods are annotated with XmlJavaTypeAdapter.

This method allows applications to use a configured instance of XmlAdapter. When an instance of an adapter is not given, a marshaller will create one by invoking its default constructor.

Specified by:
setAdapter in interface Marshaller
Parameters:
javaClass - The type of the adapter. The specified instance will be used when XmlJavaTypeAdapter.value() refers to this type.
adapter - The instance of the adapter to be used. If null, it will un-register the current adapter set for this type.

setAdapter

public void setAdapter(XmlAdapter adapter)
Description copied from interface: Marshaller
Associates a configured instance of XmlAdapter with this marshaller.

This is a convenience method that invokes setAdapter(adapter.getClass(),adapter);.

Specified by:
setAdapter in interface Marshaller
See Also:
Marshaller.setAdapter(Class,XmlAdapter)

setAttachmentMarshaller

public void setAttachmentMarshaller(AttachmentMarshaller attachmentMarshaller)
Description copied from interface: Marshaller

Associate a context that enables binary data within an XML document to be transmitted as XML-binary optimized attachment. The attachment is referenced from the XML document content model by content-id URIs(cid) references stored within the xml document.

Specified by:
setAttachmentMarshaller in interface Marshaller

setEventHandler

public void setEventHandler(ValidationEventHandler newValidationEventHandler)
                     throws JAXBException
Description copied from interface: Marshaller
Allow an application to register a validation event handler.

The validation event handler will be called by the JAXB Provider if any validation errors are encountered during calls to any of the marshal API's. If the client application does not register a validation event handler before invoking one of the marshal methods, then validation events will be handled by the default event handler which will terminate the marshal operation after the first error or fatal error is encountered.

Calling this method with a null parameter will cause the Marshaller to revert back to the default default event handler.

Specified by:
setEventHandler in interface Marshaller
Parameters:
newValidationEventHandler - the validation event handler
Throws:
JAXBException - if an error was encountered while setting the event handler

setListener

public void setListener(Marshaller.Listener listener)
Description copied from interface: Marshaller

Register marshal event callback Marshaller.Listener with this Marshaller.

There is only one Listener per Marshaller. Setting a Listener replaces the previous set Listener. One can unregister current Listener by setting listener to null.

Specified by:
setListener in interface Marshaller
Parameters:
listener - an instance of a class that implements Marshaller.Listener

setMarshalCallbacks

public void setMarshalCallbacks(java.util.HashMap callbacks)

setProperty

public void setProperty(java.lang.String key,
                        java.lang.Object value)
                 throws PropertyException
Description copied from interface: Marshaller
Set the particular property in the underlying implementation of Marshaller. This method can only be used to set one of the standard JAXB defined properties above or a provider specific property. Attempting to set an undefined property will result in a PropertyException being thrown. See Supported Properties.

Specified by:
setProperty in interface Marshaller
Parameters:
key - the name of the property to be set. This value can either be specified using one of the constant fields or a user supplied string.
value - the value of the property to be set
Throws:
PropertyException - when there is an error processing the given property or value

setSchema

public void setSchema(javax.xml.validation.Schema schema)
Description copied from interface: Marshaller
Specify the JAXP 1.3 Schema object that should be used to validate subsequent marshal operations against. Passing null into this method will disable validation.

This method allows the caller to validate the marshalled XML as it's marshalled.

Initially this property is set to null.

Specified by:
setSchema in interface Marshaller
Parameters:
schema - Schema object to validate marshal operations against or null to disable validation

setQNameToGeneratedClasses

public void setQNameToGeneratedClasses(java.util.HashMap<javax.xml.namespace.QName,java.lang.Class> qNameToClass)

setJaxbContext

public void setJaxbContext(JAXBContext jaxbContext)

getXMLMarshaller

public XMLMarshaller getXMLMarshaller()

EclipseLink 1.2.0, build 'v20091016-r5565' API Reference