DatabaseBackend (CrNiCKL database 2.0.0 API)

All Superinterfaces:

Database, PermissionChecker

All Known Implementing Classes:

DatabaseBackendImpl
```
public interface DatabaseBackend
extends Database, PermissionChecker
```
DatabaseBackend extends Database with methods used only in the implementation. Unless commented otherwise objects needing to be accessed must exist and be accessible to the user, objects to be created may not already exist, and objects to be deleted may not have important dependencies.

Author:

Jean-Paul Vetterli

Field Summary

Fields
Modifier and Type	Field and Description
`static String`	`BUILTIN_PROP_SPARSITY`
`static String`	`BUILTIN_PROP_SYMBOL`
`static String`	`BUILTIN_PROP_TIME_DOMAIN`
`static String`	`BUILTIN_PROP_TYPE`
`static String`	`DB_PARAM_Boolean_STRICT_NAME_SPACE` The name of the external parameter specifying whether to prefix full names with the database name.
`static boolean`	`DB_PARAM_Boolean_STRICT_NAME_SPACE_DEFAULT` By default, the database name does not need to be prefixed to full names.
`static String`	`DB_PARAM_Class_ChronicleUpdatePolicyExtension` The name of the external parameter naming the class implementing ChronicleUpdatePolicyExtension.
`static String`	`DB_PARAM_Class_PermissionChecker` The name of the external parameter naming the class implementing PermissionChecker.
`static String`	`DB_PARAM_Float_CACHE_LOAD_FACTOR` The name of the external parameter specifying the cache load factor.
`static float`	`DB_PARAM_Float_CACHE_LOAD_FACTOR_DEFAULT` The default cache load factor.
`static String`	`DB_PARAM_Int_CACHE_SIZE` The name of the external parameter specifying the cache size.
`static int`	`DB_PARAM_Int_CACHE_SIZE_DEFAULT` The default cache size.
`static int`	`MAGIC_NAME_NR` The number for the NAME built-in attribute.
`static int`	`MAGIC_SPARSITY_NR` The number for the SPARSITY boolean built-in attribute.
`static int`	`MAGIC_TIMEDOMAIN_NR` The number for the TIMEDOMAIN built-in attribute.
`static int`	`MAGIC_TYPE_NR` The number for the TYPE built-in attribute.
`static int`	`MAX_MAGIC_NR` The largest reserved number for built-in attributes.

Method Summary

