org.iso_relax.verifier

Class VerifierFactory


public abstract class VerifierFactory
extends java.lang.Object

VerifierFactory
Version:
Apr. 17, 2001
Authors:
ASAMI, Tomoharu (asami@zeomtech.com)
Kohsuke KAWAGUCHI
Since:
Feb. 23, 2001

Method Summary

Schema
compileSchema(File f)
processes a schema into a Schema object, which is a compiled representation of a schema.
abstract Schema
compileSchema(InputSource is)
processes a schema into a Schema object, which is a compiled representation of a schema.
Schema
compileSchema(InputStream stream)
processes a schema into a Schema object, which is a compiled representation of a schema.
Schema
compileSchema(InputStream stream, String systemId)
processes a schema into a Schema object, which is a compiled representation of a schema.
Schema
compileSchema(String url)
processes a schema into a Schema object, which is a compiled representation of a schema.
EntityResolver
getEntityResolver()
Gets the current entity resolver, which was set by the SetEntityResolver method.
Object
getProperty(String property)
Gets property value
boolean
isFeature(String feature)
Indicates whether if the feature is supported, or not.
static VerifierFactory
newInstance()
Deprecated.
static VerifierFactory
newInstance(String language)
static VerifierFactory
newInstance(String language, ClassLoader classLoader)
Creates a new instance of a VerifierFactory for the specified schema language.
Verifier
newVerifier(File file)
parses a schema from the specified file and returns a Verifier object that validates documents by using that schema.
Verifier
newVerifier(InputSource source)
parses a schema from the specified InputSource and returns a Verifier object that validates documents by using that schema.
Verifier
newVerifier(InputStream stream)
parses a schema from the specified InputStream and returns a Verifier object that validates documents by using that schema.
Verifier
newVerifier(InputStream stream, String systemId)
parses a schema from the specified InputStream and returns a Verifier object that validates documents by using that schema.
Verifier
newVerifier(String uri)
parses a schema at the specified location and returns a Verifier object that validates documents by using that schema.
void
setEntityResolver(EntityResolver _resolver)
Sets an EntityResolver This entity resolver is used to resolve entities encountered while parsing a schema.
void
setFeature(String feature, boolean value)
Sets feature value
void
setProperty(String property, Object value)
Sets property value

Method Details

compileSchema

public Schema compileSchema(File f)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
processes a schema into a Schema object, which is a compiled representation of a schema. The obtained schema object can then be used concurrently across multiple threads.
Parameters:

compileSchema

public abstract Schema compileSchema(InputSource is)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
processes a schema into a Schema object, which is a compiled representation of a schema. The obtained schema object can then be used concurrently across multiple threads.

compileSchema

public Schema compileSchema(InputStream stream)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
processes a schema into a Schema object, which is a compiled representation of a schema. The obtained schema object can then be used concurrently across multiple threads.
Parameters:
stream - A stream object that holds a schema.

compileSchema

public Schema compileSchema(InputStream stream,
                            String systemId)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
processes a schema into a Schema object, which is a compiled representation of a schema. The obtained schema object can then be used concurrently across multiple threads.
Parameters:
systemId - The system Id of this input stream.

compileSchema

public Schema compileSchema(String url)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
processes a schema into a Schema object, which is a compiled representation of a schema. The obtained schema object can then be used concurrently across multiple threads.

Some of XML parsers accepts filenames as well as URLs, while others reject them. Therefore, to parse a file as a schema, you should use a File object.

Parameters:
url - A source url of a schema file to be compiled.

getEntityResolver

public EntityResolver getEntityResolver()
Gets the current entity resolver, which was set by the SetEntityResolver method.

getProperty

public Object getProperty(String property)
            throws SAXNotRecognizedException,
                   SAXNotSupportedException
Gets property value
Parameters:
property - property name

isFeature

public boolean isFeature(String feature)
            throws SAXNotRecognizedException,
                   SAXNotSupportedException
Indicates whether if the feature is supported, or not.
Parameters:
feature - feature name

newInstance

public static VerifierFactory newInstance()
            throws VerifierConfigurationException

Deprecated.

Creates a new instance of a VerifierFactory.

newInstance

public static VerifierFactory newInstance(String language)
            throws VerifierConfigurationException

newInstance

public static VerifierFactory newInstance(String language,
                                          ClassLoader classLoader)
            throws VerifierConfigurationException
Creates a new instance of a VerifierFactory for the specified schema language.
Parameters:
language - URI that specifies the schema language.

It is preferable to use the namespace URI of the schema language to designate the schema language. For example,

URIlanguage
http://relaxng.org/ns/structure/0.9 RELAX NG
http://www.xml.gr.jp/xmlns/relaxCore RELAX Core
http://www.xml.gr.jp/xmlns/relaxNamespace RELAX Namespace
http://www.thaiopensource.com/trex TREX
http://www.w3.org/2001/XMLSchema W3C XML Schema
http://www.w3.org/XML/1998/namespace XML DTD
classLoader - This class loader is used to search the available implementation.
Returns:
a non-null valid VerifierFactory instance.
Throws:
VerifierConfigurationException - if no implementation is available for the specified language.

newVerifier

public Verifier newVerifier(File file)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
parses a schema from the specified file and returns a Verifier object that validates documents by using that schema.
Parameters:

newVerifier

public Verifier newVerifier(InputSource source)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
parses a schema from the specified InputSource and returns a Verifier object that validates documents by using that schema.
Parameters:
source - InputSource of a schema file

newVerifier

public Verifier newVerifier(InputStream stream)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
parses a schema from the specified InputStream and returns a Verifier object that validates documents by using that schema.

newVerifier

public Verifier newVerifier(InputStream stream,
                            String systemId)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
parses a schema from the specified InputStream and returns a Verifier object that validates documents by using that schema.
Parameters:
systemId - System ID of this stream.

newVerifier

public Verifier newVerifier(String uri)
            throws VerifierConfigurationException,
                   SAXException,
                   IOException
parses a schema at the specified location and returns a Verifier object that validates documents by using that schema.

Some of XML parsers accepts filenames as well as URLs, while others reject them. Therefore, to parse a file as a schema, you should use a File object.

Parameters:
uri - URI of a schema file

setEntityResolver

public void setEntityResolver(EntityResolver _resolver)
Sets an EntityResolver This entity resolver is used to resolve entities encountered while parsing a schema.

setFeature

public void setFeature(String feature,
                       boolean value)
            throws SAXNotRecognizedException,
                   SAXNotSupportedException
Sets feature value
Parameters:
feature - feature name
value - feature value

setProperty

public void setProperty(String property,
                        Object value)
            throws SAXNotRecognizedException,
                   SAXNotSupportedException
Sets property value
Parameters:
property - property name
value - property value