ILcdFeatured
interface has been deprecated in favor of ILcdDataObject
and TLcdDataModel
.@Deprecated public interface ILcdFeatureIndexedModel extends ILcdModel
ILcdModel
whose elements can be retrieved via a feature value-based index.
First an index on a certain set of features must be created in order to have efficient access to the model
elements using these features. After adding an index, elements can be retrieved using a set of values for the
features specified in the index.
Two types of indices are supported:
ILcdFeatured
interface) and which additional constraints they impose on the model (for example, have a model
descriptor that implements ILcdFeaturedModelDescriptor
).ILcdModel.Query
FIRE_LATER, FIRE_NOW, NO_EVENT
Modifier and Type | Method and Description |
---|---|
void |
addIndex(List aFeatureNames,
boolean aUniqueIndex)
Deprecated.
Creates an index based on a set of feature names.
|
boolean |
canAddIndex(List aFeatureNames,
boolean aIsUniqueIndex)
Deprecated.
Returns whether a useful index can be created for the given list of feature names.
|
void |
removeIndex(List aFeatureNames)
Deprecated.
Removes an index from the model.
|
Vector |
retrieveByIndex(List aFeatureNames,
List aFeatureValues)
Deprecated.
Returns a
Vector containing all the model elements that have aFeatureValues as value
for the index defined by aFeatureNames . |
Object |
retrieveByUniqueIndex(List aFeatureNames,
List aFeatureValues)
Deprecated.
Returns a single model element that has aFeatureValues as values for the index defined by aFeatureNames.
|
addElement, addElements, addModelListener, all, canAddElement, canRemoveElement, dispose, elementChanged, elements, elementsChanged, filter, fireCollectedModelChanges, getModelDescriptor, getModelEncoder, getModelMetadata, getModelReference, query, removeAllElements, removeElement, removeElements, removeModelListener
close
void addIndex(List aFeatureNames, boolean aUniqueIndex)
aFeatureNames
- the List
of feature names defining the index to be created.aUniqueIndex
- a boolean indicating whether the features used in this index form a unique key for the model
elements (this means that for each element the set of feature values for aFeatureNames
is unique in the model). If a unique index is created on a non-unique feature, only one
element per feature value is stored in the index.NullPointerException
- if aFeatureNames or one of its elements is null
.}.Vector retrieveByIndex(List aFeatureNames, List aFeatureValues)
Vector
containing all the model elements that have aFeatureValues
as value
for the index defined by aFeatureNames
.
Can return null
if there is no match.aFeatureNames
- a List
of feature names defining the index to be used.aFeatureValues
- a List
of feature values that should match with the values of the elements to be
retrieved.null
if there is no matchIllegalArgumentException
- if no index was added for aFeatureNames
.NullPointerException
- if aFeatureNames == null || aFeatureValues == null
or one of the feature names
is null
.Object retrieveByUniqueIndex(List aFeatureNames, List aFeatureValues)
aUniqueIndex == true
.aFeatureNames
- a List
of feature names defining the index to be used.aFeatureValues
- a List
of feature values that should match with the values of the elements to be
retrieved.aFeatureValues
as values for the index defined by
aFeatureNames
, or null
if no such element exist in this model.IllegalArgumentException
- if no index was added for aFeatureNames
, or if the index was created
as a non-unique index.NullPointerException
- if aFeatureNames == null || aFeatureValues == null
or one of the feature names
is null
.void removeIndex(List aFeatureNames)
aFeatureNames
- a List
of feature names defining the index to be removed.NullPointerException
- if aFeatureNames or one of its elements is null
.boolean canAddIndex(List aFeatureNames, boolean aIsUniqueIndex)
aFeatureNames
- a List
of feature names defining the index to be validated.aIsUniqueIndex
- a boolean indicating whether the features used in this index form a unique key for the model
elements.true
if a useful index can be created for the given list of feature names, false
otherwise.