All Methods Instance Methods Abstract Methods
Modifier and Type	Method and Description
`void`	`create(UpdatableChronicle chronicle)` Create a chronicle in the database.
`void`	`create(UpdatableProperty<?> property)` Create a property in the database.
`void`	`create(UpdatableSchema schema)` Create a schema in the database.
`<T> void`	`create(UpdatableSeries<T> series)` Create a series in the database.
`<T> void`	`create(UpdatableValueType<T> valueType)` Create a value type in the database.
`void`	`deleteAttributeValue(UpdatableChronicle chronicle, AttributeDefinition<?> def)` Remove the value and description for an attribute of a chronicle.
`void`	`deleteChronicle(UpdatableChronicle chronicle)` Delete a chronicle from the database.
`void`	`deleteProperty(UpdatableProperty<?> property)` Delete a property from the database.
`void`	`deleteSchema(UpdatableSchema schema)` Delete a schema from the database.
`<T> void`	`deleteSeries(UpdatableSeries<T> series)` Delete a series from the database.
`<T> boolean`	`deleteValue(UpdatableSeries<T> series, ch.agent.t2.time.TimeIndex t)` Delete a value from a series in the database.
`void`	`deleteValueType(UpdatableValueType<?> valueType)` Delete a value type from the database.
`Surrogate`	`findChronicle(Property<?> property, Schema schema)` Return a chronicle with an attribute value for the given property and schema.
`Surrogate`	`findChronicle(Schema schema)` Return a chronicle referencing a given schema.
`Surrogate`	`findChronicle(SeriesDefinition ss, Schema schema)` Return a chronicle with a series corresponding to the series definition and with a schema dependent on the given schema.
`<T> ValueAccessMethods<T>`	`getAccessMethods(ValueType<T> valueType)` Return the series access methods object for the given value type.
`boolean`	`getAttributeValue(List<Chronicle> chronicles, Attribute<?> attribute)` Return true if a value can be found for the attribute in one of chronicles listed.
`DatabaseCache`	`getCache()` Return the database cache.
`Chronicle`	`getChronicle(Chronicle chronicle)` Get a chronicle from the database.
`Chronicle`	`getChronicleOrNull(Chronicle parent, String simpleName)` Get the chronicle with the given parent and simple name from the database.
`<T> List<Chronicle>`	`getChroniclesByAttributeValue(Property<T> property, T value, int maxSize)` Get a number of chronicles with a given property value from the database.
`Collection<Chronicle>`	`getChroniclesByParent(Chronicle parent)` Get all chronicles with a given parent.
`ChronicleUpdatePolicy`	`getChronicleUpdatePolicy()` Return the chronicle update policy object.
`<T> ch.agent.t2.timeseries.Observation<T>`	`getFirstObservation(Series<T> series, ch.agent.t2.time.TimeIndex time)` Return the observation at a given time index or the first following observation.
`<T> ch.agent.t2.timeseries.Observation<T>`	`getLastObservation(Series<T> serie, ch.agent.t2.time.TimeIndex time)` Return the observation at a given time index or the last preceding observation.
`Property<?>`	`getProperty(String name)` Get the property with the given name from the database.
`<T> ch.agent.t2.time.Range`	`getRange(Series<T> series)` Return the range of the series.
`Collection<Surrogate>`	`getSchemaSurrogates(String pattern)` Return a collection of schema surrogates with names matching a pattern.
`SchemaUpdatePolicy`	`getSchemaUpdatePolicy()` Return the schema update policy.
`<T> Series<T>[]`	`getSeries(Chronicle chronicle, String[] names, int[] numbers)` Get an array of series in a chronicle from the database.
`UpdatableSchema`	`getUpdatableSchema(Schema schema)` Return the updatable schema corresponding to a schema.
`UpdatableSchema`	`getUpdatableSchema(Surrogate surrogate)` Get a schema from the database.
`<T> long`	`getValues(Series<T> series, ch.agent.t2.time.Range range, ch.agent.t2.timeseries.TimeAddressable<T> ts)` Load values into the time series in the range specified.
`boolean`	`isBuiltIn(AttributeDefinition<?> def)` Test whether an attribute definition is built-in.
`boolean`	`isStrictNameSpaceMode()` Test if strict name space mode has been configured.
`DBObjectId`	`makeDBObjectId(Object object)` Return a `DBObjectId` corresponding to an object.
`<T> void`	`setAccessMethods(String valueTypeExternalRepresentation, ValueAccessMethods<T> accessMethods)` Set the series access methods object for the given value type.
`void`	`setStrictNameSpaceMode(boolean strictNameSpaceMode)` Set strict name space mode.
`void`	`update(UpdatableChronicle chronicle)` Update the name and description of a chronicle.
`void`	`update(UpdatableChronicle chronicle, AttributeDefinition<?> def, String value, String description)` Set the value and description of an attribute of a chronicle.
`void`	`update(UpdatableProperty<?> property)` Modify a property in the database.
`void`	`update(UpdatableSchema schema)` Update a schema in the database.
`<T> boolean`	`update(UpdatableSeries<T> series, ch.agent.t2.time.Range range)` Reduce the range of a series in the database.
`<T> long`	`update(UpdatableSeries<T> series, ch.agent.t2.timeseries.TimeAddressable<T> values)` Update a series in the database with values from a time series.
`void`	`update(UpdatableValueType<?> valueType)` Update a value type.

