diff --git a/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java b/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java index 0a11aae2..daea4e85 100644 --- a/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java +++ b/xml/src/main/java/org/springframework/xml/validation/XmlValidator.java @@ -22,10 +22,9 @@ import javax.xml.transform.Source; import org.xml.sax.SAXParseException; /** - * Simple processor that validates a given Source. Can be created via the - * XmlValidatorFactory. + * Simple processor that validates a given {@link Source}. Can be created via the {@link XmlValidatorFactory}. *

- * XmlValidator 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 @@ import org.xml.sax.SAXParseException; public interface XmlValidator { /** - * Validates the given Source, and returns an array of SAXParseExceptions 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 SAXParseExceptions @@ -44,4 +43,4 @@ public interface XmlValidator { */ SAXParseException[] validate(Source source) throws IOException; -} +} \ No newline at end of file diff --git a/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java b/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java index 8b64c53f..8869d8d4 100644 --- a/xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java +++ b/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.util.Assert; import org.springframework.xml.JaxpVersion; /** - * Factory for XmlValidators, being aware of JAXP 1.3 XmlValidators, 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. *

* 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 XmlValidator 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 XmlValidator with the given schema resource and schema language type. The schema language - * must be one of the SCHEMA_XXX constants. + * Create a {@link XmlValidator} with the given schema resource and schema language type. The schema language must + * be one of the SCHEMA_XXX constants. * * @param schemaResource a resource that locates the schema to validate against * @param schemaLanguage the language of the schema @@ -64,8 +65,8 @@ public abstract class XmlValidatorFactory { } /** - * Create a XmlValidator with the given schema resources and schema language type. The schema language - * must be one of the SCHEMA_XXX constants. + * Create a {@link XmlValidator} with the given schema resources and schema language type. The schema language must + * be one of the SCHEMA_XXX constants. * * @param schemaResources an array of resource that locate the schemas to validate against * @param schemaLanguage the language of the schemas