Spring/spring-ws
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Javadoc

Browse Source
This commit is contained in:
Arjen Poutsma
2007-09-20 14:59:34 +00:00
parent fcdcf61260
commit b3c9cb7a63
2 changed files with 12 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

11
xml/src/main/java/org/springframework/xml/validation/XmlValidator.java
View File

@@ -22,10 +22,9 @@ import javax.xml.transform.Source;
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 @@ import org.xml.sax.SAXParseException;
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;
}
}

13
xml/src/main/java/org/springframework/xml/validation/XmlValidatorFactory.java
View File

@@ -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 <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 abstract class XmlValidatorFactory {
}
/**
* 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