de.lmu.ifi.dbs.elki.database

Class AbstractDatabase

java.lang.Object

de.lmu.ifi.dbs.elki.result.AbstractHierarchicalResult

de.lmu.ifi.dbs.elki.database.AbstractDatabase

All Implemented Interfaces:

Database, HierarchicalResult, Result

Direct Known Subclasses:

HashmapDatabase, ProxyDatabase, StaticArrayDatabase

public abstract class AbstractDatabase
extends AbstractHierarchicalResult
implements Database

Abstract base class for database API implementations. Provides default management of relations, indexes and events as well as default query matching.

Note: when debugging index usage, set logging for this package to FINEST via -enableDebug de.lmu.ifi.dbs.elki.database=FINEST

Since:

0.1

Author:

Erich Schubert

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractDatabase.Parameterizer Parameterization class.

Field Summary

Fields

Modifier and Type	Field and Description
protected DatabaseEventManager	eventManager The event manager, collects events and fires them on demand.
protected java.util.Collection<IndexFactory<?>>	indexFactories Index factories.
protected java.util.List<Relation<?>>	relations The relations we manage.

Constructor Summary

Constructors

Constructor and Description
AbstractDatabase() Constructor.

Method Summary

Modifier and Type	Method and Description
void	accumulateDataStoreEvents() Collects all insertion, deletion and update events until Database.flushDataStoreEvents() is called.
void	addDataStoreListener(DataStoreListener l) Adds a listener for the DataStoreEvent posted after the content of the database changes.
void	flushDataStoreEvents() Fires all collected insertion, deletion and update events as one DataStoreEvent, i.e. notifies all registered DataStoreListener how the content of the database has been changed since Database.accumulateDataStoreEvents() has been called.
SingleObjectBundle	getBundle(DBIDRef id) Returns the DatabaseObject represented by the specified id.
<O> DistanceQuery<O>	getDistanceQuery(Relation<O> objQuery, DistanceFunction<? super O> distanceFunction, java.lang.Object... hints) Get the distance query for a particular distance function.
<O> KNNQuery<O>	getKNNQuery(DistanceQuery<O> distanceQuery, java.lang.Object... hints) Get a KNN query object for the given distance query.
protected abstract Logging	getLogger() Get the class logger.
java.lang.String	getLongName() A "pretty" name for the result, for use in titles, captions and menus.
<O> RangeQuery<O>	getRangeQuery(DistanceQuery<O> distanceQuery, java.lang.Object... hints) Get a range query object for the given distance query for radius-based neighbor search.
<O> Relation<O>	getRelation(TypeInformation restriction, java.lang.Object... hints) Get an object representation.
java.util.Collection<Relation<?>>	getRelations() Get all relations of a database.
<O> RKNNQuery<O>	getRKNNQuery(DistanceQuery<O> distanceQuery, java.lang.Object... hints) Get a rKNN query object for the given distance query.
java.lang.String	getShortName() A short name for the result, useful for file names.
<O> SimilarityQuery<O>	getSimilarityQuery(Relation<O> objQuery, SimilarityFunction<? super O> similarityFunction, java.lang.Object... hints) Get the similarity query for a particular similarity function.
<O> RangeQuery<O>	getSimilarityRangeQuery(SimilarityQuery<O> simQuery, java.lang.Object... hints) Get a range query object for the given distance query for radius-based neighbor search.
void	removeDataStoreListener(DataStoreListener l) Removes a listener previously added with Database.addDataStoreListener(DataStoreListener).

Methods inherited from class de.lmu.ifi.dbs.elki.result.AbstractHierarchicalResult

addChildResult, getHierarchy, setHierarchy

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.lmu.ifi.dbs.elki.database.Database

initialize

Methods inherited from interface de.lmu.ifi.dbs.elki.result.HierarchicalResult

getHierarchy, setHierarchy

Field Detail

eventManager

protected final DatabaseEventManager eventManager

The event manager, collects events and fires them on demand.

relations

protected final java.util.List<Relation<?>> relations

The relations we manage.

indexFactories

protected final java.util.Collection<IndexFactory<?>> indexFactories

Index factories.

Constructor Detail

AbstractDatabase

public AbstractDatabase()

Constructor.

Method Detail

getBundle

public SingleObjectBundle getBundle(DBIDRef id)

Description copied from interface: Database

Returns the DatabaseObject represented by the specified id.

Specified by:

getBundle in interface Database

Parameters:

id - the id of the Object to be obtained from the Database

Returns:

Bundle containing the objects' data

getRelations

public java.util.Collection<Relation<?>> getRelations()

Description copied from interface: Database

Get all relations of a database.

Specified by:

getRelations in interface Database

Returns:

All relations in the database

getRelation

public <O> Relation<O> getRelation(TypeInformation restriction,
                                   java.lang.Object... hints)
                            throws NoSupportedDataTypeException

Description copied from interface: Database

Get an object representation.

Specified by:

getRelation in interface Database

Type Parameters:

O - Object type

Parameters:

restriction - Type restriction

hints - Optimizer hints

Returns:

representation

Throws:

NoSupportedDataTypeException

getDistanceQuery

public <O> DistanceQuery<O> getDistanceQuery(Relation<O> objQuery,
                                             DistanceFunction<? super O> distanceFunction,
                                             java.lang.Object... hints)

