com.orientechnologies.orient.core.db.document

Interface ODatabaseDocument

All Superinterfaces:

AutoCloseable, Closeable, OBackupable, ODatabase<ORecord>, ODatabaseSchemaAware<ORecord>

All Known Subinterfaces:

ODatabaseDocumentInternal

All Known Implementing Classes:

ODatabaseDocumentTx, ODatabaseDocumentTxPooled

public interface ODatabaseDocument
extends ODatabase<ORecord>, ODatabaseSchemaAware<ORecord>

Generic interface for document based Database implementations.

Author:

Luca Garulli

Nested Class Summary

Nested classes/interfaces inherited from interface com.orientechnologies.orient.core.db.ODatabase

ODatabase.ATTRIBUTES, ODatabase.OPERATION_MODE, ODatabase.OPTIONS, ODatabase.STATUS

Field Summary

Fields

Modifier and Type	Field and Description
static String	TYPE

Method Summary

Modifier and Type	Method and Description
int	addBlobCluster(String iClusterName, Object... iParameters) Add a cluster for blob records.
ORecordIteratorClass<ODocument>	browseClass(String iClassName) Browses all the records of the specified class and also all the subclasses.
ORecordIteratorClass<ODocument>	browseClass(String iClassName, boolean iPolymorphic) Browses all the records of the specified class and if iPolymorphic is true also all the subclasses.
<REC extends ORecord> ORecordIteratorCluster<REC>	browseCluster(String iClusterName) Browses all the records of the specified cluster.
<REC extends ORecord> ORecordIteratorCluster<REC>	browseCluster(String iClusterName, Class<REC> iRecordClass) Browses all the records of the specified cluster of the passed record type.
<REC extends ORecord> ORecordIteratorCluster<REC>	browseCluster(String iClusterName, Class<REC> iRecordClass, long startClusterPosition, long endClusterPosition)
<REC extends ORecord> ORecordIteratorCluster<REC>	browseCluster(String iClusterName, Class<REC> iRecordClass, long startClusterPosition, long endClusterPosition, boolean loadTombstones) Deprecated.
<REC extends ORecord> ORecordIteratorCluster<REC>	browseCluster(String iClusterName, long startClusterPosition, long endClusterPosition, boolean loadTombstones)
<DB extends ODatabaseDocument> DB	checkSecurity(ORule.ResourceGeneric iResourceGeneric, int iOperation, Object... iResourcesSpecific) Checks if the operation against multiple resources is allowed for the current user.
<DB extends ODatabaseDocument> DB	checkSecurity(ORule.ResourceGeneric iResourceGeneric, int iOperation, Object iResourceSpecific) Checks if the operation on a resource is allowed for the current user.
<DB extends ODatabaseDocument> DB	checkSecurity(ORule.ResourceGeneric resourceGeneric, String resourceSpecific, int iOperation) Checks if the operation on a resource is allowed for the current user.
<DB extends ODatabaseDocument> DB	checkSecurity(String iResource, int iOperation) Deprecated.
<DB extends ODatabaseDocument> DB	checkSecurity(String iResourceGeneric, int iOperation, Object... iResourcesSpecific) Deprecated.
<DB extends ODatabaseDocument> DB	checkSecurity(String iResourceGeneric, int iOperation, Object iResourceSpecific) Deprecated.
void	freeze() Flush all indexes and cached storage content to the disk.
void	freeze(boolean throwException) Flush all indexes and cached storage content to the disk.
OIntent	getActiveIntent() Return the active intent.
<RET extends ORecord> RET	getRecord(OIdentifiable iIdentifiable) Returns the record for a OIdentifiable instance.
byte	getRecordType() Returns the default record type for this kind of database.
boolean	isPooled()
boolean	isRetainRecords() Returns true if current configuration retains objects, otherwise false
boolean	isValidationEnabled() Tells if validation of record is active.
void	release() Allows to execute write-related commands on DB.
ODatabaseDocument	setRetainRecords(boolean iValue) Specifies if retain handled objects in memory or not.
<DB extends ODatabaseDocument> DB	setValidationEnabled(boolean iEnabled) Enables or disables the record validation.

Methods inherited from interface com.orientechnologies.orient.core.db.ODatabaseSchemaAware

countClass, countClass, newInstance

Methods inherited from interface com.orientechnologies.orient.core.db.ODatabase

