uk.ac.bbk.dcs.automed.xml.wrappers
Class XMLWrapperFactory

java.lang.Object
  uk.ac.ic.doc.automed.wrappers.AutoMedWrapperFactory
      uk.ac.bbk.dcs.automed.xml.wrappers.XMLWrapperFactory

Direct Known Subclasses:

DOMWrapperFactory, NXDBWrapperFactory, SAXWrapperFactory

public abstract class XMLWrapperFactory
extends AutoMedWrapperFactory

XMLWrapperFactory class. Contains a switch that tells the wrappers produced by the factory class to validate the XML file against a referenced schema. Nevertheless, this class also contains switches for controlling whitespace if the validating switch is off but whitespace control is still needed.

Author:

Lucas Zamboulis

Field Summary

protected java.util.logging.Logger	_logger
static int	EXTRACT_USING_DOM
static int	EXTRACT_USING_DTD
static int	EXTRACT_USING_SAX
static int	EXTRACT_USING_XML_SCHEMA
static int	VALIDATING A feature stating whether the parser of the XML file should validate the file against the accompanying XML Schema/DTD.
static int	WHITESPACE_COLLAPSE A feature stating that after the processing implied by replace, contiguous sequences of #x20's are collapsed to a single #x20, and leading and trailing #x20's are removed.
static int	WHITESPACE_REPLACE A feature stating that all occurrences of #x9 (tab), #xA (line feed) and #xD (carriage return) are replaced with #x20 (space).
protected int	xmldssExtractionMethod

Fields inherited from class uk.ac.ic.doc.automed.wrappers.AutoMedWrapperFactory

automedModelName, baseName, empty, factoryInUse, modelName, SOURCE_PREFIX

Constructor Summary

XMLWrapperFactory()
Creates a new XMLWrapperFactory and sets the model name.

Method Summary

Schema	createAutoMedSchema(AutoMedWrapper wrapper, java.lang.String schemaName) Create an AutoMed oriented schema from the source oriented schema.
java.lang.String	getAccompanyingSchemaRootName()
java.lang.String	getAccompanyingSchemaURI()
Model	getAutoMedModel() Return the AutoMed oriented Model used to represent the Schema of the datasource.
java.lang.String[]	getFeatureNames() Return a string list of features supported by this wrapper, where the first one is bit zero in the feature bit map, second bit one, etc
Model	getModel() Return the source oriented Model used to represent the Schema of the datasource.
int	getXMLDSSExtractionMethod()
protected AutoMedWrapper	newAutoMedWrapper() Create a new empty wrapper instance that this wrapper factory is then able to populate.
protected void	populateSchema(AutoMedWrapper wrapper) Read the metadata from the wrapper connection, and store in existing Schema within the wrapper.
void	setAccompanyingSchemaRootName(java.lang.String rootName)
void	setAccompanyingSchemaURI(java.lang.String uri)
void	setXMLDSSExtractionMethod(int method)

Methods inherited from class uk.ac.ic.doc.automed.wrappers.AutoMedWrapperFactory

clearFeatures, getAttributeDomains, getAutoMedModelName, getFeatures, getModelBaseName, getModelName, isFeatureInUse, safeIQL, setAttributeDomains, setFeatures, setFeatures, setModelBaseName

Methods inherited from class java.lang.Object

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

Field Detail

_logger

protected java.util.logging.Logger _logger

xmldssExtractionMethod

protected int xmldssExtractionMethod

VALIDATING

public static final int VALIDATING

A feature stating whether the parser of the XML file should validate the file against the accompanying XML Schema/DTD.

See Also:

Constant Field Values

WHITESPACE_REPLACE

public static final int WHITESPACE_REPLACE

A feature stating that all occurrences of #x9 (tab), #xA (line feed) and #xD (carriage return) are replaced with #x20 (space).

See Also:

Constant Field Values

WHITESPACE_COLLAPSE

public static final int WHITESPACE_COLLAPSE

A feature stating that after the processing implied by replace, contiguous sequences of #x20's are collapsed to a single #x20, and leading and trailing #x20's are removed.

See Also:

Constant Field Values

EXTRACT_USING_DOM

public static final int EXTRACT_USING_DOM

See Also:

Constant Field Values

EXTRACT_USING_SAX

public static final int EXTRACT_USING_SAX

See Also:

Constant Field Values

EXTRACT_USING_XML_SCHEMA

public static final int EXTRACT_USING_XML_SCHEMA

See Also:

Constant Field Values

EXTRACT_USING_DTD

public static final int EXTRACT_USING_DTD

See Also:

Constant Field Values

Constructor Detail

XMLWrapperFactory

public XMLWrapperFactory()

Creates a new XMLWrapperFactory and sets the model name.

Method Detail

getFeatureNames

public final java.lang.String[] getFeatureNames()

Return a string list of features supported by this wrapper, where the first one is bit zero in the feature bit map, second bit one, etc

Specified by:

getFeatureNames in class AutoMedWrapperFactory

setAccompanyingSchemaURI

public void setAccompanyingSchemaURI(java.lang.String uri)

getAccompanyingSchemaURI

public java.lang.String getAccompanyingSchemaURI()

setAccompanyingSchemaRootName

public void setAccompanyingSchemaRootName(java.lang.String rootName)

getAccompanyingSchemaRootName

public java.lang.String getAccompanyingSchemaRootName()

setXMLDSSExtractionMethod

public void setXMLDSSExtractionMethod(int method)

getXMLDSSExtractionMethod

public int getXMLDSSExtractionMethod()

newAutoMedWrapper

protected AutoMedWrapper newAutoMedWrapper()

Description copied from class: AutoMedWrapperFactory

Create a new empty wrapper instance that this wrapper factory is then able to populate.

Specified by:

newAutoMedWrapper in class AutoMedWrapperFactory

getModel

public final Model getModel()

Description copied from class: AutoMedWrapperFactory

Return the source oriented Model used to represent the Schema of the datasource. For some wrappers, this may be the same as AutoMed oriented Model returned by AutoMedWrapperFactory.getAutoMedModel()

Specified by:

getModel in class AutoMedWrapperFactory

getAutoMedModel

public final Model getAutoMedModel()

Description copied from class: AutoMedWrapperFactory

Return the AutoMed oriented Model used to represent the Schema of the datasource.

Specified by:

getAutoMedModel in class AutoMedWrapperFactory

createAutoMedSchema

public final Schema createAutoMedSchema(AutoMedWrapper wrapper,
                                        java.lang.String schemaName)

Description copied from class: AutoMedWrapperFactory

Create an AutoMed oriented schema from the source oriented schema.

Specified by:

createAutoMedSchema in class AutoMedWrapperFactory

Parameters:

wrapper - A wrapper containing the source oriented Schema from which the AutoMed oriented Schema should be produced.

schemaName - name of the new AutoMed construct oriented schema that is to be created from the source oriented schema. This schema must not yet exist.

populateSchema

protected void populateSchema(AutoMedWrapper wrapper)

Description copied from class: AutoMedWrapperFactory

Read the metadata from the wrapper connection, and store in existing Schema within the wrapper. To be called by AutoMedWrapper instances as part of the wrapper creation process.

Specified by:

populateSchema in class AutoMedWrapperFactory