Description copied from interface: Database

Get the distance query for a particular distance function.

Specified by:

getDistanceQuery in interface Database

Type Parameters:

O - Object type

Parameters:

objQuery - Relation used

distanceFunction - Distance function to use

hints - Optimizer hints

Returns:

Instance to query the database with this distance

getSimilarityQuery

public <O> SimilarityQuery<O> getSimilarityQuery(Relation<O> objQuery,
                                                 SimilarityFunction<? super O> similarityFunction,
                                                 java.lang.Object... hints)

Description copied from interface: Database

Get the similarity query for a particular similarity function.

Specified by:

getSimilarityQuery in interface Database

Type Parameters:

O - Object type

Parameters:

objQuery - Relation used

similarityFunction - Similarity function to use

hints - Optimizer hints

Returns:

Instance to query the database with this similarity

getKNNQuery

public <O> KNNQuery<O> getKNNQuery(DistanceQuery<O> distanceQuery,
                                   java.lang.Object... hints)

Description copied from interface: Database

Get a KNN query object for the given distance query. An index is used when possible, but it may fall back to a linear scan. Hints include:

• Integer: maximum value for k needed
• DatabaseQuery.HINT_BULK bulk query needed

Specified by:

getKNNQuery in interface Database

Type Parameters:

O - Object type

Parameters:

distanceQuery - Distance query

hints - Optimizer hints

Returns:

KNN Query object

getRangeQuery

public <O> RangeQuery<O> getRangeQuery(DistanceQuery<O> distanceQuery,
                                       java.lang.Object... hints)

Description copied from interface: Database

Get a range query object for the given distance query for radius-based neighbor search. (Range queries in ELKI refers to radius-based ranges, not rectangular query windows.) An index is used when possible, but it may fall back to a linear scan. Hints include:

• Double: Maximum query range that will be used.
• DatabaseQuery.HINT_BULK bulk query needed

Specified by:

getRangeQuery in interface Database

Type Parameters:

O - Object type

Parameters:

distanceQuery - Distance query

hints - Optimizer hints

Returns:

KNN Query object

getSimilarityRangeQuery

public <O> RangeQuery<O> getSimilarityRangeQuery(SimilarityQuery<O> simQuery,
                                                 java.lang.Object... hints)

Description copied from interface: Database

Get a range query object for the given distance query for radius-based neighbor search. (Range queries in ELKI refers to radius-based ranges, not rectangular query windows.) An index is used when possible, but it may fall back to a linear scan. Hints include:

• Double: Minimum query similarity that will be used.
• DatabaseQuery.HINT_BULK bulk query needed

Specified by:

getSimilarityRangeQuery in interface Database

Type Parameters:

O - Object type

Parameters:

simQuery - Similarity query

hints - Optimizer hints

Returns:

KNN Query object

getRKNNQuery

public <O> RKNNQuery<O> getRKNNQuery(DistanceQuery<O> distanceQuery,
                                     java.lang.Object... hints)

Description copied from interface: Database

Get a rKNN query object for the given distance query. An index is used when possible, but it may fall back to a linear scan. Hints include:

• Integer: maximum value for k needed
• DatabaseQuery.HINT_BULK bulk query needed

Specified by:

getRKNNQuery in interface Database

Type Parameters:

O - Object type

Parameters:

distanceQuery - Distance query

hints - Optimizer hints

Returns:

KNN Query object

addDataStoreListener

public void addDataStoreListener(DataStoreListener l)

Description copied from interface: Database

Adds a listener for the DataStoreEvent posted after the content of the database changes.

Specified by:

addDataStoreListener in interface Database

Parameters:

l - the listener to add

See Also:

Database.removeDataStoreListener(DataStoreListener), DataStoreListener, DataStoreEvent

removeDataStoreListener

public void removeDataStoreListener(DataStoreListener l)

Description copied from interface: Database

Removes a listener previously added with Database.addDataStoreListener(DataStoreListener).

Specified by:

removeDataStoreListener in interface Database

Parameters:

l - the listener to remove

See Also:

Database.addDataStoreListener(DataStoreListener), DataStoreListener, DataStoreEvent

accumulateDataStoreEvents

public void accumulateDataStoreEvents()

Description copied from interface: Database

Collects all insertion, deletion and update events until Database.flushDataStoreEvents() is called.

Specified by:

accumulateDataStoreEvents in interface Database

See Also:

DataStoreEvent

flushDataStoreEvents

public void flushDataStoreEvents()

Description copied from interface: Database

Fires all collected insertion, deletion and update events as one DataStoreEvent, i.e. notifies all registered DataStoreListener how the content of the database has been changed since Database.accumulateDataStoreEvents() has been called.

Specified by:

flushDataStoreEvents in interface Database

See Also:

DataStoreListener, DataStoreEvent

getLongName

public java.lang.String getLongName()

Description copied from interface: Result

A "pretty" name for the result, for use in titles, captions and menus.

Specified by:

getLongName in interface Result

Returns:

result name

getShortName

public java.lang.String getShortName()

Description copied from interface: Result

A short name for the result, useful for file names.

Specified by:

getShortName in interface Result

Returns:

result name

getLogger

protected abstract Logging getLogger()

Get the class logger.

Returns:

Class logger