xmlexpr.ParserFactory Class Reference

List of all members.

---

Detailed Description

ParserFactory Jul 26, 2004.

Author:

Ian Kaplan, www.bearcave.com, iank@bearcave.com

Static Public Member Functions
DOMParser	newParser (boolean validate)
	Allocate and initialize a new DOM parser.
Static Package Attributes
final String	NAMESPACES_FEATURE_PREFIX = "http://xml.org/sax/features/namespaces"
	the namespace feature is true by default
final String	VALIDATION_FEATURE = "http://xml.org/sax/features/validation"
final String	VALIDATION_SCHEMA_FEATURE = "http://apache.org/xml/features/validation/schema"
Static Private Member Functions
void	setFeature (DOMParser parser, String featureURI, String featureName)
	Set a feature in the parser and report any errors.
void	initParser (DOMParser parser, boolean validate)
	Turn on validation in the parser object.

---

Member Function Documentation

void xmlexpr.ParserFactory.initParser (  DOMParser  parser, boolean  validate )  [static, private]

Turn on validation in the parser object. The W3C (www.w3.org) and Apache (www.apache.org) documentation is less than clear when it comes to XML Schemas and XML parsers. Initializing a parser so that it performs validation is rather obscure. The features that are set in initialization are URI strings. These are defined on the Apache web page: http://xml.apache.org/xerces2-j/features.html A parser feature is turned on by calling the parser method setFeature( featureStr, true ), where featureStr is one of the features defined on the Apache web page. The feature to turn on schema validation is: http://apache.org/xml/features/validation/schema Error reporting requries that the basic validation feature be turned on as well. This is: http://xml.org/sax/features/validation Note that one feature uses apache.org and the other uses xml.org. Apparently this is historical: the base validation feature was originally for DTDs. The validation/schema feature is for XML Schema Descriptions (XSDs). Parameters: parser  the parser object validate  true = turn validation on, false = no validation. { // parser.setErrorHandler(new DefaultHandler()); parser.setErrorHandler(new LocalErrorHandler() ); if (validate) { setFeature( parser, VALIDATION_FEATURE, "VALIDATION_FEATURE" ); setFeature( parser, VALIDATION_SCHEMA_FEATURE, "VALIDATION_SCHEMA_FEATURE" ); } } // initParser

DOMParser xmlexpr.ParserFactory.newParser (  boolean  validate  )  [static]

Allocate and initialize a new DOM parser. Parameters: validate  false = no validation, true = initialize the parser for XML schema validation { DOMParser parser = new DOMParser(); initParser( parser, validate ); return parser; } // newParser

void xmlexpr.ParserFactory.setFeature (  DOMParser  parser, String  featureURI, String  featureName )  [static, private]

Set a feature in the parser and report any errors. { try { parser.setFeature(featureURI, true); } catch (SAXNotSupportedException e) { System.out.println("ParserFactory::initParser: " + featureName + " not supported by parser"); } catch (SAXNotRecognizedException e) { System.out.println("ParserFactory::initParser: " + featureName + " not recognized by parser"); } } // setFeature

---

Member Data Documentation

final String xmlexpr.ParserFactory.NAMESPACES_FEATURE_PREFIX = "http://xml.org/sax/features/namespaces" [static, package]

the namespace feature is true by default

final String xmlexpr.ParserFactory.VALIDATION_FEATURE = "http://xml.org/sax/features/validation" [static, package]

final String xmlexpr.ParserFactory.VALIDATION_SCHEMA_FEATURE = "http://apache.org/xml/features/validation/schema" [static, package]

---

The documentation for this class was generated from the following file:

• ParserFactory.java

---