Methods inherited from interface ch.agent.crnickl.api.Database
clear, close, commit, configure, createProperty, createSchema, createValueType, getChronicle, getChronicle, getMessageListener, getNamingPolicy, getProperties, getProperty, getProperty, getSchema, getSchemas, getSeries, getSeries, getSparsityBuiltInProperty, getSymbolBuiltInProperty, getTimeDomainBuiltInProperty, getTimeDomainCatalog, getTopChronicle, getTypeBuiltInProperty, getUpdatableSchemas, getUpdatableSeries, getUpdateEventPublisher, getValueType, getValueType, getValueTypes, makeSurrogate, open, rollback, setMessageListener

Methods inherited from interface ch.agent.crnickl.impl.PermissionChecker
check, check, check, check

- Field Detail
  - BUILTIN_PROP_SYMBOL
```
static final String BUILTIN_PROP_SYMBOL
```
    See Also:
    
    Constant Field Values
  - BUILTIN_PROP_TIME_DOMAIN
```
static final String BUILTIN_PROP_TIME_DOMAIN
```
    See Also:
    
    Constant Field Values
  - BUILTIN_PROP_TYPE
```
static final String BUILTIN_PROP_TYPE
```
    See Also:
    
    Constant Field Values
  - BUILTIN_PROP_SPARSITY
```
static final String BUILTIN_PROP_SPARSITY
```
    See Also:
    
    Constant Field Values
  - MAGIC_NAME_NR
```
static final int MAGIC_NAME_NR
```
    The number for the NAME built-in attribute.
    
    See Also:
    
    Constant Field Values
  - MAGIC_TYPE_NR
```
static final int MAGIC_TYPE_NR
```
    The number for the TYPE built-in attribute.
    
    See Also:
    
    Constant Field Values
  - MAGIC_TIMEDOMAIN_NR
```
static final int MAGIC_TIMEDOMAIN_NR
```
    The number for the TIMEDOMAIN built-in attribute.
    
    See Also:
    
    Constant Field Values
  - MAGIC_SPARSITY_NR
```
static final int MAGIC_SPARSITY_NR
```
    The number for the SPARSITY boolean built-in attribute.
    
    See Also:
    
    Constant Field Values
  - MAX_MAGIC_NR
```
static final int MAX_MAGIC_NR
```
    The largest reserved number for built-in attributes.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Int_CACHE_SIZE
```
static final String DB_PARAM_Int_CACHE_SIZE
```
    The name of the external parameter specifying the cache size. The actual cache size is often larger, because after taking the load factor into account, the actual size must be a power of 2. For example, a cache size of 96 with a load factor of 0.75, corresponds to 128, a power of 2; specifying 97 with a load factor of 0.75 would result in an actual size of 256.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Float_CACHE_LOAD_FACTOR
```
static final String DB_PARAM_Float_CACHE_LOAD_FACTOR
```
    The name of the external parameter specifying the cache load factor.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Boolean_STRICT_NAME_SPACE
```
static final String DB_PARAM_Boolean_STRICT_NAME_SPACE
```
    The name of the external parameter specifying whether to prefix full names with the database name.
    
    See Also:
    
    isStrictNameSpaceMode(), Constant Field Values
  - DB_PARAM_Class_ChronicleUpdatePolicyExtension
```
static final String DB_PARAM_Class_ChronicleUpdatePolicyExtension
```
    The name of the external parameter naming the class implementing ChronicleUpdatePolicyExtension.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Class_PermissionChecker
```
static final String DB_PARAM_Class_PermissionChecker
```
    The name of the external parameter naming the class implementing PermissionChecker.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Int_CACHE_SIZE_DEFAULT
```
static final int DB_PARAM_Int_CACHE_SIZE_DEFAULT
```
    The default cache size.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Float_CACHE_LOAD_FACTOR_DEFAULT
```
static final float DB_PARAM_Float_CACHE_LOAD_FACTOR_DEFAULT
```
    The default cache load factor.
    
    See Also:
    
    Constant Field Values
  - DB_PARAM_Boolean_STRICT_NAME_SPACE_DEFAULT
```
static final boolean DB_PARAM_Boolean_STRICT_NAME_SPACE_DEFAULT
```
    By default, the database name does not need to be prefixed to full names.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - isStrictNameSpaceMode
