org.iso_relax.verifier

Class VerifierFactory

java.lang.Object

org.iso_relax.verifier.VerifierFactory

public abstract class VerifierFactory
extends Object

VerifierFactory

Since:

Feb. 23, 2001

Version:

Apr. 17, 2001

Author:

ASAMI, Tomoharu (asami@zeomtech.com), Kohsuke KAWAGUCHI

Constructor Summary

Constructors

Constructor and Description
VerifierFactory()

Method Summary

Modifier and Type	Method and Description
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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

VerifierFactory

public VerifierFactory()

Method Detail

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

Throws:

VerifierConfigurationException

SAXException

IOException

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:

file - File of a schema file

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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.

Throws:

VerifierConfigurationException

SAXException

IOException

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:

f - A schema file to be compiled

Throws:

VerifierConfigurationException

SAXException

IOException

isFeature

public boolean isFeature(String feature)
                  throws SAXNotRecognizedException

Indicates whether if the feature is supported, or not.

Parameters:

feature - feature name

Throws:

SAXNotRecognizedException

setFeature

public void setFeature(String feature,
                       boolean value)
                throws SAXNotRecognizedException

Sets feature value

Parameters:

feature - feature name

value - feature value

Throws:

SAXNotRecognizedException

getProperty

public Object getProperty(String property)
                   throws SAXNotRecognizedException

Gets property value

Parameters:

property - property name

Throws:

SAXNotRecognizedException

setProperty

public void setProperty(String property,
                        Object value)
                 throws SAXNotRecognizedException

Sets property value

Parameters:

property - property name

value - property value

Throws:

SAXNotRecognizedException

setEntityResolver

public void setEntityResolver(EntityResolver _resolver)

Sets an EntityResolver This entity resolver is used to resolve entities encountered while parsing a schema.

getEntityResolver

public EntityResolver getEntityResolver()

Gets the current entity resolver, which was set by the SetEntityResolver method.

newInstance

@Deprecated
public static VerifierFactory newInstance()
                                                throws VerifierConfigurationException

Deprecated.

Creates a new instance of a VerifierFactory.

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,

URI	language
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.

newInstance

public static VerifierFactory newInstance(String language)
                                   throws VerifierConfigurationException

Throws:

VerifierConfigurationException