Javadoc

Author: poutsma

xml/src/main/java/org/springframework/xml/validation/XmlValidator.java

@@ -22,10 +22,9 @@
 import org.xml.sax.SAXParseException;
 
 /**
- * Simple processor that validates a given <code>Source</code>. Can be created via the
- * <code>XmlValidatorFactory</code>.
+ * Simple processor that validates a given {@link Source}. Can be created via the {@link XmlValidatorFactory}.
  * <p/>
- * <code>XmlValidator</code> instances are designed to be thread safe.
+ * Instances of this class are designed to be thread safe.
  *
  * @author Arjen Poutsma
  * @see XmlValidatorFactory#createValidator(org.springframework.core.io.Resource,String)
@@ -34,8 +33,8 @@
 public interface XmlValidator {
 
     /**
-     * Validates the given <code>Source</code>, and returns an array of <code>SAXParseException</code>s as result. The
-     * array will be empty if no validation errors are found.
+     * Validates the given {@link Source}, and returns an array of {@link SAXParseException}s as result. The array will
+     * be empty if no validation errors are found.
      *
      * @param source the input document
      * @return an array of <code>SAXParseException</code>s
@@ -44,4 +43,4 @@ public interface XmlValidator {
      */
     SAXParseException[] validate(Source source) throws IOException;
 
-}
+}

xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java

@@ -17,6 +17,7 @@
 package org.springframework.xml.validation;
 
 import java.io.IOException;
+import javax.xml.validation.Validator;
 
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
@@ -25,11 +26,11 @@
 import org.springframework.xml.JaxpVersion;
 
 /**
- * Factory for <code>XmlValidator</code>s, being aware of JAXP 1.3 <code>XmlValidator</code>s, and JAXP 1.0 parsing
+ * Factory for {@link XmlValidator} objects, being aware of JAXP 1.3 {@link Validator}s, and JAXP 1.0 parsing
  * capababilities. Mainly for internal use within the framework.
  * <p/>
  * The goal of this class is to avoid runtime dependencies on JAXP 1.3 by using the best validation implementation that
- * is available. Prefers JAXP 1.3 <code>XmlValidator</code> implementations to a custom, SAX-based implementation.
+ * is available. Prefers JAXP 1.3 {@link XmlValidator} implementations to a custom, SAX-based implementation.
  *
  * @author Arjen Poutsma
  * @see XmlValidator
@@ -46,8 +47,8 @@ public abstract class XmlValidatorFactory {
     public static final String SCHEMA_RELAX_NG = "http://relaxng.org/ns/structure/1.0";
 
     /**
-     * Create a <code>XmlValidator</code> with the given schema resource and schema language type. The schema language
-     * must be one of the <code>SCHEMA_XXX</code> constants.
+     * Create a {@link XmlValidator} with the given schema resource and schema language type. The schema language must
+     * be one of the <code>SCHEMA_XXX</code> constants.
      *
      * @param schemaResource a resource that locates the schema to validate against
      * @param schemaLanguage the language of the schema
@@ -64,8 +65,8 @@ public static XmlValidator createValidator(Resource schemaResource, String schem
     }
 
     /**
-     * Create a <code>XmlValidator</code> with the given schema resources and schema language type. The schema language
-     * must be one of the <code>SCHEMA_XXX</code> constants.
+     * Create a {@link XmlValidator} with the given schema resources and schema language type. The schema language must
+     * be one of the <code>SCHEMA_XXX</code> constants.
      *
      * @param schemaResources an array of resource that locate the schemas to validate against
      * @param schemaLanguage  the language of the schemas