```
boolean isStrictNameSpaceMode()
```
    Test if strict name space mode has been configured. In strict name space mode, full names of chronicles start with the name of the database.
    
    Returns:
    
    true if strict name space mode is configured
  - setStrictNameSpaceMode
```
void setStrictNameSpaceMode(boolean strictNameSpaceMode)
```
    Set strict name space mode. In strict name space mode, full names of chronicles start with the name of the database. By default strict mode is off.
    
    Parameters:
    
    strictNameSpaceMode - if true set strict name space mode
  - getAccessMethods
```
<T> ValueAccessMethods<T> getAccessMethods(ValueType<T> valueType)
```
    Return the series access methods object for the given value type. Return null when no access methods have been configured for the type.
    
    Parameters:
    
    valueType - a value type
    
    Returns:
    
    an access methods object or null
  - setAccessMethods
```
<T> void setAccessMethods(String valueTypeExternalRepresentation,
                          ValueAccessMethods<T> accessMethods)
```
    Set the series access methods object for the given value type. This method is used during database configuration.
    Value types are identified using ValueType.getExternalRepresentation().
    
    Parameters:
    
    valueTypeExternalRepresentation - a string used as external representation of value type
    
    accessMethods - an access methods object
  - isBuiltIn
```
boolean isBuiltIn(AttributeDefinition<?> def)
```
    Test whether an attribute definition is built-in.
    
    Parameters:
    
    def - an attribute definition
    
    Returns:
    
    true if the attribute definition is built-in else false
  - getCache
```
DatabaseCache getCache()
```
    Return the database cache. The result is null when the cache is not configured.
    
    Returns:
    
    the database cache or null
  - getChronicleUpdatePolicy
```
ChronicleUpdatePolicy getChronicleUpdatePolicy()
```
    Return the chronicle update policy object.
    
    Returns:
    
    the chronicle update policy object
  - getSchemaUpdatePolicy
```
SchemaUpdatePolicy getSchemaUpdatePolicy()
```
    Return the schema update policy.
    
    Returns:
    
    the schema update policy
  - makeDBObjectId
```
DBObjectId makeDBObjectId(Object object)
                   throws T2DBException
```
    Return a DBObjectId corresponding to an object. The actual form of the input depends on the current database driver.
    
    Parameters:
    
    object - an object
    
    Returns:
    
    a DBObjectId
    
    Throws:
    
    T2DBException
  - getProperty
```
Property<?> getProperty(String name)
                 throws T2DBException
```
    Get the property with the given name from the database. The result is null when there is no such property.
    
    Parameters:
    
    name - a string
    
    Returns:
    
    a property or null
    
    Throws:
    
    T2DBException
  - create
```
void create(UpdatableProperty<?> property)
     throws T2DBException
```
    Create a property in the database.
    
    Parameters:
    
    property - a property
    
    Throws:
    
    T2DBException
  - deleteProperty
```
void deleteProperty(UpdatableProperty<?> property)
             throws T2DBException
```
    Delete a property from the database. The property may not be a built-in property.
    
    Parameters:
    
    property - a property
    
    Throws:
    
    T2DBException
  - update
```
void update(UpdatableProperty<?> property)
     throws T2DBException
```
    Modify a property in the database.
    
    Parameters:
    
    property - a property
    
    Throws:
    
    T2DBException
  - create
```
<T> void create(UpdatableValueType<T> valueType)
         throws T2DBException
```
    Create a value type in the database.
    
    Parameters:
    
    valueType - a value type
    
    Throws:
    
    T2DBException
  - deleteValueType
```
void deleteValueType(UpdatableValueType<?> valueType)
              throws T2DBException
```
    Delete a value type from the database. The value type may not be a built-in value type.
    
    Parameters:
    
    valueType - a value type
    
    Throws:
    
    T2DBException
  - update
```
void update(UpdatableValueType<?> valueType)
     throws T2DBException
```
    Update a value type. The name can be updated. In a restricted value type, values can be added, their description can be modified, and they can be deleted. It is not allowed to delete values in use.
    
    Parameters:
    
    valueType - a value type
    
    Throws:
    
    T2DBException
  - create
