Package org.dom4j.jaxb

Class JAXBWriter

  • public class JAXBWriter
extends java.lang.Object
    Writes Elementobjects to an XML stream. Element instances can be created using the ObjectFactory that is generated by the JAXB compiler.
    See Also:
    XMLWriter, JAXBContext

    • Constructor Summary

      Constructors 
      Constructor Description
      JAXBWriter(java.lang.String contextPath)
      Creates a new JAXBWriter for the given JAXB context path.
      JAXBWriter(java.lang.String contextPath, java.lang.ClassLoader classloader)
      Creates a new JAXBWriter for the given JAXB context path, using the specified ClassLoader.
      JAXBWriter(java.lang.String contextPath, java.lang.ClassLoader classloader, OutputFormat outputFormat)
      Creates a new JAXBWriter for the given JAXB context path, using the specified ClassLoader.
      JAXBWriter(java.lang.String contextPath, OutputFormat outputFormat)
      Creates a new JAXBWriter for the given JAXB context path.

    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      void endDocument()
      Stop writing the document to the output.
      OutputFormat getOutputFormat()
      Returns the OutputFormat that will be used when writing the XML stream.
      protected Element marshal(javax.xml.bind.Element element)
      Marshals the given Elementin to its DOM4J counterpart.
      void setOutput(java.io.File file)
      Defines to write the resulting output to the specified File.
      void setOutput(java.io.OutputStream outputStream)
      Defines to write the resulting output to the specified OutputStream
      void setOutput(java.io.Writer writer)
      Defines to write the resulting output to the specified Writer.
      void startDocument()
      Start a document by writing the initial XML declaration to the output.
      protected javax.xml.bind.Element unmarshal(Element element)
      Unmarshalls the specified DOM4J Elementinto a Element
      void write(javax.xml.bind.Element jaxbObject)
      Writes the specified Elementto the document.
      void writeClose(javax.xml.bind.Element jaxbObject)
      Writes the closing tag of the specified Elementto the document.
      void writeCloseElement(Element element)
      Writes the closing tag of the specified Elementto the document.
      void writeElement(Element element)
      Writes the specified Elementto the document.
      void writeOpen(javax.xml.bind.Element jaxbObject)
      Writes the opening tag of the specified Elementto the document.
      void writeOpenElement(Element element)
      Writes the opening tag of the specified Elementto the document.

      • Methods inherited from class java.lang.Object

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

    • Constructor Detail

      • JAXBWriter

        public JAXBWriter(java.lang.String contextPath)
        Creates a new JAXBWriter for the given JAXB context path. This is the Java package where JAXB can find the generated XML classes. This package MUST contain jaxb.properties!
        Parameters:
        contextPath - JAXB context path to be used
        See Also:
        JAXBContext

      • JAXBWriter

        public JAXBWriter(java.lang.String contextPath,
                  OutputFormat outputFormat)
        Creates a new JAXBWriter for the given JAXB context path. The specied OutputFormatwill be used for writing the XML stream.
        Parameters:
        contextPath - JAXB context path to be used
        outputFormat - the DOM4J OutputFormatto be used
        See Also:
        JAXBContext

      • JAXBWriter

        public JAXBWriter(java.lang.String contextPath,
                  java.lang.ClassLoader classloader)
        Creates a new JAXBWriter for the given JAXB context path, using the specified ClassLoader. (This is the Java package where JAXB can find the generated XML classes. This package MUST contain jaxb.properties!)
        Parameters:
        contextPath - JAXB context path to be used
        classloader - the classloader to be used for loading JAXB
        See Also:
        JAXBContext

      • JAXBWriter

        public JAXBWriter(java.lang.String contextPath,
                  java.lang.ClassLoader classloader,
                  OutputFormat outputFormat)
        Creates a new JAXBWriter for the given JAXB context path, using the specified ClassLoader. The specied OutputFormat will be used while writing the XML stream.
        Parameters:
        contextPath - JAXB context path to be used
        classloader - the class loader to be used to load JAXB
        outputFormat - the DOM4J OutputFormatto be used
        See Also:
        JAXBContext

    • Method Detail

      • getOutputFormat

        public OutputFormat getOutputFormat()
        Returns the OutputFormat that will be used when writing the XML stream.
        Returns:
        Returns the output format.

      • setOutput

        public void setOutput(java.io.File file)
               throws java.io.IOException
        Defines to write the resulting output to the specified File.
        Parameters:
        file - file to write to
        Throws:
        java.io.IOException - when the file cannot be found

      • setOutput

        public void setOutput(java.io.OutputStream outputStream)
               throws java.io.IOException
        Defines to write the resulting output to the specified OutputStream
        Parameters:
        outputStream - outputStream to write to.
        Throws:
        java.io.IOException - DOCUMENT ME!

      • setOutput

        public void setOutput(java.io.Writer writer)
               throws java.io.IOException
        Defines to write the resulting output to the specified Writer.
        Parameters:
        writer - writer to write to
        Throws:
        java.io.IOException - DOCUMENT ME!

      • startDocument

        public void startDocument()
                   throws java.io.IOException,
                          org.xml.sax.SAXException
        Start a document by writing the initial XML declaration to the output. This must be done prior to writing any other elements.
        Throws:
        java.io.IOException - if an error occured while writing the output
        org.xml.sax.SAXException - thrown by the underlying SAX driver

      • endDocument

        public void endDocument()
                 throws java.io.IOException,
                        org.xml.sax.SAXException
        Stop writing the document to the output. This must be done when all other elements are finished.
        Throws:
        java.io.IOException - if an error occured while writing the output
        org.xml.sax.SAXException - thrown by the underlying SAX driver

      • write

        public void write(javax.xml.bind.Element jaxbObject)
           throws java.io.IOException,
                  javax.xml.bind.JAXBException
        Writes the specified Elementto the document. Elementinstances can be created using the ObjectFactory that is generated by the JAXB compiler.
        Parameters:
        jaxbObject - DOCUMENT ME!
        Throws:
        java.io.IOException - if an error occured while writing the output
        javax.xml.bind.JAXBException - when an error occured while marshalling the jaxbObject

      • writeClose

        public void writeClose(javax.xml.bind.Element jaxbObject)
                throws java.io.IOException,
                       javax.xml.bind.JAXBException
        Writes the closing tag of the specified Elementto the document. This method can be used for writing Element instances can be created using the ObjectFactory that is generated by the JAXB compiler.
        Parameters:
        jaxbObject - the JAXB element to write
        Throws:
        java.io.IOException - if an error occured while writing the output
        javax.xml.bind.JAXBException - when an error occured while marshalling the jaxbObject

      • writeOpen

        public void writeOpen(javax.xml.bind.Element jaxbObject)
               throws java.io.IOException,
                      javax.xml.bind.JAXBException
        Writes the opening tag of the specified Elementto the document. Elementinstances can be created using the ObjectFactory that is generated by the JAXB compiler.
        Parameters:
        jaxbObject - the JAXB element to write
        Throws:
        java.io.IOException - if an error occured while writing the output
        javax.xml.bind.JAXBException - when an error occured while marshalling the jaxbObject

      • writeElement

        public void writeElement(Element element)
                  throws java.io.IOException
        Writes the specified Elementto the document.
        Parameters:
        element - the Elementto write
        Throws:
        java.io.IOException - if an error occured while writing the output

      • writeCloseElement

        public void writeCloseElement(Element element)
                       throws java.io.IOException
        Writes the closing tag of the specified Elementto the document.
        Parameters:
        element - the Elementto write
        Throws:
        java.io.IOException - if an error occured while writing the output

      • writeOpenElement

        public void writeOpenElement(Element element)
                      throws java.io.IOException
        Writes the opening tag of the specified Elementto the document.
        Parameters:
        element - the Elementto write
        Throws:
        java.io.IOException - if an error occured while writing the output

      • marshal

        protected Element marshal(javax.xml.bind.Element element)
                   throws javax.xml.bind.JAXBException
        Marshals the given Elementin to its DOM4J counterpart.
        Parameters:
        element - JAXB Element to be marshalled
        Returns:
        the marshalled DOM4J Element
        Throws:
        javax.xml.bind.JAXBException - when an error occurs

      • unmarshal

        protected javax.xml.bind.Element unmarshal(Element element)
                                    throws javax.xml.bind.JAXBException
        Unmarshalls the specified DOM4J Elementinto a Element
        Parameters:
        element - the DOM4J element to unmarshall
        Returns:
        the unmarshalled JAXB object
        Throws:
        javax.xml.bind.JAXBException - when an error occurs