activateOnCurrentThread, addCluster, addCluster, alterCluster, alterCluster, begin, begin, begin, cleanOutRecord, close, command, commit, commit, countClusterElements, countClusterElements, countClusterElements, countClusterElements, countClusterElements, create, create, create, declareIntent, delete, delete, delete, drop, dropCluster, dropCluster, exists, existsCluster, get, getBlobClusterIds, getClusterIdByName, getClusterNameById, getClusterNames, getClusterRecordSizeById, getClusterRecordSizeByName, getClusters, getConfiguration, getConflictStrategy, getDefaultClusterId, getDictionary, getHooks, getListeners, getLocalCache, getMetadata, getName, getProperties, getProperty, getRecordMetadata, getSize, getStatus, getTransaction, getType, getURL, getUser, hide, incrementalBackup, isActiveOnCurrentThread, isClosed, isFrozen, isMVCC, load, load, load, load, load, load, load, load, load, load, newInstance, open, query, registerHook, registerHook, registerListener, reload, reload, reload, rollback, rollback, save, save, save, save, set, setConflictStrategy, setConflictStrategy, setMVCC, setProperty, setStatus, truncateCluster, unregisterHook, unregisterListener

Methods inherited from interface com.orientechnologies.orient.core.util.OBackupable

backup, restore

Field Detail

TYPE

static final String TYPE

See Also:

Constant Field Values

Method Detail

browseClass

ORecordIteratorClass<ODocument> browseClass(String iClassName)

Browses all the records of the specified class and also all the subclasses. If you've a class Vehicle and Car that extends Vehicle then a db.browseClass("Vehicle", true) will return all the instances of Vehicle and Car. The order of the returned instance starts from record id with position 0 until the end. Base classes are worked at first.

Parameters:

iClassName - Class name to iterate

Returns:

Iterator of ODocument instances

browseClass

ORecordIteratorClass<ODocument> browseClass(String iClassName,
                                            boolean iPolymorphic)

Browses all the records of the specified class and if iPolymorphic is true also all the subclasses. If you've a class Vehicle and Car that extends Vehicle then a db.browseClass("Vehicle", true) will return all the instances of Vehicle and Car. The order of the returned instance starts from record id with position 0 until the end. Base classes are worked at first.

Parameters:

iClassName - Class name to iterate

iPolymorphic - Consider also the instances of the subclasses or not

Returns:

Iterator of ODocument instances

freeze

void freeze()

Flush all indexes and cached storage content to the disk. After this call users can perform only select queries. All write-related commands will queued till release() command will be called. Given command waits till all on going modifications in indexes or DB will be finished. IMPORTANT: This command is not reentrant.

Specified by:

freeze in interface ODatabase<ORecord>

See Also:

ODatabase.release()

release

void release()

Allows to execute write-related commands on DB. Called after freeze() command.

Specified by:

release in interface ODatabase<ORecord>

See Also:

ODatabase.freeze()

freeze

void freeze(boolean throwException)

Flush all indexes and cached storage content to the disk. After this call users can perform only select queries. All write-related commands will queued till release() command will be called or exception will be thrown on attempt to modify DB data. Concrete behaviour depends on throwException parameter. IMPORTANT: This command is not reentrant.

Specified by:

freeze in interface ODatabase<ORecord>

Parameters:

throwException - If true OModificationOperationProhibitedException exception will be thrown in case of write command will be performed.

browseCluster

<REC extends ORecord> ORecordIteratorCluster<REC> browseCluster(String iClusterName)

Browses all the records of the specified cluster.

Parameters:

iClusterName - Cluster name to iterate

Returns:

Iterator of ODocument instances

browseCluster

<REC extends ORecord> ORecordIteratorCluster<REC> browseCluster(String iClusterName,
                                                                long startClusterPosition,
                                                                long endClusterPosition,
                                                                boolean loadTombstones)

browseCluster

<REC extends ORecord> ORecordIteratorCluster<REC> browseCluster(String iClusterName,
                                                                Class<REC> iRecordClass)

Browses all the records of the specified cluster of the passed record type.

Parameters:

iClusterName - Cluster name to iterate

iRecordClass - The record class expected

Returns:

Iterator of ODocument instances

browseCluster

<REC extends ORecord> ORecordIteratorCluster<REC> browseCluster(String iClusterName,
                                                                Class<REC> iRecordClass,
                                                                long startClusterPosition,
                                                                long endClusterPosition)

browseCluster

@Deprecated
<REC extends ORecord> ORecordIteratorCluster<REC> browseCluster(String iClusterName,
                                                                            Class<REC> iRecordClass,
                                                                            long startClusterPosition,
                                                                            long endClusterPosition,
                                                                            boolean loadTombstones)

Deprecated.

getRecord

<RET extends ORecord> RET getRecord(OIdentifiable iIdentifiable)

Returns the record for a OIdentifiable instance. If the argument received already is a ORecord instance, then it's returned as is, otherwise a new ORecord is created with the identity received and returned.