```
void create(UpdatableChronicle chronicle)
     throws T2DBException
```
    Create a chronicle in the database. The method saves the chronicle's name, description, collection, and schema. It does not saves its attributes or series. The chronicle's surrogate is upgraded.
    
    Parameters:
    
    chronicle - a chronicle
    
    Throws:
    
    T2DBException
  - deleteAttributeValue
```
void deleteAttributeValue(UpdatableChronicle chronicle,
                          AttributeDefinition<?> def)
                   throws T2DBException
```
    Remove the value and description for an attribute of a chronicle. The attribute keeps its default value as defined in the schema.
    
    Parameters:
    
    chronicle - a chronicle
    
    def - an attribute definition
    
    Throws:
    
    T2DBException
  - update
```
void update(UpdatableChronicle chronicle,
            AttributeDefinition<?> def,
            String value,
            String description)
     throws T2DBException
```
    Set the value and description of an attribute of a chronicle. The value parameter corresponds to the actual attribute value formatted by ValueType.toString(Object).
    
    Parameters:
    
    chronicle - a chronicle
    
    def - an attribute definition
    
    value - a string
    
    description - a string
    
    Throws:
    
    T2DBException
  - update
```
void update(UpdatableChronicle chronicle)
     throws T2DBException
```
    Update the name and description of a chronicle.
    
    Parameters:
    
    chronicle - a chronicle
    
    Throws:
    
    T2DBException
  - deleteChronicle
```
void deleteChronicle(UpdatableChronicle chronicle)
              throws T2DBException
```
    Delete a chronicle from the database. The chronicle must not be in use.
    
    Parameters:
    
    chronicle -
    
    Throws:
    
    T2DBException
  - getChronicle
```
Chronicle getChronicle(Chronicle chronicle)
                throws T2DBException
```
    Get a chronicle from the database.
    
    Parameters:
    
    chronicle - a chronicle
    
    Returns:
    
    the chronicle, fresh out of the database
    
    Throws:
    
    T2DBException
  - getChronicleOrNull
```
Chronicle getChronicleOrNull(Chronicle parent,
                             String simpleName)
                      throws T2DBException
```
    Get the chronicle with the given parent and simple name from the database.
    
    Parameters:
    
    parent - a chronicle
    
    simpleName - a simple name
    
    Returns:
    
    a chronicle
    
    Throws:
    
    T2DBException
  - getChroniclesByParent
```
Collection<Chronicle> getChroniclesByParent(Chronicle parent)
                                     throws T2DBException
```
    Get all chronicles with a given parent.
    
    Parameters:
    
    parent - a chronicle
    
    Returns:
    
    all direct children chronicles of the parent
    
    Throws:
    
    T2DBException
  - getChroniclesByAttributeValue
```
<T> List<Chronicle> getChroniclesByAttributeValue(Property<T> property,
                                                  T value,
                                                  int maxSize)
                                           throws T2DBException
```
    Get a number of chronicles with a given property value from the database.
    
    Parameters:
    
    property - a property
    
    value - a value
    
    maxSize - the maximum size of the result
    
    Returns:
    
    a list of chronicles
    
    Throws:
    
    T2DBException
  - getSeries
```
<T> Series<T>[] getSeries(Chronicle chronicle,
                          String[] names,
                          int[] numbers)
                   throws T2DBException
```
    Get an array of series in a chronicle from the database. The numbers identify the series within the schema. Non-positive numbers are skipped, with the corresponding element null in the result. An array of names must be passed. These are the series names as defined in the schema and are needed to construct the series object in the result.
    
    Parameters:
    
    chronicle - a chronicle
    
    names - an array of names
    
    numbers - an array of numbers
    
    Returns:
    
    an array of series
    
    Throws:
    
    T2DBException
  - getAttributeValue
```
boolean getAttributeValue(List<Chronicle> chronicles,
                          Attribute<?> attribute)
                   throws T2DBException
```
    Return true if a value can be found for the attribute in one of chronicles listed. If no value can be found return false. If there is a value for more than one chronicle, the first value found in the list wins.
    
    Parameters:
    
    chronicles - a list of chronicles
    
    attribute - an attribute
    
    Returns:
    
    true if a value was found for the attribute
    
    Throws:
    
    T2DBException
  - getValues
```
<T> long getValues(Series<T> series,
                   ch.agent.t2.time.Range range,
                   ch.agent.t2.timeseries.TimeAddressable<T> ts)
            throws T2DBException
```
    Load values into the time series in the range specified. To load all values, specify a null range. Return the number of values loaded.
    
    Parameters:
    
    series - a series
    
    range - a range or null
    
    ts - a time series
    
    Returns:
    
    the number of values loaded
    
    Throws:
    
    T2DBException
  - getFirstObservation
```
<T> ch.agent.t2.timeseries.Observation<T> getFirstObservation(Series<T> series,
                                                              ch.agent.t2.time.TimeIndex time)
                                                       throws T2DBException
```
    Return the observation at a given time index or the first following observation. If the time index is null return the first observation. Return null if there is nothing.
    
    Parameters:
    
    time - a time index
    
    Returns:
    
    an observation or null
    
    Throws:
    
    T2DBException
  - getLastObservation
```
<T> ch.agent.t2.timeseries.Observation<T> getLastObservation(Series<T> serie,
                                                             ch.agent.t2.time.TimeIndex time)
                                                      throws T2DBException
```
    Return the observation at a given time index or the last preceding observation. If the time index is null return the last observation. Return null if there is nothing.
    
    Parameters:
    
    time - a time index
    
    Returns:
    
    an observation or null
    
    Throws:
    
    T2DBException
  - getRange
```
<T> ch.agent.t2.time.Range getRange(Series<T> series)
                             throws T2DBException
```
    Return the range of the series. The result is never null. When the series has no values the range is empty.
    
    Parameters:
    
    series - a series
    
    Returns:
    
    a range
    
    Throws:
    
    T2DBException
  - create
```
<T> void create(UpdatableSeries<T> series)
         throws T2DBException
```
    Create a series in the database.
    
    Parameters:
    
    series - a series
    
    Throws:
    
    T2DBException
  - update
```
<T> long update(UpdatableSeries<T> series,
                ch.agent.t2.timeseries.TimeAddressable<T> values)
         throws T2DBException
```
    Update a series in the database with values from a time series.
    
    Parameters:
    
    series - a series
    
    values - a time series of values
    
    Returns:
    
    the number of values updated
    
    Throws:
    
    T2DBException
  - update
```
<T> boolean update(UpdatableSeries<T> series,
                   ch.agent.t2.time.Range range)
            throws T2DBException
```
    Reduce the range of a series in the database. Return true if something was done.
    
    Parameters:
    
    series - a series
    
    range - a range
    
    Returns:
    
    true if the range was modified
    
    Throws:
    
    T2DBException
  - deleteValue
```
<T> boolean deleteValue(UpdatableSeries<T> series,
                        ch.agent.t2.time.TimeIndex t)
                 throws T2DBException
```
    Delete a value from a series in the database.
    
    Parameters:
    
    series - a series
    
    t - a time index
    
    Returns:
    
    true if something done
    
    Throws:
    
    T2DBException
  - deleteSeries
```
<T> void deleteSeries(UpdatableSeries<T> series)
               throws T2DBException
```
    Delete a series from the database.
    
    Parameters:
    
    series - a series
    
    Throws:
    
    T2DBException
  - create
```
void create(UpdatableSchema schema)
     throws T2DBException
```
    Create a schema in the database.
    
    Parameters:
    
    schema - a schema
    
    Throws:
    
    T2DBException
  - update
```
void update(UpdatableSchema schema)
     throws T2DBException
```
    Update a schema in the database.
    
    Parameters:
    
    schema - a schema
    
    Throws:
    
    T2DBException
  - deleteSchema
```
void deleteSchema(UpdatableSchema schema)
           throws T2DBException
```
    Delete a schema from the database.
    
    Parameters:
    
    schema - a schema
    
    Throws:
    
    T2DBException
  - getUpdatableSchema
