org.apache.xalan.xsltc.dom
Class XSLTCDTMManager

java.lang.Object
  |
  +--org.apache.xml.dtm.DTMManager
        |
        +--org.apache.xml.dtm.ref.DTMManagerDefault
              |
              +--org.apache.xalan.xsltc.dom.XSLTCDTMManager

public class XSLTCDTMManager

extends DTMManagerDefault

The default implementation for the DTMManager.

Fields inherited from class org.apache.xml.dtm.DTMManager

IDENT_DTM_DEFAULT, IDENT_DTM_NODE_BITS, IDENT_MAX_DTMS, IDENT_NODE_DEFAULT, m_incremental

Constructor Summary

XSLTCDTMManager()
Constructor DTMManagerDefault

Method Summary

DTM	getDTM(Source source, boolean unique, DTMWSFilter whiteSpaceFilter, boolean incremental, boolean doIndexing) Get an instance of a DTM, loaded with the content from the specified source.
DTM	getDTM(Source source, boolean unique, DTMWSFilter whiteSpaceFilter, boolean incremental, boolean doIndexing, boolean buildIdIndex) Get an instance of a DTM, loaded with the content from the specified source.
DTM	getDTM(Source source, boolean unique, DTMWSFilter whiteSpaceFilter, boolean incremental, boolean doIndexing, boolean hasUserReader, int size, boolean buildIdIndex) Get an instance of a DTM, loaded with the content from the specified source.
static XSLTCDTMManager	newInstance() Obtain a new instance of a DTMManager.

Methods inherited from class org.apache.xml.dtm.ref.DTMManagerDefault

addDTM, addDTM, createDocumentFragment, createDTMIterator, createDTMIterator, createDTMIterator, createDTMIterator, getDTM, getDTMHandleFromNode, getDTMIdentity, getExpandedNameTable, getFirstFreeDTMID, getXMLReader, release

Methods inherited from class org.apache.xml.dtm.DTMManager

getDTMIdentityMask, getIncremental, getNodeIdentityMask, getXMLStringFactory, newInstance, setIncremental, setXMLStringFactory

Methods inherited from class java.lang.Object

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

Constructor Detail

XSLTCDTMManager

public XSLTCDTMManager()

Constructor DTMManagerDefault

Method Detail

newInstance

public static XSLTCDTMManager newInstance()

Obtain a new instance of a DTMManager. This static method creates a new factory instance. The current implementation just returns a new XSLTCDTMManager instance. %REVISIT% Do we need the factory lookup mechanism for class loading here? Factory lookup will add a lot of complexity and also has a performance hit. There is currently no need to do it unless it is proved to be useful.

getDTM

public DTM getDTM(Source source,
                  boolean unique,
                  DTMWSFilter whiteSpaceFilter,
                  boolean incremental,
                  boolean doIndexing)

Get an instance of a DTM, loaded with the content from the specified source. If the unique flag is true, a new instance will always be returned. Otherwise it is up to the DTMManager to return a new instance or an instance that it already created and may be being used by someone else. (I think more parameters will need to be added for error handling, and entity resolution).

Parameters:

source - the specification of the source object.

unique - true if the returned DTM must be unique, probably because it is going to be mutated.

whiteSpaceFilter - Enables filtering of whitespace nodes, and may be null.

incremental - true if the DTM should be built incrementally, if possible.

doIndexing - true if the caller considers it worth it to use indexing schemes.

Returns:

a non-null DTM reference.

Overrides:

getDTM in class DTMManagerDefault

getDTM

public DTM getDTM(Source source,
                  boolean unique,
                  DTMWSFilter whiteSpaceFilter,
                  boolean incremental,
                  boolean doIndexing,
                  boolean buildIdIndex)

Get an instance of a DTM, loaded with the content from the specified source. If the unique flag is true, a new instance will always be returned. Otherwise it is up to the DTMManager to return a new instance or an instance that it already created and may be being used by someone else. (I think more parameters will need to be added for error handling, and entity resolution).

Parameters:

source - the specification of the source object.

unique - true if the returned DTM must be unique, probably because it is going to be mutated.

whiteSpaceFilter - Enables filtering of whitespace nodes, and may be null.

incremental - true if the DTM should be built incrementally, if possible.

doIndexing - true if the caller considers it worth it to use indexing schemes.

buildIdIndex - true if the id index table should be built.

Returns:

a non-null DTM reference.

getDTM

public DTM getDTM(Source source,
                  boolean unique,
                  DTMWSFilter whiteSpaceFilter,
                  boolean incremental,
                  boolean doIndexing,
                  boolean hasUserReader,
                  int size,
                  boolean buildIdIndex)

Get an instance of a DTM, loaded with the content from the specified source. If the unique flag is true, a new instance will always be returned. Otherwise it is up to the DTMManager to return a new instance or an instance that it already created and may be being used by someone else. (I think more parameters will need to be added for error handling, and entity resolution).

Parameters:

source - the specification of the source object.

unique - true if the returned DTM must be unique, probably because it is going to be mutated.

whiteSpaceFilter - Enables filtering of whitespace nodes, and may be null.

incremental - true if the DTM should be built incrementally, if possible.

doIndexing - true if the caller considers it worth it to use indexing schemes.

hasUserReader - true if source is a SAXSource object that has an XMLReader, that was specified by the user.

size - Specifies initial size of tables that represent the DTM

buildIdIndex - true if the id index table should be built.

Returns:

a non-null DTM reference.