org.iso_relax.verifier
Class VerifierFactory

java.lang.Object
  extended by org.iso_relax.verifier.VerifierFactory

public abstract class VerifierFactory
extends java.lang.Object

VerifierFactory

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

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

Constructor Detail

VerifierFactory

public VerifierFactory()
Method Detail

compileSchema

public Schema compileSchema(java.io.File f)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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:
file - A schema file to be compiled
Throws:
VerifierConfigurationException
org.xml.sax.SAXException
java.io.IOException

compileSchema

public abstract Schema compileSchema(org.xml.sax.InputSource is)
                              throws VerifierConfigurationException,
                                     org.xml.sax.SAXException,
                                     java.io.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
org.xml.sax.SAXException
java.io.IOException

compileSchema

public Schema compileSchema(java.io.InputStream stream)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

compileSchema

public Schema compileSchema(java.io.InputStream stream,
                            java.lang.String systemId)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

compileSchema

public Schema compileSchema(java.lang.String url)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

getEntityResolver

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


getProperty

public java.lang.Object getProperty(java.lang.String property)
                             throws org.xml.sax.SAXNotRecognizedException,
                                    org.xml.sax.SAXNotSupportedException
Gets property value

Parameters:
property - property name
Throws:
org.xml.sax.SAXNotRecognizedException
org.xml.sax.SAXNotSupportedException

isFeature

public boolean isFeature(java.lang.String feature)
                  throws org.xml.sax.SAXNotRecognizedException,
                         org.xml.sax.SAXNotSupportedException
Indicates whether if the feature is supported, or not.

Parameters:
feature - feature name
Throws:
org.xml.sax.SAXNotRecognizedException
org.xml.sax.SAXNotSupportedException

newInstance

public static VerifierFactory newInstance(java.lang.String language)
                                   throws VerifierConfigurationException
Throws:
VerifierConfigurationException

newInstance

public static VerifierFactory newInstance(java.lang.String language,
                                          java.lang.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.

newVerifier

public Verifier newVerifier(java.io.File file)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.IOException
parses a schema from the specified file and returns a Verifier object that validates documents by using that schema.

Parameters:
uri - File of a schema file
Throws:
VerifierConfigurationException
org.xml.sax.SAXException
java.io.IOException

newVerifier

public Verifier newVerifier(org.xml.sax.InputSource source)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

newVerifier

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

Throws:
VerifierConfigurationException
org.xml.sax.SAXException
java.io.IOException

newVerifier

public Verifier newVerifier(java.io.InputStream stream,
                            java.lang.String systemId)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

newVerifier

public Verifier newVerifier(java.lang.String uri)
                     throws VerifierConfigurationException,
                            org.xml.sax.SAXException,
                            java.io.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
org.xml.sax.SAXException
java.io.IOException

setEntityResolver

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


setFeature

public void setFeature(java.lang.String feature,
                       boolean value)
                throws org.xml.sax.SAXNotRecognizedException,
                       org.xml.sax.SAXNotSupportedException
Sets feature value

Parameters:
feature - feature name
value - feature value
Throws:
org.xml.sax.SAXNotRecognizedException
org.xml.sax.SAXNotSupportedException

setProperty

public void setProperty(java.lang.String property,
                        java.lang.Object value)
                 throws org.xml.sax.SAXNotRecognizedException,
                        org.xml.sax.SAXNotSupportedException
Sets property value

Parameters:
property - property name
value - property value
Throws:
org.xml.sax.SAXNotRecognizedException
org.xml.sax.SAXNotSupportedException