```
UpdatableSchema getUpdatableSchema(Surrogate surrogate)
                            throws T2DBException
```
    Get a schema from the database.
    
    Parameters:
    
    surrogate - a schema's surrogate
    
    Returns:
    
    a schema
    
    Throws:
    
    T2DBException
  - getSchemaSurrogates
```
Collection<Surrogate> getSchemaSurrogates(String pattern)
                                   throws T2DBException
```
    Return a collection of schema surrogates with names matching a pattern.
    
    Parameters:
    
    pattern - a simple pattern where "*" stands for zero or more characters
    
    Returns:
    
    a collection of schema surrogates
    
    Throws:
    
    T2DBException
  - getUpdatableSchema
```
UpdatableSchema getUpdatableSchema(Schema schema)
                            throws T2DBException
```
    Return the updatable schema corresponding to a schema.
    
    Parameters:
    
    schema - a schema
    
    Returns:
    
    an updatable schema
    
    Throws:
    
    T2DBException
  - findChronicle
```
Surrogate findChronicle(Schema schema)
                 throws T2DBException
```
    Return a chronicle referencing a given schema.
    This is technical method used in schema management.
    
    Parameters:
    
    schema - a schema
    
    Returns:
    
    a surrogate or null
    
    Throws:
    
    T2DBException
  - findChronicle
```
Surrogate findChronicle(Property<?> property,
                        Schema schema)
                 throws T2DBException
```
    Return a chronicle with an attribute value for the given property and schema.
    This is technical method used in schema management.
    
    Parameters:
    
    property - a property
    
    schema - a schema
    
    Returns:
    
    a surrogate or null
    
    Throws:
    
    T2DBException
  - findChronicle
```
Surrogate findChronicle(SeriesDefinition ss,
                        Schema schema)
                 throws T2DBException
```
    Return a chronicle with a series corresponding to the series definition and with a schema dependent on the given schema.
    This is technical method used in schema management.
    
    Parameters:
    
    ss - a series definition
    
    schema - a schema
    
    Returns:
    
    a surrogate or null
    
    Throws:
    
    T2DBException

Interface DatabaseBackend

Field Summary

Method Summary

Methods inherited from interface ch.agent.crnickl.api.Database

Methods inherited from interface ch.agent.crnickl.impl.PermissionChecker

Field Detail

BUILTIN_PROP_SYMBOL

BUILTIN_PROP_TIME_DOMAIN

BUILTIN_PROP_TYPE

BUILTIN_PROP_SPARSITY

MAGIC_NAME_NR

MAGIC_TYPE_NR

MAGIC_TIMEDOMAIN_NR

MAGIC_SPARSITY_NR

MAX_MAGIC_NR

DB_PARAM_Int_CACHE_SIZE

DB_PARAM_Float_CACHE_LOAD_FACTOR

DB_PARAM_Boolean_STRICT_NAME_SPACE

DB_PARAM_Class_ChronicleUpdatePolicyExtension

DB_PARAM_Class_PermissionChecker

DB_PARAM_Int_CACHE_SIZE_DEFAULT

DB_PARAM_Float_CACHE_LOAD_FACTOR_DEFAULT

DB_PARAM_Boolean_STRICT_NAME_SPACE_DEFAULT

Method Detail

isStrictNameSpaceMode

setStrictNameSpaceMode

getAccessMethods

setAccessMethods

isBuiltIn

getCache

getChronicleUpdatePolicy

getSchemaUpdatePolicy

makeDBObjectId

getProperty

create

deleteProperty

update

create

deleteValueType

update

create

deleteAttributeValue

update

update

deleteChronicle

getChronicle

getChronicleOrNull

getChroniclesByParent

getChroniclesByAttributeValue

getSeries

getAttributeValue

getValues

getFirstObservation

getLastObservation

getRange

create

update

update

deleteValue

deleteSeries

create

update

deleteSchema

getUpdatableSchema

getSchemaSurrogates

getUpdatableSchema

findChronicle

findChronicle

findChronicle