org.exolab.castor.xml
public class Marshaller extends MarshalFramework
Version: $Revision: 1.4 $ $Date: 2003/05/30 02:20:25 $
| Field Summary | |
|---|---|
| int | depth
The depth of the sub tree, 0 denotes document level
|
| static boolean | enableDebug
A static flag used to enable debugging when using
the static marshal methods.
|
| Constructor Summary | |
|---|---|
| Marshaller(DocumentHandler handler)
Creates a new Marshaller with the given DocumentHandler.
| |
| Marshaller(ContentHandler handler)
Creates a new Marshaller with the given SAX ContentHandler.
| |
| Marshaller(Writer out)
Creates a new Marshaller with the given writer.
| |
| Marshaller(Node node)
Creates a new Marshaller for the given DOM Node.
| |
| Method Summary | |
|---|---|
| void | addProcessingInstruction(String target, String data)
Adds the given processing instruction data to the set of
processing instructions to output during marshalling.
|
| boolean | getMarshalExtendedType()
If True the marshaller will use the 'xsi:type' attribute
to marshall a field value that extended the defined field type.
|
| boolean | getNSPrefixAtRoot()
Returns True if the given namespace mappings will be declared at the root node. |
| String | getRootElement()
Returns the name of the root element to use |
| static void | marshal(Object object, Writer out)
Marshals the given Object as XML using the given writer |
| static void | marshal(Object object, DocumentHandler handler)
Marshals the given Object as XML using the given DocumentHandler
to send events to. |
| static void | marshal(Object object, ContentHandler handler)
Marshals the given Object as XML using the given ContentHandler
to send events to. |
| static void | marshal(Object object, Node node)
Marshals the given Object as XML using the given DOM Node
to send events to. |
| void | marshal(Object object)
Marshals the given Object as XML using the DocumentHandler
for this Marshaller. |
| void | setDebug(boolean debug)
Sets the flag to turn on and off debugging |
| void | setDoctype(String publicId, String systemId)
Sets the document type definition for the serializer. |
| void | setEncoding(String encoding)
Sets the encoding for the serializer. |
| void | setLogWriter(PrintWriter printWriter)
Sets the PrintWriter used for logging |
| void | setMapping(Mapping mapping)
Sets the given mapping to be used by the marshalling
Framework. |
| void | setMarshalAsDocument(boolean asDocument)
Sets whether or not to marshal as a document which includes
the XML declaration, and if necessary the DOCTYPE declaration.
|
| void | setMarshalExtendedType(boolean marshalExtendedType)
If True the marshaller will use the 'xsi:type' attribute
to marshall a field value that extended the defined field type.
|
| void | setMarshalListener(MarshalListener listener)
Sets an optional MarshalListener to recieve pre and post
marshal notification for each Object in the tree.
|
| void | setNamespaceMapping(String nsPrefix, String nsURI)
Sets the mapping for the given Namespace prefix |
| void | setNoNamespaceSchemaLocation(String schemaLocation)
Sets the value for the xsi:noNamespaceSchemaLocation attribute.
|
| void | setNSPrefixAtRoot(boolean nsPrefixAtRoot)
Set to True to declare the given namespace mappings at the root node. |
| void | setResolver(ClassDescriptorResolver cdr)
Sets the ClassDescriptorResolver to use during unmarshalling |
| void | setRootElement(String rootElement)
Sets the name of the root element to use |
| void | setSchemaLocation(String schemaLocation)
Sets the value for the xsi:schemaLocation attribute.
|
| void | setSuppressXSIType(boolean suppressXSIType)
Sets whether or not the xsi:type attribute should appear
on the marshalled document.
|
| void | setValidation(boolean validate)
Sets whether or not to validate the object model
before marshalling. |
Parameters: handler the DocumentHandler to "marshal" to.
Parameters: handler the ContentHandler to "marshal" to.
Parameters: out the Writer to serialize to
Parameters: node the DOM node to marshal into.
Parameters: target the processing instruction target data the processing instruction data
Returns: If True the marshaller will use the 'xsi:type' attribute to marshall a field value that extended the defined field type. Default is True.
Deprecated:
Returns True if the given namespace mappings will be declared at the root node.Returns: Returns True if the given namespace mappings will be declared at the root node.
Returns: Returns the name of the root element to use
Parameters: obj the Object to marshal out the writer to marshal to
Throws: org.exolab.castor.xml.MarshalException org.exolab.castor.xml.ValidationException
Parameters: obj the Object to marshal handler the DocumentHandler to marshal to
Throws: org.exolab.castor.xml.MarshalException org.exolab.castor.xml.ValidationException
Parameters: obj the Object to marshal handler the ContentHandler to marshal to
Throws: org.exolab.castor.xml.MarshalException org.exolab.castor.xml.ValidationException
Parameters: obj the Object to marshal node the DOM Node to marshal to
Throws: org.exolab.castor.xml.MarshalException org.exolab.castor.xml.ValidationException
Parameters: obj the Object to marshal
Throws: org.exolab.castor.xml.MarshalException org.exolab.castor.xml.ValidationException
Parameters: debug the flag indicating whether or not debug information should be generated
Parameters: publicId the public identifier systemId the system identifier
Parameters: encoding the encoding to set
Parameters: printWriter the PrintWriter to use for logging
Parameters: mapping the mapping to using during marshalling
Parameters: asDocument a boolean, when true, indicating to marshal as a complete XML document.
Parameters: listener the MarshalListener to set.
Parameters: nsPrefix the namespace prefix nsURI the namespace that the prefix resolves to
Parameters: schemaLocation the URI location of the schema to which the marshalled document is an instance of.
Deprecated:
Set to True to declare the given namespace mappings at the root node. Default is False.Parameters: nsPrefixAtRoot
Parameters: cdr the ClassDescriptorResolver to use
See Also:
Note: This method will nullify any Mapping
currently being used by this Marshaller
Parameters: The name of the root element to use
Parameters: schemaLocation the URI location of the schema to which the marshalled document is an instance of.
Parameters: suppressXSIType a boolean that when true will prevent xsi:type attribute from being used in the marshalling process.
Parameters: validate the boolean indicating whether or not to validate the object model before marshalling.