de.lmu.ifi.dbs.elki.database.ids.integer

Class TrivialDBIDFactory

java.lang.Object

de.lmu.ifi.dbs.elki.database.ids.integer.TrivialDBIDFactory

All Implemented Interfaces:

DBIDFactory

public final class TrivialDBIDFactory
extends Object
implements DBIDFactory

Trivial DBID management, that never reuses IDs and just gives them out in sequence. Statically allocated DBID ranges are given positive values, Dynamically allocated DBIDs are given negative values.

Field Summary

Fields

Modifier and Type	Field and Description
(package private) DBID	invalid Invalid ID.
(package private) AtomicInteger	next Keep track of the smallest dynamic DBID offset not used.

Fields inherited from interface de.lmu.ifi.dbs.elki.database.ids.DBIDFactory

FACTORY

Constructor Summary

Constructors

Constructor and Description
TrivialDBIDFactory() Constructor.

Method Summary

Methods

Modifier and Type	Method and Description
void	assignVar(DBIDVar var, int val) Assign an integer value to a DBID variable.
int	compare(DBIDRef a, DBIDRef b) Compare two DBIDs, for sorting.
void	deallocateDBIDRange(DBIDRange range) Deallocate a static DBID range.
void	deallocateSingleDBID(DBIDRef id) Return a single DBID for reuse.
boolean	equal(DBIDRef a, DBIDRef b) Compare two DBIDs, for equality testing.
DBID	generateSingleDBID() Generate a single DBID.
DBIDRange	generateStaticDBIDRange(int size) Generate a static DBID range.
ByteBufferSerializer<DBID>	getDBIDSerializer() Get a serializer for DBIDs.
FixedSizeByteBufferSerializer<DBID>	getDBIDSerializerStatic() Get a serializer for DBIDs with static size.
Class<? extends DBID>	getTypeRestriction() Get type restriction.
DBID	importInteger(int id) Import and integer as DBID.
DBIDRef	invalid() Get the invalid DBID value, usable as "undefined" placeholder.
ArrayModifiableDBIDs	newArray() Make a new (modifiable) array of DBIDs.
ArrayModifiableDBIDs	newArray(DBIDs existing) Make a new (modifiable) array of DBIDs.
ArrayModifiableDBIDs	newArray(int size) Make a new (modifiable) array of DBIDs.
<D extends Distance<D>> DistanceDBIDPair<D>	newDistancePair(D val, DBIDRef id) Make a new distance-DBID pair.
DoubleDistanceDBIDPair	newDistancePair(double val, DBIDRef id) Make a new distance-DBID pair.
HashSetModifiableDBIDs	newHashSet() Make a new (modifiable) hash set of DBIDs.
HashSetModifiableDBIDs	newHashSet(DBIDs existing) Make a new (modifiable) hash set of DBIDs.
HashSetModifiableDBIDs	newHashSet(int size) Make a new (modifiable) hash set of DBIDs.
DBIDPair	newPair(DBIDRef first, DBIDRef second) Make a DBID pair from two existing DBIDs.
DoubleDBIDPair	newPair(double val, DBIDRef id) Make a double-DBID pair.
DBIDVar	newVar(DBIDRef val) Make a new DBID variable.
String	toString(DBIDRef id) Print a DBID as string.

Methods inherited from class java.lang.Object

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

Field Detail

next

AtomicInteger next

Keep track of the smallest dynamic DBID offset not used.

invalid

DBID invalid

Invalid ID.

Constructor Detail

TrivialDBIDFactory

public TrivialDBIDFactory()

Constructor.

Method Detail

generateSingleDBID

public final DBID generateSingleDBID()

Description copied from interface: DBIDFactory

Generate a single DBID.

Specified by:

generateSingleDBID in interface DBIDFactory

Returns:

A single DBID

deallocateSingleDBID

public final void deallocateSingleDBID(DBIDRef id)

Description copied from interface: DBIDFactory

Return a single DBID for reuse.

Specified by:

deallocateSingleDBID in interface DBIDFactory

Parameters:

id - DBID to deallocate

generateStaticDBIDRange

public final DBIDRange generateStaticDBIDRange(int size)

Description copied from interface: DBIDFactory

Generate a static DBID range.

Specified by:

generateStaticDBIDRange in interface DBIDFactory

Parameters:

size - Requested size

Returns:

DBID range

deallocateDBIDRange

public void deallocateDBIDRange(DBIDRange range)

Description copied from interface: DBIDFactory

Deallocate a static DBID range.

Specified by:

deallocateDBIDRange in interface DBIDFactory

Parameters:

range - Range to deallocate

importInteger

public DBID importInteger(int id)

