|
|
|
@ -78,21 +78,21 @@ public interface Marshaller { |
|
|
|
<tgroup cols="2"> |
|
|
|
<tgroup cols="2"> |
|
|
|
<thead> |
|
|
|
<thead> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><interfacename>javax.xml.transform.Result</interfacename> implementation</entry> |
|
|
|
<entry><interfacename>Result</interfacename> implementation</entry> |
|
|
|
<entry>Wraps XML representation</entry> |
|
|
|
<entry>Wraps XML representation</entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
</thead> |
|
|
|
</thead> |
|
|
|
<tbody> |
|
|
|
<tbody> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><classname>javax.xml.transform.dom.DOMResult</classname></entry> |
|
|
|
<entry><classname>DOMResult</classname></entry> |
|
|
|
<entry><interfacename>org.w3c.dom.Node</interfacename></entry> |
|
|
|
<entry><interfacename>org.w3c.dom.Node</interfacename></entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><classname>javax.xml.transform.sax.SAXResult</classname></entry> |
|
|
|
<entry><classname>SAXResult</classname></entry> |
|
|
|
<entry><interfacename>org.xml.sax.ContentHandler</interfacename></entry> |
|
|
|
<entry><interfacename>org.xml.sax.ContentHandler</interfacename></entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><interfacename>javax.xml.transform.stream.StreamResult</interfacename></entry> |
|
|
|
<entry><interfacename>StreamResult</interfacename></entry> |
|
|
|
<entry> |
|
|
|
<entry> |
|
|
|
<classname>java.io.File</classname>, |
|
|
|
<classname>java.io.File</classname>, |
|
|
|
<classname>java.io.OutputStream</classname>, or |
|
|
|
<classname>java.io.OutputStream</classname>, or |
|
|
|
@ -106,9 +106,9 @@ public interface Marshaller { |
|
|
|
<para> |
|
|
|
<para> |
|
|
|
Although the <methodname>marshal</methodname> method accepts a plain object as its first |
|
|
|
Although the <methodname>marshal</methodname> method accepts a plain object as its first |
|
|
|
parameter, most <classname>Marshaller</classname> implementations cannot handle arbitrary |
|
|
|
parameter, most <classname>Marshaller</classname> implementations cannot handle arbitrary |
|
|
|
objects. Instead, an object class must be mapped in a mapping file, registered with the |
|
|
|
objects. Instead, an object class must be mapped in a mapping file, marked with an annotation, |
|
|
|
marshaller, or have a common base class. Refer to the further sections in this chapter to |
|
|
|
registered with the marshaller, or have a common base class. Refer to the further sections |
|
|
|
determine how your O/X technology of choice manages this. |
|
|
|
in this chapter to determine how your O/X technology of choice manages this. |
|
|
|
</para> |
|
|
|
</para> |
|
|
|
</note> |
|
|
|
</note> |
|
|
|
</para> |
|
|
|
</para> |
|
|
|
@ -135,24 +135,24 @@ public interface Unmarshaller { |
|
|
|
<tgroup cols="2"> |
|
|
|
<tgroup cols="2"> |
|
|
|
<thead> |
|
|
|
<thead> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><interfacename>javax.xml.transform.Source</interfacename> implementation</entry> |
|
|
|
<entry><interfacename>Source</interfacename> implementation</entry> |
|
|
|
<entry>Wraps XML representation</entry> |
|
|
|
<entry>Wraps XML representation</entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
</thead> |
|
|
|
</thead> |
|
|
|
<tbody> |
|
|
|
<tbody> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><classname>javax.xml.transform.dom.DOMSource</classname></entry> |
|
|
|
<entry><classname>DOMSource</classname></entry> |
|
|
|
<entry><interfacename>org.w3c.dom.Node</interfacename></entry> |
|
|
|
<entry><interfacename>org.w3c.dom.Node</interfacename></entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><classname>javax.xml.transform.sax.SAXSource</classname></entry> |
|
|
|
<entry><classname>SAXSource</classname></entry> |
|
|
|
<entry> |
|
|
|
<entry> |
|
|
|
<classname>org.xml.sax.InputSource</classname>, and |
|
|
|
<classname>org.xml.sax.InputSource</classname>, and |
|
|
|
<interfacename>org.xml.sax.XMLReader</interfacename> |
|
|
|
<interfacename>org.xml.sax.XMLReader</interfacename> |
|
|
|
</entry> |
|
|
|
</entry> |
|
|
|
</row> |
|
|
|
</row> |
|
|
|
<row> |
|
|
|
<row> |
|
|
|
<entry><classname>javax.xml.transform.stream.StreamSource</classname></entry> |
|
|
|
<entry><classname>StreamSource</classname></entry> |
|
|
|
<entry> |
|
|
|
<entry> |
|
|
|
<classname>java.io.File</classname>, |
|
|
|
<classname>java.io.File</classname>, |
|
|
|
<classname>java.io.InputStream</classname>, or |
|
|
|
<classname>java.io.InputStream</classname>, or |
|
|
|
@ -185,13 +185,8 @@ public interface Unmarshaller { |
|
|
|
<para> |
|
|
|
<para> |
|
|
|
The O/X Mapping exception hierarchy is shown in the following figure: |
|
|
|
The O/X Mapping exception hierarchy is shown in the following figure: |
|
|
|
<mediaobject> |
|
|
|
<mediaobject> |
|
|
|
<imageobject role="fo"> |
|
|
|
<imageobject> |
|
|
|
<imagedata fileref="src/docbkx/resources/images/oxm-exceptions.svg" |
|
|
|
<imagedata fileref="images/oxm-exceptions.png" align="center"/> |
|
|
|
format="SVG" align="center"/> |
|
|
|
|
|
|
|
</imageobject> |
|
|
|
|
|
|
|
<imageobject role="html"> |
|
|
|
|
|
|
|
<imagedata fileref="images/oxm-exceptions.png" |
|
|
|
|
|
|
|
format="PNG" align="center"/> |
|
|
|
|
|
|
|
</imageobject> |
|
|
|
</imageobject> |
|
|
|
<caption> |
|
|
|
<caption> |
|
|
|
<para> |
|
|
|
<para> |
|
|
|
|