Parameters:

iIdentifiable -

Returns:

A ORecord instance

getRecordType

byte getRecordType()

Returns the default record type for this kind of database.

isRetainRecords

boolean isRetainRecords()

Returns true if current configuration retains objects, otherwise false

See Also:

setRetainRecords(boolean)

setRetainRecords

ODatabaseDocument setRetainRecords(boolean iValue)

Specifies if retain handled objects in memory or not. Setting it to false can improve performance on large inserts. Default is enabled.

Parameters:

iValue - True to enable, false to disable it.

See Also:

isRetainRecords()

checkSecurity

<DB extends ODatabaseDocument> DB checkSecurity(ORule.ResourceGeneric resourceGeneric,
                                                String resourceSpecific,
                                                int iOperation)

Checks if the operation on a resource is allowed for the current user.

Parameters:

resourceGeneric - Generic Resource where to execute the operation

resourceGeneric - Specific resource name where to execute the operation

iOperation - Operation to execute against the resource

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

checkSecurity

<DB extends ODatabaseDocument> DB checkSecurity(ORule.ResourceGeneric iResourceGeneric,
                                                int iOperation,
                                                Object iResourceSpecific)

Checks if the operation on a resource is allowed for the current user. The check is made in two steps:

1. Access to all the resource as *
2. Access to the specific target resource

Parameters:

iResourceGeneric - Resource where to execute the operation, i.e.: database.clusters

iOperation - Operation to execute against the resource

iResourceSpecific - Target resource, i.e.: "employee" to specify the cluster name.

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

checkSecurity

<DB extends ODatabaseDocument> DB checkSecurity(ORule.ResourceGeneric iResourceGeneric,
                                                int iOperation,
                                                Object... iResourcesSpecific)

Checks if the operation against multiple resources is allowed for the current user. The check is made in two steps:

1. Access to all the resource as *
2. Access to the specific target resources

Parameters:

iResourceGeneric - Resource where to execute the operation, i.e.: database.clusters

iOperation - Operation to execute against the resource

iResourcesSpecific - Target resources as an array of Objects, i.e.: ["employee", 2] to specify cluster name and id.

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

isValidationEnabled

boolean isValidationEnabled()

Tells if validation of record is active. Default is true.

Returns:

true if it's active, otherwise false.

setValidationEnabled

<DB extends ODatabaseDocument> DB setValidationEnabled(boolean iEnabled)

Enables or disables the record validation. Since 2.2 this setting is persistent.

Parameters:

iEnabled - True to enable, false to disable

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

checkSecurity

@Deprecated
<DB extends ODatabaseDocument> DB checkSecurity(String iResource,
                                                            int iOperation)

Deprecated.

Checks if the operation on a resource is allowed for the current user.

Parameters:

iResource - Resource where to execute the operation

iOperation - Operation to execute against the resource

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

checkSecurity

@Deprecated
<DB extends ODatabaseDocument> DB checkSecurity(String iResourceGeneric,
                                                            int iOperation,
                                                            Object iResourceSpecific)

Deprecated.

Checks if the operation on a resource is allowed for the current user. The check is made in two steps:

1. Access to all the resource as *
2. Access to the specific target resource

Parameters:

iResourceGeneric - Resource where to execute the operation, i.e.: database.clusters

iOperation - Operation to execute against the resource

iResourceSpecific - Target resource, i.e.: "employee" to specify the cluster name.

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

checkSecurity

@Deprecated
<DB extends ODatabaseDocument> DB checkSecurity(String iResourceGeneric,
                                                            int iOperation,
                                                            Object... iResourcesSpecific)

Deprecated.

Checks if the operation against multiple resources is allowed for the current user. The check is made in two steps:

1. Access to all the resource as *
2. Access to the specific target resources

Parameters:

iResourceGeneric - Resource where to execute the operation, i.e.: database.clusters

iOperation - Operation to execute against the resource

iResourcesSpecific - Target resources as an array of Objects, i.e.: ["employee", 2] to specify cluster name and id.

Returns:

The Database instance itself giving a "fluent interface". Useful to call multiple methods in chain.

isPooled

boolean isPooled()

Returns:

true if database is obtained from the pool and false otherwise.

addBlobCluster

int addBlobCluster(String iClusterName,
                   Object... iParameters)

Add a cluster for blob records.

Specified by:

addBlobCluster in interface ODatabase<ORecord>

Parameters:

iClusterName - Cluster name

iParameters - Additional parameters to pass to the factories

Returns:

Cluster id

getActiveIntent

OIntent getActiveIntent()

Return the active intent.

Returns: