org.apache.xml.dtm.ref

Class CustomStringPool


public class CustomStringPool
extends DTMStringPool

CustomStringPool is an example of appliction provided data structure for a DTM implementation to hold symbol references, e.g. elelment names. It will follow the DTMDStringPool interface and use two simple methods indexToString(int i) and stringToIndex(Sring s) to map between a set of string values and a set of integer index values. Therefore, an application may improve DTM processing speed by substituting the DTM symbol resolution tables with application specific quick symbol resolution tables. %REVIEW% The only difference between this an DTMStringPool seems to be that it uses a java.lang.Hashtable full of Integers rather than implementing its own hashing. Joe deliberately avoided that approach when writing DTMStringPool, since it is both much more memory-hungry and probably slower -- especially in JDK 1.1.x, where Hashtable is synchronized. We need to either justify this implementation or discard it.

Status: In progress, under discussion.

Field Summary

static int
NULL

Fields inherited from class org.apache.xml.dtm.ref.DTMStringPool

NULL

Constructor Summary

CustomStringPool()

Method Summary

String
indexToString(int i)
void
removeAllElements()
int
stringToIndex(String s)

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

indexToString, main, removeAllElements, stringToIndex

Field Details

NULL

public static final int NULL
Field Value:
-1

Constructor Details

CustomStringPool

public CustomStringPool()

Method Details

indexToString

public String indexToString(int i)
            throws java.lang.ArrayIndexOutOfBoundsException
Overrides:
indexToString in interface DTMStringPool
Returns:
string whose value is uniquely identified by this integer index.

removeAllElements

public void removeAllElements()
Overrides:
removeAllElements in interface DTMStringPool

stringToIndex

public int stringToIndex(String s)
Overrides:
stringToIndex in interface DTMStringPool
Returns:
integer index uniquely identifying the value of this string.

Copyright B) 2004 Apache XML Project. All Rights Reserved.