diff --git a/src/docbkx/oxm.xml b/src/docbkx/oxm.xml
index e2ce51cc..298b65f7 100644
--- a/src/docbkx/oxm.xml
+++ b/src/docbkx/oxm.xml
@@ -22,7 +22,8 @@
Spring's bean factory makes it easy to configure marshallers, without needing to construct JAXB context,
JiBX binding factories, etc. The marshallers can be configured as any other bean in your application
- context.
+ context. Additionally, XML Schema-based configuration is available for a number of marshallers, making
+ the configuration even simpler.
@@ -309,6 +310,43 @@ public class Application {
]]>
+
+ XML Schema-based Configuration
+
+ Marshallers could be configured more concisely using tags from the OXM namespace.
+ To make these tags available, the appropriate schema has to be referenced first in the preamble of the XML configuration file.
+ The emboldened text in the below snippet references the OXM schema:
+
+
+
+
+]]>
+
+ Currently, the following tags are available:
+
+
+ jaxb1-marshaller
+
+
+ jaxb2-marshaller
+
+
+ xmlbeans-marshaller
+
+
+ jibx-marshaller
+
+
+
+
+ Each tag will be explained in its respective marshaller's section. As an example though, here is how
+ the configuration of a JAXB2 marshaller might look like:
+
+ ]]>
+ JAXB
@@ -345,6 +383,48 @@ public class Application {
...
]]>
+
+ XML Schema-based Configuration
+
+ The jaxb1-marshaller tag configures a org.springframework.oxm.jaxb.Jaxb1Marshaller.
+ Here is an example:
+
+ ]]>
+
+ Available attributes are:
+
+
+
+
+
+
+
+ Attribute
+ Description
+ Required
+
+
+
+
+ id
+ the id of the marshaller
+ no
+
+
+ contextPath
+ the JAXB Context path
+ yes
+
+
+ validating
+ indicates whether the incoming XML should be validated
+ no
+
+
+
+
+
+ Jaxb2Marshaller
@@ -370,6 +450,52 @@ public class Application {
...
]]>
+
+ XML Schema-based Configuration
+
+ The jaxb2-marshaller tag configures a org.springframework.oxm.jaxb.Jaxb2Marshaller.
+ Here is an example:
+
+ ]]>
+
+ Alternatively, the list of classes to bind can be provided to the marshaller via the class-to-be-bound child tag:
+
+
+
+
+ ...
+
+ ]]>
+
+ Available attributes are:
+
+
+
+
+
+
+
+ Attribute
+ Description
+ Required
+
+
+
+
+ id
+ the id of the marshaller
+ no
+
+
+ contextPath
+ the JAXB Context path
+ no
+
+
+
+
+
+
@@ -455,6 +581,44 @@ public class Application {
and not every java.lang.Object.
+
+ XML Schema-based Configuration
+
+ The xmlbeans-marshaller tag configures a org.springframework.oxm.xmlbeans.XmlBeansMarshaller.
+ Here is an example:
+
+ ]]>
+
+ Available attributes are:
+
+
+
+
+
+
+
+ Attribute
+ Description
+ Required
+
+
+
+
+ id
+ the id of the marshaller
+ no
+
+
+ options
+ the bean name of the XmlOptions that is to be used for this marshaller. Typically a
+ XmlOptionsFactoryBean definition
+ no
+
+
+
+
+
+
@@ -497,6 +661,48 @@ public class Application {
multiple classes, you have to configure multiple JibxMarshallers with
different targetClass property values.
+
+ XML Schema-based Configuration
+
+ The jibx-marshaller tag configures a org.springframework.oxm.jibx.JibxMarshaller.
+ Here is an example:
+
+ ]]>
+
+ Available attributes are:
+
+
+
+
+
+
+
+ Attribute
+ Description
+ Required
+
+
+
+
+ id
+ the id of the marshaller
+ no
+
+
+ target-class
+ the target class for this marshaller
+ yes
+
+
+ bindingName
+ the binding name used by this marshaller
+ no
+
+
+
+
+
+
@@ -538,4 +744,4 @@ public class Application {
-
\ No newline at end of file
+