- java.lang.Object
-
- jakarta.xml.bind.helpers.AbstractMarshallerImpl
-
- All Implemented Interfaces:
Marshaller
public abstract class AbstractMarshallerImpl extends java.lang.Object implements Marshaller
Partial defaultMarshaller
implementation.This class provides a partial default implementation for the
Marshaller
interface.The only methods that a Jakarta XML Binding Provider has to implement are
marshal(Object, javax.xml.transform.Result)
,marshal(Object, javax.xml.stream.XMLStreamWriter)
, andmarshal(Object, javax.xml.stream.XMLEventWriter)
.- Author:
- Kohsuke Kawaguchi, Sun Microsystems, Inc.
- See Also:
Marshaller
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from interface jakarta.xml.bind.Marshaller
Marshaller.Listener
-
-
Field Summary
-
Fields inherited from interface jakarta.xml.bind.Marshaller
JAXB_ENCODING, JAXB_FORMATTED_OUTPUT, JAXB_FRAGMENT, JAXB_NO_NAMESPACE_SCHEMA_LOCATION, JAXB_SCHEMA_LOCATION
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
AbstractMarshallerImpl()
Do-nothing constructor for the derived classes.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description <A extends XmlAdapter<?,?>>
AgetAdapter(java.lang.Class<A> type)
Gets the adapter associated with the specified type.AttachmentMarshaller
getAttachmentMarshaller()
protected java.lang.String
getEncoding()
Convenience method for getting the current output encoding.ValidationEventHandler
getEventHandler()
Return the current event handler or the default event handler if one hasn't been set.protected java.lang.String
getJavaEncoding(java.lang.String encoding)
Gets the corresponding Java encoding name from an IANA name.Marshaller.Listener
getListener()
ReturnMarshaller.Listener
registered with thisMarshaller
.org.w3c.dom.Node
getNode(java.lang.Object obj)
By default, the getNode method is unsupported and throw anUnsupportedOperationException
.protected java.lang.String
getNoNSSchemaLocation()
Convenience method for getting the current noNamespaceSchemaLocation.java.lang.Object
getProperty(java.lang.String name)
Default implementation of the getProperty method handles the four defined properties in Marshaller.javax.xml.validation.Schema
getSchema()
Get the JAXPSchema
object being used to perform marshal-time validation.protected java.lang.String
getSchemaLocation()
Convenience method for getting the current schemaLocation.protected boolean
isFormattedOutput()
Convenience method for getting the formatted output flag.protected boolean
isFragment()
Convenience method for getting the fragment flag.void
marshal(java.lang.Object jaxbElement, java.io.File output)
Marshal the content tree rooted atjaxbElement
into a file.void
marshal(java.lang.Object obj, java.io.OutputStream os)
Marshal the content tree rooted atjaxbElement
into an output stream.void
marshal(java.lang.Object obj, java.io.Writer w)
Marshal the content tree rooted atjaxbElement
into a Writer.void
marshal(java.lang.Object obj, javax.xml.stream.XMLEventWriter writer)
Marshal the content tree rooted atjaxbElement
into aXMLEventWriter
.void
marshal(java.lang.Object obj, javax.xml.stream.XMLStreamWriter writer)
Marshal the content tree rooted atjaxbElement
into aXMLStreamWriter
.void
marshal(java.lang.Object obj, org.w3c.dom.Node node)
Marshal the content tree rooted atjaxbElement
into a DOM tree.void
marshal(java.lang.Object obj, org.xml.sax.ContentHandler handler)
Marshal the content tree rooted atjaxbElement
into SAX2 events.<A extends XmlAdapter<?,?>>
voidsetAdapter(A adapter)
Associates a configured instance ofXmlAdapter
with this marshaller.<A extends XmlAdapter<?,?>>
voidsetAdapter(java.lang.Class<A> type, A adapter)
Associates a configured instance ofXmlAdapter
with this marshaller.void
setAttachmentMarshaller(AttachmentMarshaller am)
Associate a context that enables binary data within an XML document to be transmitted as XML-binary optimized attachment.protected void
setEncoding(java.lang.String encoding)
Convenience method for setting the output encoding.void
setEventHandler(ValidationEventHandler handler)
Allow an application to register a validation event handler.protected void
setFormattedOutput(boolean v)
Convenience method for setting the formatted output flag.protected void
setFragment(boolean v)
Convenience method for setting the fragment flag.void
setListener(Marshaller.Listener listener)
Register marshal event callbackMarshaller.Listener
with thisMarshaller
.protected void
setNoNSSchemaLocation(java.lang.String location)
Convenience method for setting the noNamespaceSchemaLocation.void
setProperty(java.lang.String name, java.lang.Object value)
Default implementation of the setProperty method handles the four defined properties in Marshaller.void
setSchema(javax.xml.validation.Schema schema)
Specify the JAXPSchema
object that should be used to validate subsequent marshal operations against.protected void
setSchemaLocation(java.lang.String location)
Convenience method for setting the schemaLocation.-
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
-
Methods inherited from interface jakarta.xml.bind.Marshaller
marshal
-
-
-
-
Method Detail
-
marshal
public final void marshal(java.lang.Object obj, java.io.OutputStream os) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into an output stream.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- The root of content tree to be marshalled.os
- XML will be added to this stream.- Throws:
JAXBException
- If any unexpected problem occurs during the marshalling.MarshalException
- If theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
marshal
public void marshal(java.lang.Object jaxbElement, java.io.File output) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into a file.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
jaxbElement
- The root of content tree to be marshalled.output
- 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 theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
marshal
public final void marshal(java.lang.Object obj, java.io.Writer w) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into a Writer.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- The root of content tree to be marshalled.w
- XML will be sent to this writer.- Throws:
JAXBException
- If any unexpected problem occurs during the marshalling.MarshalException
- If theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
marshal
public final void marshal(java.lang.Object obj, org.xml.sax.ContentHandler handler) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into SAX2 events.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- The root of content tree to be marshalled.handler
- XML will be sent to this handler as SAX2 events.- Throws:
JAXBException
- If any unexpected problem occurs during the marshalling.MarshalException
- If theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
marshal
public final void marshal(java.lang.Object obj, org.w3c.dom.Node node) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into a DOM tree.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- 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
, orElement
)- Throws:
JAXBException
- If any unexpected problem occurs during the marshalling.MarshalException
- If theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
getNode
public org.w3c.dom.Node getNode(java.lang.Object obj) throws JAXBException
By default, the getNode method is unsupported and throw anUnsupportedOperationException
. Implementations that choose to support this method must override this method.- Specified by:
getNode
in interfaceMarshaller
- Parameters:
obj
- - Jakarta XML Binding Java representation of XML content- Returns:
- the DOM tree view of the contentTree
- Throws:
JAXBException
- If any unexpected problem occurs
-
getEncoding
protected java.lang.String getEncoding()
Convenience method for getting the current output encoding.- Returns:
- the current encoding or "UTF-8" if it hasn't been set.
-
setEncoding
protected void setEncoding(java.lang.String encoding)
Convenience method for setting the output encoding.- Parameters:
encoding
- a valid encoding as specified in the Marshaller class documentation
-
getSchemaLocation
protected java.lang.String getSchemaLocation()
Convenience method for getting the current schemaLocation.- Returns:
- the current schemaLocation or null if it hasn't been set
-
setSchemaLocation
protected void setSchemaLocation(java.lang.String location)
Convenience method for setting the schemaLocation.- Parameters:
location
- the schemaLocation value
-
getNoNSSchemaLocation
protected java.lang.String getNoNSSchemaLocation()
Convenience method for getting the current noNamespaceSchemaLocation.- Returns:
- the current noNamespaceSchemaLocation or null if it hasn't been set
-
setNoNSSchemaLocation
protected void setNoNSSchemaLocation(java.lang.String location)
Convenience method for setting the noNamespaceSchemaLocation.- Parameters:
location
- the noNamespaceSchemaLocation value
-
isFormattedOutput
protected boolean isFormattedOutput()
Convenience method for getting the formatted output flag.- Returns:
- the current value of the formatted output flag or false if it hasn't been set.
-
setFormattedOutput
protected void setFormattedOutput(boolean v)
Convenience method for setting the formatted output flag.- Parameters:
v
- value of the formatted output flag.
-
isFragment
protected boolean isFragment()
Convenience method for getting the fragment flag.- Returns:
- the current value of the fragment flag or false if it hasn't been set.
-
setFragment
protected void setFragment(boolean v)
Convenience method for setting the fragment flag.- Parameters:
v
- value of the fragment flag.
-
getJavaEncoding
protected java.lang.String getJavaEncoding(java.lang.String encoding) throws java.io.UnsupportedEncodingException
Gets the corresponding Java encoding name from an IANA name. This method is a helper method for the derived class to convert encoding names.- Throws:
java.io.UnsupportedEncodingException
- If this implementation couldn't find the Java encoding name.
-
setProperty
public void setProperty(java.lang.String name, java.lang.Object value) throws PropertyException
Default implementation of the setProperty method handles the four defined properties in Marshaller. If a provider needs to handle additional properties, it should override this method in a derived class.- Specified by:
setProperty
in interfaceMarshaller
- Parameters:
name
- 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
-
getProperty
public java.lang.Object getProperty(java.lang.String name) throws PropertyException
Default implementation of the getProperty method handles the four defined properties in Marshaller. If a provider needs to support additional provider specific properties, it should override this method in a derived class.- Specified by:
getProperty
in interfaceMarshaller
- Parameters:
name
- 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
-
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 interfaceMarshaller
- 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- See Also:
Marshaller.getEventHandler()
-
setEventHandler
public void setEventHandler(ValidationEventHandler handler) 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 Jakarta XML Binding 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 interfaceMarshaller
- Parameters:
handler
- the validation event handler- Throws:
JAXBException
- if an error was encountered while setting the event handler- See Also:
Marshaller.setEventHandler(ValidationEventHandler)
-
marshal
public void marshal(java.lang.Object obj, javax.xml.stream.XMLEventWriter writer) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into aXMLEventWriter
.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- The content tree rooted at jaxbElement to be marshalled.writer
- XML will be sent to this writer.- Throws:
JAXBException
- If any unexpected problem occurs during the marshalling.MarshalException
- If theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
marshal
public void marshal(java.lang.Object obj, javax.xml.stream.XMLStreamWriter writer) throws JAXBException
Description copied from interface:Marshaller
Marshal the content tree rooted atjaxbElement
into aXMLStreamWriter
.- Specified by:
marshal
in interfaceMarshaller
- Parameters:
obj
- The 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 theValidationEventHandler
returns false from itshandleEvent
method or theMarshaller
is unable to marshaljaxbElement
(or any object reachable fromjaxbElement
). See Marshalling a Jakarta XML Binding element.
-
setSchema
public void setSchema(javax.xml.validation.Schema schema)
Description copied from interface:Marshaller
Specify the JAXPSchema
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 interfaceMarshaller
- Parameters:
schema
- Schema object to validate marshal operations against or null to disable validation
-
getSchema
public javax.xml.validation.Schema getSchema()
Description copied from interface:Marshaller
Get the JAXPSchema
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 interfaceMarshaller
- Returns:
- the Schema object being used to perform marshal-time validation or null if not present.
-
setAdapter
public <A extends XmlAdapter<?,?>> void setAdapter(A adapter)
Description copied from interface:Marshaller
Associates a configured instance ofXmlAdapter
with this marshaller.This is a convenience method that invokes
setAdapter(adapter.getClass(),adapter);
.- Specified by:
setAdapter
in interfaceMarshaller
- Type Parameters:
A
- the type of the adapter- Parameters:
adapter
- The instance of the adapter to be used. If null, it will un-register the current adapter set for this type.- See Also:
Marshaller.setAdapter(Class,XmlAdapter)
-
setAdapter
public <A extends XmlAdapter<?,?>> void setAdapter(java.lang.Class<A> type, A adapter)
Description copied from interface:Marshaller
Associates a configured instance ofXmlAdapter
with this marshaller.Every marshaller internally maintains a
Map
<Class
,XmlAdapter
>, which it uses for marshalling classes whose fields/methods are annotated withXmlJavaTypeAdapter
.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 interfaceMarshaller
- Type Parameters:
A
- the type of the adapter- Parameters:
type
- The type of the adapter. The specified instance will be used whenXmlJavaTypeAdapter.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.
-
getAdapter
public <A extends XmlAdapter<?,?>> A getAdapter(java.lang.Class<A> type)
Description copied from interface:Marshaller
Gets the adapter associated with the specified type. This is the reverse operation of theMarshaller.setAdapter(A)
method.- Specified by:
getAdapter
in interfaceMarshaller
- Type Parameters:
A
- the type of the adapter- Parameters:
type
- The type of the adapter. The specified instance will be used whenXmlJavaTypeAdapter.value()
refers to this type.- Returns:
- The adapter associated with the specified type.
-
setAttachmentMarshaller
public void setAttachmentMarshaller(AttachmentMarshaller am)
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 interfaceMarshaller
- Parameters:
am
- the attachment marshaller to be set
-
getAttachmentMarshaller
public AttachmentMarshaller getAttachmentMarshaller()
- Specified by:
getAttachmentMarshaller
in interfaceMarshaller
-
setListener
public void setListener(Marshaller.Listener listener)
Description copied from interface:Marshaller
Register marshal event callback
Marshaller.Listener
with thisMarshaller
.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 interfaceMarshaller
- Parameters:
listener
- an instance of a class that implementsMarshaller.Listener
-
getListener
public Marshaller.Listener getListener()
Description copied from interface:Marshaller
Return
Marshaller.Listener
registered with thisMarshaller
.- Specified by:
getListener
in interfaceMarshaller
- Returns:
- registered
Marshaller.Listener
ornull
if no Listener is registered with this Marshaller.
-
-