diff --git a/oxm/src/main/java/org/springframework/oxm/AbstractMarshaller.java b/oxm/src/main/java/org/springframework/oxm/AbstractMarshaller.java
index b719a5c2..3fffc36b 100644
--- a/oxm/src/main/java/org/springframework/oxm/AbstractMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/AbstractMarshaller.java
@@ -56,6 +56,7 @@ import org.xml.sax.helpers.XMLReaderFactory;
* methods.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class AbstractMarshaller implements Marshaller, Unmarshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/GenericMarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/GenericMarshallingFailureException.java
index 4e1985ec..5fab0a26 100644
--- a/oxm/src/main/java/org/springframework/oxm/GenericMarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/GenericMarshallingFailureException.java
@@ -15,26 +15,22 @@
*/
package org.springframework.oxm;
-
/**
* Base class for exception thrown when a marshalling or unmarshalling error occurs.
- *
+ *
* @author Arjen Poutsma
* @see MarshallingFailureException
* @see UnmarshallingFailureException
+ * @since 1.0
*/
public abstract class GenericMarshallingFailureException extends XmlMappingException {
- /**
- * Constructor for GenericMarshallingFailureException.
- */
+ /** Constructor for GenericMarshallingFailureException. */
public GenericMarshallingFailureException(String msg) {
super(msg);
}
- /**
- * Constructor for GenericMarshallingFailureException.
- */
+ /** Constructor for GenericMarshallingFailureException. */
public GenericMarshallingFailureException(String msg, Throwable ex) {
super(msg, ex);
}
diff --git a/oxm/src/main/java/org/springframework/oxm/Marshaller.java b/oxm/src/main/java/org/springframework/oxm/Marshaller.java
index 99bac694..5562bf96 100644
--- a/oxm/src/main/java/org/springframework/oxm/Marshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/Marshaller.java
@@ -27,6 +27,7 @@ import javax.xml.transform.Result;
* class must be registered with the marshaller, or have a common base class.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public interface Marshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/MarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/MarshallingFailureException.java
index 0fc2ace5..2b46fbda 100644
--- a/oxm/src/main/java/org/springframework/oxm/MarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/MarshallingFailureException.java
@@ -15,13 +15,14 @@
*/
package org.springframework.oxm;
-
/**
* Exception thrown on marshalling failure.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class MarshallingFailureException extends GenericMarshallingFailureException {
+
/**
* Construct a MarshallingFailureException with the specified detail message.
*
diff --git a/oxm/src/main/java/org/springframework/oxm/UncategorizedXmlMappingException.java b/oxm/src/main/java/org/springframework/oxm/UncategorizedXmlMappingException.java
index cea72338..9f994dcd 100644
--- a/oxm/src/main/java/org/springframework/oxm/UncategorizedXmlMappingException.java
+++ b/oxm/src/main/java/org/springframework/oxm/UncategorizedXmlMappingException.java
@@ -15,17 +15,15 @@
*/
package org.springframework.oxm;
-
/**
* Superclass for exceptions that cannot be distinguished further.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class UncategorizedXmlMappingException extends XmlMappingException {
- /**
- * Constructor for UncategorizedXmlMappingException.
- */
+ /** Constructor for UncategorizedXmlMappingException. */
protected UncategorizedXmlMappingException(String msg, Throwable ex) {
super(msg, ex);
}
diff --git a/oxm/src/main/java/org/springframework/oxm/Unmarshaller.java b/oxm/src/main/java/org/springframework/oxm/Unmarshaller.java
index 951f8e09..114fc143 100644
--- a/oxm/src/main/java/org/springframework/oxm/Unmarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/Unmarshaller.java
@@ -20,11 +20,11 @@ import javax.xml.transform.Source;
/**
* Defines the contract for Object XML Mapping unmarshallers.
- *
- *
Implementations of this interface can deserialize a given XML Stream to an - * Object graph. + *
+ *Implementations of this interface can deserialize a given XML Stream to an Object graph.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public interface Unmarshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/UnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/UnmarshallingFailureException.java
index 8c98b0b0..bb2c4102 100644
--- a/oxm/src/main/java/org/springframework/oxm/UnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/UnmarshallingFailureException.java
@@ -19,19 +19,16 @@ package org.springframework.oxm;
* Exception thrown on unmarshalling failure.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class UnmarshallingFailureException extends GenericMarshallingFailureException {
- /**
- * Constructor for UnmarshallingFailureException.
- */
+ /** Constructor for UnmarshallingFailureException. */
public UnmarshallingFailureException(String msg) {
super(msg);
}
- /**
- * Constructor for UnmarshallingFailureException.
- */
+ /** Constructor for UnmarshallingFailureException. */
public UnmarshallingFailureException(String msg, Throwable ex) {
super(msg, ex);
}
diff --git a/oxm/src/main/java/org/springframework/oxm/ValidationFailureException.java b/oxm/src/main/java/org/springframework/oxm/ValidationFailureException.java
index 1d9f1533..969045d2 100644
--- a/oxm/src/main/java/org/springframework/oxm/ValidationFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/ValidationFailureException.java
@@ -19,19 +19,16 @@ package org.springframework.oxm;
* Exception thrown on marshalling validation failure.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class ValidationFailureException extends XmlMappingException {
- /**
- * Constructor for ValidationFailureException.
- */
+ /** Constructor for ValidationFailureException. */
public ValidationFailureException(String msg) {
super(msg);
}
- /**
- * Constructor for ValidationFailureException.
- */
+ /** Constructor for ValidationFailureException. */
public ValidationFailureException(String msg, Throwable ex) {
super(msg, ex);
}
diff --git a/oxm/src/main/java/org/springframework/oxm/XmlMappingException.java b/oxm/src/main/java/org/springframework/oxm/XmlMappingException.java
index 14cf87aa..8428e008 100644
--- a/oxm/src/main/java/org/springframework/oxm/XmlMappingException.java
+++ b/oxm/src/main/java/org/springframework/oxm/XmlMappingException.java
@@ -21,19 +21,16 @@ import org.springframework.xml.XmlException;
* Root of the hierarchy of Object XML Mapping exceptions.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class XmlMappingException extends XmlException {
- /**
- * Constructor for XmlMappingException.
- */
+ /** Constructor for XmlMappingException. */
public XmlMappingException(String msg) {
super(msg);
}
- /**
- * Constructor for XmlMappingException.
- */
+ /** Constructor for XmlMappingException. */
public XmlMappingException(String msg, Throwable ex) {
super(msg, ex);
}
diff --git a/oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java b/oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java
index c1cd4fcf..6961028a 100644
--- a/oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/castor/CastorMarshaller.java
@@ -73,6 +73,7 @@ import org.xml.sax.ext.LexicalHandler;
* @see #setTargetClass(Class)
* @see #setMappingLocation(org.springframework.core.io.Resource)
* @see #setMappingLocations(org.springframework.core.io.Resource[])
+ * @since 1.0
*/
public class CastorMarshaller extends AbstractMarshaller implements InitializingBean {
@@ -95,33 +96,27 @@ public class CastorMarshaller extends AbstractMarshaller implements Initializing
private boolean ignoreExtraElements = false;
- /**
- * Returns whether the Castor {@link Unmarshaller} should ignore attributes that do not match
- * a specific field.
- */
+ /** Returns whether the Castor {@link Unmarshaller} should ignore attributes that do not match a specific field. */
public boolean getIgnoreExtraAttributes() {
return ignoreExtraAttributes;
}
/**
- * Sets whether the Castor {@link Unmarshaller} should ignore attributes that do not match
- * a specific field. Default is true: extra attributes are ignored.
+ * Sets whether the Castor {@link Unmarshaller} should ignore attributes that do not match a specific field.
+ * Default is true: extra attributes are ignored.
*/
public void setIgnoreExtraAttributes(boolean ignoreExtraAttributes) {
this.ignoreExtraAttributes = ignoreExtraAttributes;
}
- /**
- * Returns whether the Castor {@link Unmarshaller} should ignore elements that do not match
- * a specific field.
- */
+ /** Returns whether the Castor {@link Unmarshaller} should ignore elements that do not match a specific field. */
public boolean getIgnoreExtraElements() {
return ignoreExtraElements;
}
/**
- * Sets whether the Castor {@link Unmarshaller} should ignore elements that do not match
- * a specific field. Default is false, extra attributes are flagged as an error.
+ * Sets whether the Castor {@link Unmarshaller} should ignore elements that do not match a specific field. Default
+ * is false, extra attributes are flagged as an error.
*/
public void setIgnoreExtraElements(boolean ignoreExtraElements) {
this.ignoreExtraElements = ignoreExtraElements;
@@ -346,10 +341,9 @@ public class CastorMarshaller extends AbstractMarshaller implements Initializing
/**
* Template method that allows for customizing of the given Castor {@link Unmarshaller}.
*
UncategorizedXmlMappingException, for Castor exceptions that cannot be
* distinguished further.
- *
+ *
* @author Arjen Poutsma
+ * @since 1.0
*/
public class CastorSystemException extends UncategorizedXmlMappingException {
diff --git a/oxm/src/main/java/org/springframework/oxm/castor/CastorUnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/castor/CastorUnmarshallingFailureException.java
index 551389b1..e8f35649 100644
--- a/oxm/src/main/java/org/springframework/oxm/castor/CastorUnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/castor/CastorUnmarshallingFailureException.java
@@ -16,15 +16,15 @@
package org.springframework.oxm.castor;
import org.exolab.castor.xml.MarshalException;
-import org.xml.sax.SAXException;
-
import org.springframework.oxm.UnmarshallingFailureException;
+import org.xml.sax.SAXException;
/**
* Castor-specific subclass of UnmarshallingFailureException.
*
* @author Arjen Poutsma
* @see CastorUtils#convertXmlException
+ * @since 1.0
*/
public class CastorUnmarshallingFailureException extends UnmarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/castor/CastorUtils.java b/oxm/src/main/java/org/springframework/oxm/castor/CastorUtils.java
index c45057b6..d8ae1131 100644
--- a/oxm/src/main/java/org/springframework/oxm/castor/CastorUtils.java
+++ b/oxm/src/main/java/org/springframework/oxm/castor/CastorUtils.java
@@ -18,13 +18,13 @@ package org.springframework.oxm.castor;
import org.exolab.castor.xml.MarshalException;
import org.exolab.castor.xml.ValidationException;
import org.exolab.castor.xml.XMLException;
-
import org.springframework.oxm.XmlMappingException;
/**
* Generic utility methods for working with Castor. Mainly for internal use within the framework.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class CastorUtils {
diff --git a/oxm/src/main/java/org/springframework/oxm/castor/CastorValidationFailureException.java b/oxm/src/main/java/org/springframework/oxm/castor/CastorValidationFailureException.java
index 31de863f..ddced21a 100644
--- a/oxm/src/main/java/org/springframework/oxm/castor/CastorValidationFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/castor/CastorValidationFailureException.java
@@ -16,7 +16,6 @@
package org.springframework.oxm.castor;
import org.exolab.castor.xml.ValidationException;
-
import org.springframework.oxm.ValidationFailureException;
/**
@@ -24,6 +23,7 @@ import org.springframework.oxm.ValidationFailureException;
*
* @author Arjen Poutsma
* @see CastorUtils#convertXmlException
+ * @since 1.0
*/
public class CastorValidationFailureException extends ValidationFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/AbstractJaxbMarshaller.java b/oxm/src/main/java/org/springframework/oxm/jaxb/AbstractJaxbMarshaller.java
index e9c8649a..b9f08097 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/AbstractJaxbMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/AbstractJaxbMarshaller.java
@@ -39,6 +39,7 @@ import org.springframework.oxm.XmlMappingException;
* @author Arjen Poutsma
* @see Jaxb1Marshaller
* @see Jaxb2Marshaller
+ * @since 1.0
*/
public abstract class AbstractJaxbMarshaller
implements org.springframework.oxm.Marshaller, org.springframework.oxm.Unmarshaller, InitializingBean {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/Jaxb1Marshaller.java b/oxm/src/main/java/org/springframework/oxm/jaxb/Jaxb1Marshaller.java
index 6e2be20b..b5777b65 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/Jaxb1Marshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/Jaxb1Marshaller.java
@@ -36,6 +36,7 @@ import org.springframework.util.StringUtils;
* @see #setMarshallerProperties(java.util.Map)
* @see #setUnmarshallerProperties(java.util.Map)
* @see #setValidating(boolean)
+ * @since 1.0
*/
public class Jaxb1Marshaller extends AbstractJaxbMarshaller implements InitializingBean {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbMarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbMarshallingFailureException.java
index e5c71aa6..f07818df 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbMarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbMarshallingFailureException.java
@@ -24,6 +24,7 @@ import org.springframework.oxm.MarshallingFailureException;
*
* @author Arjen Poutsma
* @see JaxbUtils#convertJaxbException
+ * @since 1.0
*/
public class JaxbMarshallingFailureException extends MarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbSystemException.java b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbSystemException.java
index d7a2b85f..95d36b84 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbSystemException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbSystemException.java
@@ -24,7 +24,8 @@ import org.springframework.oxm.UncategorizedXmlMappingException;
* be distinguished further.
*
* @author Arjen Poutsma
- * @see JaxbUtils#convertJaxbException(javax.xml.bind.JAXBException)
+ * @see JaxbUtils#convertJaxbException(javax.xml.bind.JAXBException)
+ * @since 1.0
*/
public class JaxbSystemException extends UncategorizedXmlMappingException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUnmarshallingFailureException.java
index 8b0c6a00..b5d69573 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUnmarshallingFailureException.java
@@ -24,6 +24,7 @@ import org.springframework.oxm.UnmarshallingFailureException;
* JAXB-specific subclass of UnmarshallingFailureException.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class JaxbUnmarshallingFailureException extends UnmarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUtils.java b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUtils.java
index 9e269934..4b35d9b3 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUtils.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbUtils.java
@@ -27,6 +27,7 @@ import org.springframework.util.ClassUtils;
* Generic utility methods for working with JAXB. Mainly for internal use within the framework.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class JaxbUtils {
diff --git a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbValidationFailureException.java b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbValidationFailureException.java
index 7c96d988..c2e50096 100644
--- a/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbValidationFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jaxb/JaxbValidationFailureException.java
@@ -24,6 +24,7 @@ import org.springframework.oxm.ValidationFailureException;
*
* @author Arjen Poutsma
* @see JaxbUtils#convertJaxbException
+ * @since 1.0
*/
public class JaxbValidationFailureException extends ValidationFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshaller.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshaller.java
index d13555d0..f36f68cd 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshaller.java
@@ -71,6 +71,7 @@ import org.xml.sax.ext.LexicalHandler;
* @author Arjen Poutsma
* @see org.jibx.runtime.IMarshallingContext
* @see org.jibx.runtime.IUnmarshallingContext
+ * @since 1.0
*/
public class JibxMarshaller extends AbstractMarshaller implements InitializingBean {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshallingFailureException.java
index 4fbf894d..94521565 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxMarshallingFailureException.java
@@ -17,14 +17,14 @@
package org.springframework.oxm.jibx;
import org.jibx.runtime.JiBXException;
-
import org.springframework.oxm.MarshallingFailureException;
/**
* JiXB-specific subclass of MarshallingFailureException.
*
* @author Arjen Poutsma
- * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException, boolean)
+ * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException,boolean)
+ * @since 1.0
*/
public class JibxMarshallingFailureException extends MarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxSystemException.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxSystemException.java
index 0dabff7a..9256d876 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxSystemException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxSystemException.java
@@ -23,7 +23,8 @@ import org.springframework.oxm.UncategorizedXmlMappingException;
* be distinguished further.
*
* @author Arjen Poutsma
- * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException, boolean)
+ * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException,boolean)
+ * @since 1.0
*/
public class JibxSystemException extends UncategorizedXmlMappingException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxUnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxUnmarshallingFailureException.java
index 539d487c..b24be0ca 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxUnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxUnmarshallingFailureException.java
@@ -17,14 +17,14 @@
package org.springframework.oxm.jibx;
import org.jibx.runtime.JiBXException;
-
import org.springframework.oxm.UnmarshallingFailureException;
/**
* JiXB-specific subclass of UnmarshallingFailureException.
*
* @author Arjen Poutsma
- * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException, boolean)
+ * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException,boolean)
+ * @since 1.0
*/
public class JibxUnmarshallingFailureException extends UnmarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxUtils.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxUtils.java
index 23bd4c6d..6dd63d92 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxUtils.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxUtils.java
@@ -18,13 +18,13 @@ package org.springframework.oxm.jibx;
import org.jibx.runtime.JiBXException;
import org.jibx.runtime.ValidationException;
-
import org.springframework.oxm.XmlMappingException;
/**
* Generic utility methods for working with JiBX. Mainly for internal use within the framework.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class JibxUtils {
diff --git a/oxm/src/main/java/org/springframework/oxm/jibx/JibxValidationFailureException.java b/oxm/src/main/java/org/springframework/oxm/jibx/JibxValidationFailureException.java
index 7fd0034e..deeac0b4 100644
--- a/oxm/src/main/java/org/springframework/oxm/jibx/JibxValidationFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/jibx/JibxValidationFailureException.java
@@ -17,14 +17,14 @@
package org.springframework.oxm.jibx;
import org.jibx.runtime.ValidationException;
-
import org.springframework.oxm.ValidationFailureException;
/**
* JAXB-specific subclass of ValidationFailureException.
*
* @author Arjen Poutsma
- * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException, boolean)
+ * @see JibxUtils#convertJibxException(org.jibx.runtime.JiBXException,boolean)
+ * @since 1.0
*/
public class JibxValidationFailureException extends ValidationFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/mime/MimeContainer.java b/oxm/src/main/java/org/springframework/oxm/mime/MimeContainer.java
index 12c2cef8..372ec210 100644
--- a/oxm/src/main/java/org/springframework/oxm/mime/MimeContainer.java
+++ b/oxm/src/main/java/org/springframework/oxm/mime/MimeContainer.java
@@ -23,6 +23,7 @@ import javax.activation.DataHandler;
*
* @author Arjen Poutsma
* @see XML-binary Optimized Packaging
+ * @since 1.0
*/
public interface MimeContainer {
diff --git a/oxm/src/main/java/org/springframework/oxm/mime/MimeMarshaller.java b/oxm/src/main/java/org/springframework/oxm/mime/MimeMarshaller.java
index 71ee95c6..09d4676f 100644
--- a/oxm/src/main/java/org/springframework/oxm/mime/MimeMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/mime/MimeMarshaller.java
@@ -30,6 +30,7 @@ import org.springframework.oxm.XmlMappingException;
* @see SOAP Message Transmission Optimization
* Mechanism
* @see XML-binary Optimized Packaging
+ * @since 1.0
*/
public interface MimeMarshaller extends Marshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/mime/MimeUnmarshaller.java b/oxm/src/main/java/org/springframework/oxm/mime/MimeUnmarshaller.java
index c19c4a9a..bdd83acf 100644
--- a/oxm/src/main/java/org/springframework/oxm/mime/MimeUnmarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/mime/MimeUnmarshaller.java
@@ -30,6 +30,7 @@ import org.springframework.oxm.XmlMappingException;
* @see SOAP Message Transmission Optimization
* Mechanism
* @see XML-binary Optimized Packaging
+ * @since 1.0
*/
public interface MimeUnmarshaller extends Unmarshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/support/MarshallingSource.java b/oxm/src/main/java/org/springframework/oxm/support/MarshallingSource.java
index c8975547..d043eeaf 100644
--- a/oxm/src/main/java/org/springframework/oxm/support/MarshallingSource.java
+++ b/oxm/src/main/java/org/springframework/oxm/support/MarshallingSource.java
@@ -40,6 +40,7 @@ import org.xml.sax.SAXParseException;
*
* @author Arjen Poutsma
* @see javax.xml.transform.Transformer
+ * @since 1.0
*/
public class MarshallingSource extends SAXSource {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshaller.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshaller.java
index 77b23981..cc8511ec 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshaller.java
@@ -38,12 +38,11 @@ import org.xml.sax.ext.LexicalHandler;
/**
* Implementation of the {@link Marshaller} interface for XMLBeans. Further options can be set by setting the
- * xmlOptions property. The {@link XmlOptionsFactoryBean} is provided to easily wire up
- * {@link XmlOptions} instances.
+ * xmlOptions property. The {@link XmlOptionsFactoryBean} is provided to easily wire up {@link XmlOptions}
+ * instances.
*
- * Unmarshalled objects can be validated by setting the validating property, or by calling the
- * {@link #validate(XmlObject)} method directly. Invalid objects will result in an
- * {@link XmlBeansValidationFailureException}.
+ * Unmarshalled objects can be validated by setting the validating property, or by calling the {@link
+ * #validate(XmlObject)} method directly. Invalid objects will result in an {@link XmlBeansValidationFailureException}.
*
* Note that due to the nature of XMLBeans, this marshaller requires all passed objects to be of type
* {@link XmlObject}.
@@ -52,6 +51,7 @@ import org.xml.sax.ext.LexicalHandler;
* @see #setXmlOptions(org.apache.xmlbeans.XmlOptions)
* @see XmlOptionsFactoryBean
* @see #setValidating(boolean)
+ * @since 1.0
*/
public class XmlBeansMarshaller extends AbstractMarshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshallingFailureException.java
index 836f8212..8e259072 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansMarshallingFailureException.java
@@ -16,15 +16,15 @@
package org.springframework.oxm.xmlbeans;
import org.apache.xmlbeans.XmlException;
-import org.xml.sax.SAXException;
-
import org.springframework.oxm.MarshallingFailureException;
+import org.xml.sax.SAXException;
/**
* XMLBeans-specific subclass of MarshallingFailureException.
*
* @author Arjen Poutsma
- * @see XmlBeansUtils#convertXmlBeansException(Exception, boolean)
+ * @see XmlBeansUtils#convertXmlBeansException(Exception,boolean)
+ * @since 1.0
*/
public class XmlBeansMarshallingFailureException extends MarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansSystemException.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansSystemException.java
index 2010edc8..823d24ab 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansSystemException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansSystemException.java
@@ -18,10 +18,11 @@ package org.springframework.oxm.xmlbeans;
import org.springframework.oxm.UncategorizedXmlMappingException;
/**
- * XMLBeans-specific subclass of UncategorizedXmlMappingException, for XMLBeans exceptions that cannot
- * be distinguished further.
- *
+ * XMLBeans-specific subclass of UncategorizedXmlMappingException, for XMLBeans exceptions that cannot be
+ * distinguished further.
+ *
* @author Arjen Poutsma
+ * @since 1.0
*/
public class XmlBeansSystemException extends UncategorizedXmlMappingException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUnmarshallingFailureException.java
index 33fbd656..22f72e72 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUnmarshallingFailureException.java
@@ -16,15 +16,15 @@
package org.springframework.oxm.xmlbeans;
import org.apache.xmlbeans.XmlException;
-import org.xml.sax.SAXException;
-
import org.springframework.oxm.UnmarshallingFailureException;
+import org.xml.sax.SAXException;
/**
* XMLBeans-specific subclass of UnmarshallingFailureException.
*
* @author Arjen Poutsma
- * @see XmlBeansUtils#convertXmlBeansException(Exception, boolean)
+ * @see XmlBeansUtils#convertXmlBeansException(Exception,boolean)
+ * @since 1.0
*/
public class XmlBeansUnmarshallingFailureException extends UnmarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUtils.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUtils.java
index 1644f010..3d665472 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUtils.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansUtils.java
@@ -17,14 +17,14 @@ package org.springframework.oxm.xmlbeans;
import org.apache.xmlbeans.XMLStreamValidationException;
import org.apache.xmlbeans.XmlException;
-import org.xml.sax.SAXException;
-
import org.springframework.oxm.XmlMappingException;
+import org.xml.sax.SAXException;
/**
* Generic utility methods for working with XMLBeans. Mainly for internal use within the framework.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class XmlBeansUtils {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansValidationFailureException.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansValidationFailureException.java
index c7fff246..7a76480c 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansValidationFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlBeansValidationFailureException.java
@@ -17,7 +17,6 @@ package org.springframework.oxm.xmlbeans;
import org.apache.xmlbeans.XMLStreamValidationException;
import org.apache.xmlbeans.XmlException;
-
import org.springframework.oxm.ValidationFailureException;
/**
@@ -25,6 +24,7 @@ import org.springframework.oxm.ValidationFailureException;
*
* @author Arjen Poutsma
* @see org.springframework.oxm.xmlbeans.XmlBeansUtils#convertXmlBeansException
+ * @since 1.0
*/
public class XmlBeansValidationFailureException extends ValidationFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlOptionsFactoryBean.java b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlOptionsFactoryBean.java
index 04897bae..73bc4051 100644
--- a/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlOptionsFactoryBean.java
+++ b/oxm/src/main/java/org/springframework/oxm/xmlbeans/XmlOptionsFactoryBean.java
@@ -20,7 +20,6 @@ import java.util.Iterator;
import java.util.Map;
import org.apache.xmlbeans.XmlOptions;
-
import org.springframework.beans.factory.FactoryBean;
import org.springframework.beans.factory.InitializingBean;
@@ -33,6 +32,7 @@ import org.springframework.beans.factory.InitializingBean;
* @see XmlOptions
* @see #setOptions(java.util.Map)
* @see XmlBeansMarshaller#setXmlOptions(org.apache.xmlbeans.XmlOptions)
+ * @since 1.0
*/
public class XmlOptionsFactoryBean implements FactoryBean, InitializingBean {
@@ -40,23 +40,17 @@ public class XmlOptionsFactoryBean implements FactoryBean, InitializingBean {
private Map options;
- /**
- * Returns the singleton XmlOptions.
- */
+ /** Returns the singleton XmlOptions. */
public Object getObject() throws Exception {
return xmlOptions;
}
- /**
- * Returns the class of XmlOptions.
- */
+ /** Returns the class of XmlOptions. */
public Class getObjectType() {
return XmlOptions.class;
}
- /**
- * Returns true.
- */
+ /** Returns true. */
public boolean isSingleton() {
return true;
}
@@ -65,7 +59,7 @@ public class XmlOptionsFactoryBean implements FactoryBean, InitializingBean {
* Sets options on the underlying XmlOptions object. The keys of the supplied map should be one of the
* string constants defined in XmlOptions, the values vary per option.
*
- * @see XmlOptions#put(Object, Object)
+ * @see XmlOptions#put(Object,Object)
* @see XmlOptions#SAVE_PRETTY_PRINT
* @see XmlOptions#LOAD_STRIP_COMMENTS
*/
diff --git a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshaller.java b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshaller.java
index cb50f026..64ae0187 100644
--- a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshaller.java
+++ b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshaller.java
@@ -74,6 +74,7 @@ import org.xml.sax.ext.LexicalHandler;
* @see #DEFAULT_ENCODING
* @see #setAliases(Map)
* @see #setConverters(ConverterMatcher[])
+ * @since 1.0
*/
public class XStreamMarshaller extends AbstractMarshaller {
diff --git a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshallingFailureException.java
index 4410e369..a6dfabfa 100644
--- a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamMarshallingFailureException.java
@@ -19,13 +19,13 @@ package org.springframework.oxm.xstream;
import com.thoughtworks.xstream.alias.CannotResolveClassException;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.io.StreamException;
-
import org.springframework.oxm.MarshallingFailureException;
/**
* XStream-specific subclass of MarshallingFailureException.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class XStreamMarshallingFailureException extends MarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamSystemException.java b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamSystemException.java
index f1247f86..2b80eea8 100644
--- a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamSystemException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamSystemException.java
@@ -23,6 +23,7 @@ import org.springframework.oxm.UncategorizedXmlMappingException;
* distinguished further.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class XStreamSystemException extends UncategorizedXmlMappingException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUnmarshallingFailureException.java b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUnmarshallingFailureException.java
index 36a28030..3cfafc93 100644
--- a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUnmarshallingFailureException.java
+++ b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUnmarshallingFailureException.java
@@ -21,13 +21,13 @@ import javax.xml.stream.XMLStreamException;
import com.thoughtworks.xstream.alias.CannotResolveClassException;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.io.StreamException;
-
import org.springframework.oxm.UnmarshallingFailureException;
/**
* XStream-specific subclass of UnmarshallingFailureException.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public class XStreamUnmarshallingFailureException extends UnmarshallingFailureException {
diff --git a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUtils.java b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUtils.java
index 5c1bda75..b5ad1d4f 100644
--- a/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUtils.java
+++ b/oxm/src/main/java/org/springframework/oxm/xstream/XStreamUtils.java
@@ -19,13 +19,13 @@ package org.springframework.oxm.xstream;
import com.thoughtworks.xstream.alias.CannotResolveClassException;
import com.thoughtworks.xstream.converters.ConversionException;
import com.thoughtworks.xstream.io.StreamException;
-
import org.springframework.oxm.XmlMappingException;
/**
* Generic utility methods for working with XStream. Mainly for internal use within the framework.
*
* @author Arjen Poutsma
+ * @since 1.0
*/
public abstract class XStreamUtils {