Description copied from interface: DBIDFactory

Import and integer as DBID. Note: this may not be possible for some factories!

Specified by:

importInteger in interface DBIDFactory

Parameters:

id - Integer ID to import

Returns:

DBID

assignVar

public void assignVar(DBIDVar var,
             int val)

Description copied from interface: DBIDFactory

Assign an integer value to a DBID variable. Note: this may not be possible for some factories!

Specified by:

assignVar in interface DBIDFactory

Parameters:

var - Variable

val - Integer value

compare

public int compare(DBIDRef a,
          DBIDRef b)

Description copied from interface: DBIDFactory

Compare two DBIDs, for sorting.

Specified by:

compare in interface DBIDFactory

Parameters:

a - First

b - Second

Returns:

Comparison result

equal

public boolean equal(DBIDRef a,
            DBIDRef b)

Description copied from interface: DBIDFactory

Compare two DBIDs, for equality testing.

Specified by:

equal in interface DBIDFactory

Parameters:

a - First

b - Second

Returns:

Comparison result

toString

public String toString(DBIDRef id)

Description copied from interface: DBIDFactory

Print a DBID as string.

Specified by:

toString in interface DBIDFactory

Parameters:

id - DBID reference

Returns:

Formatted ID

newVar

public DBIDVar newVar(DBIDRef val)

Description copied from interface: DBIDFactory

Make a new DBID variable.

Specified by:

newVar in interface DBIDFactory

Parameters:

val - Initial value.

Returns:

Variable

newArray

public ArrayModifiableDBIDs newArray()

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet()

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Returns:

New hash set

newArray

public ArrayModifiableDBIDs newArray(int size)

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Parameters:

size - Size hint

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet(int size)

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Parameters:

size - Size hint

Returns:

New hash set

newArray

public ArrayModifiableDBIDs newArray(DBIDs existing)

Description copied from interface: DBIDFactory

Make a new (modifiable) array of DBIDs.

Specified by:

newArray in interface DBIDFactory

Parameters:

existing - existing DBIDs to use

Returns:

New array

newHashSet

public HashSetModifiableDBIDs newHashSet(DBIDs existing)

Description copied from interface: DBIDFactory

Make a new (modifiable) hash set of DBIDs.

Specified by:

newHashSet in interface DBIDFactory

Parameters:

existing - existing DBIDs to use

Returns:

New hash set

newPair

public DBIDPair newPair(DBIDRef first,
               DBIDRef second)

Description copied from interface: DBIDFactory

Make a DBID pair from two existing DBIDs.

Specified by:

newPair in interface DBIDFactory

Parameters:

first - first DBID

second - second DBID

Returns:

new pair.

newPair

public DoubleDBIDPair newPair(double val,
                     DBIDRef id)

Description copied from interface: DBIDFactory

Make a double-DBID pair.

Specified by:

newPair in interface DBIDFactory

Parameters:

val - Double value

id - DBID

Returns:

New pair

newDistancePair

public <D extends Distance<D>> DistanceDBIDPair<D> newDistancePair(D val,
                                                          DBIDRef id)

Description copied from interface: DBIDFactory

Make a new distance-DBID pair.

Specified by:

newDistancePair in interface DBIDFactory

Type Parameters:

D - Distance type

Parameters:

val - Distance value

id - Object ID

Returns:

New pair

newDistancePair

public DoubleDistanceDBIDPair newDistancePair(double val,
                                     DBIDRef id)

Description copied from interface: DBIDFactory

Make a new distance-DBID pair.

Specified by:

newDistancePair in interface DBIDFactory

Parameters:

val - Distance value

id - Object ID

Returns:

New pair

getDBIDSerializer

public ByteBufferSerializer<DBID> getDBIDSerializer()

Description copied from interface: DBIDFactory

Get a serializer for DBIDs.

Specified by:

getDBIDSerializer in interface DBIDFactory

Returns:

DBID serializer

getDBIDSerializerStatic

public FixedSizeByteBufferSerializer<DBID> getDBIDSerializerStatic()

Description copied from interface: DBIDFactory

Get a serializer for DBIDs with static size.

Specified by:

getDBIDSerializerStatic in interface DBIDFactory

Returns:

DBID serializer

getTypeRestriction

public Class<? extends DBID> getTypeRestriction()

Description copied from interface: DBIDFactory

Get type restriction.

Specified by:

getTypeRestriction in interface DBIDFactory

Returns:

type restriction for DBIDs

invalid

public DBIDRef invalid()

Description copied from interface: DBIDFactory

Get the invalid DBID value, usable as "undefined" placeholder.

Specified by:

invalid in interface DBIDFactory

Returns:

Invalid value