org.apache.xindice.core.filer
Class BTreeFiler

java.lang.Object
  org.apache.xindice.core.filer.Paged
      org.apache.xindice.core.filer.BTree
          org.apache.xindice.core.filer.BTreeFiler

All Implemented Interfaces:

Configurable, DBObject, Filer, Named

public class BTreeFiler

extends BTree

implements Filer

BTreeFiler is a Filer implementation based on the BTree class.
BTreeFiler has folowing configuration attributes:

• pagesize: Size of the page used by the filer. Default page size is 4096 bytes. This parameter can be set only before paged file is created. Once it is created, this parameter can not be changed.
• pagecount: Number of pages filer will be created with.
• maxkeysize: Maximum allowed size of the key. Default maximum key size is 256 bytes.
• max-descriptors: Defines maximum amount of simultaneously opened file descriptors this paged file can have. Several descriptors are needed to provide multithreaded access to the underlying file. Too large number will limit amount of collections you can open. Default value is 16 (DEFAULT_DESCRIPTORS_MAX).

Version:

$Revision: 541516 $, $Date: 2007-05-24 22:46:51 -0400 (Thu, 24 May 2007) $

Nested Class Summary

Nested classes inherited from class org.apache.xindice.core.filer.BTree

BTree.BTreeFileHeader, BTree.BTreePageHeader, BTree.BTreeRootInfo

Nested classes inherited from class org.apache.xindice.core.filer.Paged

Paged.FileHeader, Paged.Page, Paged.PageHeader, Paged.PageKey

Field Summary

protected static byte

RECORD Record page status

Fields inherited from class org.apache.xindice.core.filer.BTree

BRANCH, LEAF, STREAM

Fields inherited from class org.apache.xindice.core.filer.Paged

CONFIG_DESCRIPTORS_MAX, CONFIG_KEYSIZE_MAX, CONFIG_PAGECOUNT, CONFIG_PAGESIZE, DELETED, NO_PAGE, OVERFLOW, UNUSED

Constructor Summary

BTreeFiler()

Method Summary

protected Paged.FileHeader	createFileHeader() createFileHeader must be implemented by a Paged implementation in order to create an appropriate subclass instance of a FileHeader.
protected Paged.PageHeader	createPageHeader() createPageHeader must be implemented by a Paged implementation in order to create an appropriate subclass instance of a PageHeader.
boolean	deleteRecord(Key key) deleteRecord removes a Record from the Filer based on the specified Key.
String	getName() getName retrieves the contextually important name of the object
long	getRecordCount() getRecordCount returns the number of Records in the Filer.
RecordSet	getRecordSet() getRecordSet returns a RecordSet object for the current Filer.
Record	readRecord(Key key) readRecord returns a Record from the Filer based on the specified Key.
Record	readRecord(Key key, boolean metaOnly) readRecord returns a Record from the Filer based on the specified Key containing filer meta information and value.
void	setLocation(File root, String location) setLocation tells the Filer where to store its data.
Record	writeRecord(Key key, Value value) writeRecord writes a Value to the Filer based on the specified Key.

Methods inherited from class org.apache.xindice.core.filer.BTree

addKey, addValue, addValue, close, create, createBTreeRoot, createBTreeRoot, findBTreeRoot, findBTreeRoot, findValue, findValue, getRootNode, getRootNode, open, query, query, removeValue, removeValue, setRootNode, setRootNode

Methods inherited from class org.apache.xindice.core.filer.Paged

checkOpened, closeDescriptor, deleteArrayInt, deleteArrayLong, deleteArrayShort, deleteArrayValue, drop, exists, flush, getConfig, getDescriptor, getFile, getFileHeader, getFreePage, getPage, insertArrayInt, insertArrayLong, insertArrayShort, insertArrayValue, isOpened, putDescriptor, readValue, readValue, setConfig, setFile, unlinkPages, unlinkPages, writeValue, writeValue

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.xindice.core.filer.Filer

flush

Methods inherited from interface org.apache.xindice.core.DBObject

close, create, drop, exists, isOpened, open

Methods inherited from interface org.apache.xindice.util.Configurable

getConfig, setConfig

Field Detail

RECORD

protected static final byte RECORD

Record page status

See Also:

Constant Field Values

Constructor Detail

BTreeFiler

public BTreeFiler()

Method Detail

setLocation

public void setLocation(File root,
                        String location)

Description copied from interface: Filer

setLocation tells the Filer where to store its data.

Specified by:

setLocation in interface Filer

Parameters:

root - The root under which to store data

location - The name to use for storing data

getName

public String getName()

Description copied from interface: Named

getName retrieves the contextually important name of the object

Specified by:

getName in interface Named

Returns:

The object's name

readRecord

public Record readRecord(Key key)
                  throws DBException

Description copied from interface: Filer

readRecord returns a Record from the Filer based on the specified Key.

Specified by:

readRecord in interface Filer

Parameters:

key - The Record's Key

Returns:

The returned Record

Throws:

DBException

readRecord

public Record readRecord(Key key,
                         boolean metaOnly)
                  throws DBException

Description copied from interface: Filer

readRecord returns a Record from the Filer based on the specified Key containing filer meta information and value.

Specified by:

readRecord in interface Filer

Parameters:

key - The Record's Key

metaOnly - if true, resulting record contains only meta information

Returns:

The returned Record

Throws:

DBException

writeRecord

public Record writeRecord(Key key,
                          Value value)
                   throws DBException

Description copied from interface: Filer

writeRecord writes a Value to the Filer based on the specified Key.

Specified by:

writeRecord in interface Filer

Parameters:

key - The Record's Key

value - The Record's Value

Returns:

Written Record

Throws:

DBException

deleteRecord

public boolean deleteRecord(Key key)
                     throws DBException

Description copied from interface: Filer

deleteRecord removes a Record from the Filer based on the specified Key.

Specified by:

deleteRecord in interface Filer

Parameters:

key - The Record's Key

Returns:

Whether or not the Record was deleted

Throws:

DBException

getRecordCount

public long getRecordCount()
                    throws DBException

Description copied from interface: Filer

getRecordCount returns the number of Records in the Filer.

Specified by:

getRecordCount in interface Filer

Returns:

The Record count

Throws:

DBException

getRecordSet

public RecordSet getRecordSet()
                       throws DBException

Description copied from interface: Filer

getRecordSet returns a RecordSet object for the current Filer.

Specified by:

getRecordSet in interface Filer

Returns:

The Filer Enumerator

Throws:

DBException

createFileHeader

protected Paged.FileHeader createFileHeader()

Description copied from class: Paged

createFileHeader must be implemented by a Paged implementation in order to create an appropriate subclass instance of a FileHeader.

Overrides:

createFileHeader in class BTree

createPageHeader

protected Paged.PageHeader createPageHeader()

Description copied from class: Paged

createPageHeader must be implemented by a Paged implementation in order to create an appropriate subclass instance of a PageHeader.

Overrides:

createPageHeader in class BTree