Package com.arcadedb.database

Class EmbeddedDatabase

java.lang.Object

com.arcadedb.utility.RWLockContext

com.arcadedb.database.EmbeddedDatabase

All Implemented Interfaces:

Database, DatabaseInternal, AutoCloseable

public class EmbeddedDatabase
extends RWLockContext
implements DatabaseInternal

Nested Class Summary

Nested classes/interfaces inherited from interface com.arcadedb.database.Database

Database.TransactionScope

Nested classes/interfaces inherited from interface com.arcadedb.database.DatabaseInternal

DatabaseInternal.CALLBACK_EVENT

Field Summary

Fields

Modifier and Type	Field	Description
protected DatabaseAsyncExecutorImpl	async
protected Lock	asyncLock
protected boolean	autoTransaction
protected ContextConfiguration	configuration
protected String	databasePath
static int	EDGE_LIST_INITIAL_CHUNK_SIZE
protected FileManager	fileManager
protected GraphEngine	graphEngine
AtomicLong	indexCompactions
protected DocumentIndexer	indexer
static int	MAX_RECOMMENDED_EDGE_LIST_CHUNK_SIZE
protected PaginatedFile.MODE	mode
protected String	name
protected boolean	open
protected PageManager	pageManager
protected QueryEngineManager	queryEngineManager
protected RecordFactory	recordFactory
protected EmbeddedSchema	schema
protected BinarySerializer	serializer
protected DatabaseStats	stats
protected TransactionManager	transactionManager
protected WALFileFactory	walFactory

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	EmbeddedDatabase(String path, PaginatedFile.MODE mode, ContextConfiguration configuration, Map<DatabaseInternal.CALLBACK_EVENT,List<Callable<Void>>> callbacks)

Method Summary

Modifier and Type	Method	Description
DatabaseAsyncExecutorImpl	async()
void	begin()	Begins a new transaction.
protected void	checkDatabaseIsOpen()
boolean	checkTransactionIsActive(boolean createTx)
void	close()
ResultSet	command(String language, String query, Object... parameters)
ResultSet	command(String language, String query, Map<String,Object> parameters)
void	commit()	Commits the current transaction.
long	countBucket(String bucketName)
long	countType(String typeName, boolean polymorphic)
protected void	create()
void	createRecord(MutableDocument record)
void	createRecord(Record record, String bucketName)
void	createRecordNoLock(Record record, String bucketName)
void	deleteRecord(Record record)
void	drop()
boolean	equals(Object o)	Returns true if two databases are the same.
ResultSet	execute(String language, String script, Object... args)
ResultSet	execute(String language, String script, Map<Object,Object> params)
void	executeCallbacks(DatabaseInternal.CALLBACK_EVENT event)
<RET> RET	executeInReadLock(Callable<RET> callable)	Executes a callback in a shared lock.
<RET> RET	executeInWriteLock(Callable<RET> callable)	Executes a callback in an exclusive lock.
ContextConfiguration	getConfiguration()
DatabaseContext.DatabaseContextTL	getContext()
String	getDatabasePath()
int	getEdgeListSize(int previousSize)
DatabaseInternal	getEmbedded()
ExecutionPlanCache	getExecutionPlanCache()
FileManager	getFileManager()
GraphEngine	getGraphEngine()
DocumentIndexer	getIndexer()
PaginatedFile.MODE	getMode()
String	getName()
PageManager	getPageManager()
RecordFactory	getRecordFactory()
Schema	getSchema()
BinarySerializer	getSerializer()
StatementCache	getStatementCache()
Map<String,Object>	getStats()
TransactionContext	getTransaction()
TransactionManager	getTransactionManager()
WALFileFactory	getWALFileFactory()
DatabaseInternal	getWrappedDatabaseInstance()
int	hashCode()
void	incrementStatsTxCommits()
boolean	isAutoTransaction()
boolean	isOpen()
boolean	isReadYourWrites()
boolean	isTransactionActive()
Iterator<Record>	iterateBucket(String bucketName)
Iterator<Record>	iterateType(String typeName, boolean polymorphic)
void	kill()	Test only API.
IndexCursor	lookupByKey(String type, String[] keyNames, Object[] keyValues)
IndexCursor	lookupByKey(String type, String keyName, Object keyValue)
Record	lookupByRID(RID rid, boolean loadContent)
MutableDocument	newDocument(String typeName)
Edge	newEdgeByKeys(Vertex sourceVertex, String destinationVertexType, String[] destinationVertexKeyNames, Object[] destinationVertexKeyValues, boolean createVertexIfNotExist, String edgeType, boolean bidirectional, Object... properties)
Edge	newEdgeByKeys(String sourceVertexType, String[] sourceVertexKeyNames, Object[] sourceVertexKeyValues, String destinationVertexType, String[] destinationVertexKeyNames, Object[] destinationVertexKeyValues, boolean createVertexIfNotExist, String edgeType, boolean bidirectional, Object... properties)
MutableEmbeddedDocument	newEmbeddedDocument(EmbeddedModifier modifier, String typeName)
MutableVertex	newVertex(String typeName)
protected void	open()
ResultSet	query(String language, String query, Object... parameters)
ResultSet	query(String language, String query, Map<String,Object> parameters)
void	registerCallback(DatabaseInternal.CALLBACK_EVENT event, Callable<Void> callback)
void	rollback()	Rolls back the current transaction.
void	rollbackAllNested()	Rolls back all the nested transactions if any.
void	scanBucket(String bucketName, RecordCallback callback)
void	scanType(String typeName, boolean polymorphic, DocumentCallback callback)
void	setAutoTransaction(boolean autoTransaction)
void	setEdgeListSize(int size)
void	setReadYourWrites(boolean readYourWrites)
void	setWrappedDatabaseInstance(DatabaseInternal wrappedDatabaseInstance)
String	toString()
void	transaction(Database.TransactionScope txBlock)	Executes a lambda in the transaction scope.
boolean	transaction(Database.TransactionScope txBlock, boolean joinCurrentTx)	Executes a lambda in the transaction scope.
boolean	transaction(Database.TransactionScope txBlock, boolean joinCurrentTx, int retries)	Executes a lambda in the transaction scope.
boolean	transaction(Database.TransactionScope txBlock, boolean joinCurrentTx, int retries, OkCallback ok, ErrorCallback error)	Executes a lambda in the transaction scope.
void	unregisterCallback(DatabaseInternal.CALLBACK_EVENT event, Callable<Void> callback)
void	updateRecord(Record record)
void	updateRecordNoLock(Record record)

Methods inherited from class com.arcadedb.utility.RWLockContext

readLock, readUnlock, writeLock, writeUnlock

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

EDGE_LIST_INITIAL_CHUNK_SIZE

public static final int EDGE_LIST_INITIAL_CHUNK_SIZE

See Also:

Constant Field Values

MAX_RECOMMENDED_EDGE_LIST_CHUNK_SIZE

public static final int MAX_RECOMMENDED_EDGE_LIST_CHUNK_SIZE

See Also:

Constant Field Values

indexCompactions

public final AtomicLong indexCompactions

name

protected final String name

mode

protected final PaginatedFile.MODE mode

configuration

protected final ContextConfiguration configuration

databasePath

protected final String databasePath

serializer

protected final BinarySerializer serializer

recordFactory

protected final RecordFactory recordFactory

graphEngine

protected final GraphEngine graphEngine

walFactory

protected final WALFileFactory walFactory

indexer

protected final DocumentIndexer indexer

queryEngineManager

protected final QueryEngineManager queryEngineManager

stats

protected final DatabaseStats stats

fileManager

protected FileManager fileManager

pageManager

protected PageManager pageManager

schema

protected EmbeddedSchema schema

transactionManager

protected TransactionManager transactionManager

async

protected volatile DatabaseAsyncExecutorImpl async

asyncLock

protected Lock asyncLock

autoTransaction

protected boolean autoTransaction

open

protected volatile boolean open

Constructor Detail

EmbeddedDatabase

protected EmbeddedDatabase(String path,
                           PaginatedFile.MODE mode,
                           ContextConfiguration configuration,
                           Map<DatabaseInternal.CALLBACK_EVENT,List<Callable<Void>>> callbacks)

Method Detail

open

protected void open()

create

protected void create()

drop

public void drop()

Specified by:

drop in interface Database

close

public void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Database

async

public DatabaseAsyncExecutorImpl async()

Specified by:

async in interface Database

getStats

public Map<String,Object> getStats()

Specified by:

getStats in interface DatabaseInternal

getDatabasePath

public String getDatabasePath()

Specified by:

getDatabasePath in interface Database

getTransaction

public TransactionContext getTransaction()

Specified by:

getTransaction in interface Database

Specified by:

getTransaction in interface DatabaseInternal

begin

public void begin()

Description copied from interface: Database

Begins a new transaction. If a transaction is already begun, the current transaction is parked and a new sub-transaction is begun. The new sub-transaction does not access to the content of the previous transaction. Sub transactions are totally isolated.

Specified by:

begin in interface Database

incrementStatsTxCommits

public void incrementStatsTxCommits()

commit

public void commit()

Description copied from interface: Database

Commits the current transaction. If it was a sub-transaction, then the previous in the stack becomes active again.

Specified by:

commit in interface Database

rollback

public void rollback()

Description copied from interface: Database

Rolls back the current transaction. If it was a sub-transaction, then the previous in the stack becomes active again.

Specified by:

rollback in interface Database

rollbackAllNested

public void rollbackAllNested()

Description copied from interface: Database

Rolls back all the nested transactions if any.

Specified by:

rollbackAllNested in interface Database

countBucket

public long countBucket(String bucketName)

Specified by:

countBucket in interface Database

countType

public long countType(String typeName,
                      boolean polymorphic)

Specified by:

countType in interface Database

scanType

public void scanType(String typeName,
                     boolean polymorphic,
                     DocumentCallback callback)

Specified by:

scanType in interface Database

scanBucket

public void scanBucket(String bucketName,
                       RecordCallback callback)

Specified by:

scanBucket in interface Database

iterateType

public Iterator<Record> iterateType(String typeName,
                                    boolean polymorphic)

Specified by:

iterateType in interface Database

iterateBucket

public Iterator<Record> iterateBucket(String bucketName)

Specified by:

iterateBucket in interface Database

lookupByRID

public Record lookupByRID(RID rid,
                          boolean loadContent)

Specified by:

lookupByRID in interface Database

lookupByKey

public IndexCursor lookupByKey(String type,
                               String keyName,
                               Object keyValue)

Specified by:

lookupByKey in interface Database

lookupByKey

public IndexCursor lookupByKey(String type,
                               String[] keyNames,
                               Object[] keyValues)

Specified by:

lookupByKey in interface Database

registerCallback

public void registerCallback(DatabaseInternal.CALLBACK_EVENT event,
                             Callable<Void> callback)

Specified by:

registerCallback in interface DatabaseInternal

unregisterCallback

public void unregisterCallback(DatabaseInternal.CALLBACK_EVENT event,
                               Callable<Void> callback)

Specified by:

unregisterCallback in interface DatabaseInternal

getGraphEngine

public GraphEngine getGraphEngine()

Specified by:

getGraphEngine in interface DatabaseInternal

getTransactionManager

public TransactionManager getTransactionManager()

Specified by:

getTransactionManager in interface DatabaseInternal

isReadYourWrites

public boolean isReadYourWrites()

Specified by:

isReadYourWrites in interface Database

setReadYourWrites

public void setReadYourWrites(boolean readYourWrites)

Specified by:

setReadYourWrites in interface Database

createRecord

public void createRecord(MutableDocument record)

Specified by:

createRecord in interface DatabaseInternal

createRecord

public void createRecord(Record record,
                         String bucketName)

Specified by:

createRecord in interface DatabaseInternal

createRecordNoLock

public void createRecordNoLock(Record record,
                               String bucketName)

Specified by:

createRecordNoLock in interface DatabaseInternal

updateRecord

public void updateRecord(Record record)

Specified by:

updateRecord in interface DatabaseInternal

updateRecordNoLock

public void updateRecordNoLock(Record record)

Specified by:

updateRecordNoLock in interface DatabaseInternal

deleteRecord

public void deleteRecord(Record record)

Specified by:

deleteRecord in interface Database

isTransactionActive

public boolean isTransactionActive()

Specified by:

isTransactionActive in interface Database

transaction

public void transaction(Database.TransactionScope txBlock)

Description copied from interface: Database

Executes a lambda in the transaction scope. If there is an active transaction, then the current transaction is parked and a new sub-transaction is begun.

Specified by:

transaction in interface Database

Parameters:

txBlock - Transaction lambda to execute

transaction

public boolean transaction(Database.TransactionScope txBlock,
                           boolean joinCurrentTx)

Description copied from interface: Database

Executes a lambda in the transaction scope. If there is an active transaction, then the current transaction is parked and a new sub-transaction is begun if joinCurrentTx is true, otherwise the current active transaction is joined.

Specified by:

transaction in interface Database

Parameters:

txBlock - Transaction lambda to execute

joinCurrentTx - if active joins the current transaction, otherwise always create a new one

Returns:

true if a new transaction has been created or false if an existent transaction has been joined

transaction

public boolean transaction(Database.TransactionScope txBlock,
                           boolean joinCurrentTx,
                           int retries)

Description copied from interface: Database

Executes a lambda in the transaction scope. If there is an active transaction, then the current transaction is parked and a new sub-transaction is begun if joinCurrentTx is true, otherwise the current active transaction is joined. The difference with the method Database.transaction(TransactionScope) is that in case the NeedRetryException exception is thrown, the transaction is re-executed for a number of retries.

Specified by:

transaction in interface Database

Parameters:

txBlock - Transaction lambda to execute

joinCurrentTx - if active joins the current transaction, otherwise always create a new one

retries - number of retries in case the NeedRetryException exception is thrown

Returns:

true if a new transaction has been created or false if an existent transaction has been joined

transaction

public boolean transaction(Database.TransactionScope txBlock,
                           boolean joinCurrentTx,
                           int retries,
                           OkCallback ok,
                           ErrorCallback error)

Description copied from interface: Database

Executes a lambda in the transaction scope. If there is an active transaction, then the current transaction is parked and a new sub-transaction is begun if joinCurrentTx is true, otherwise the current active transaction is joined. The difference with the method Database.transaction(TransactionScope) is that in case the NeedRetryException exception is thrown, the transaction is re-executed for a number of retries.

Specified by:

transaction in interface Database

Parameters:

txBlock - Transaction lambda to execute

joinCurrentTx - if active joins the current transaction, otherwise always create a new one

retries - number of retries in case the NeedRetryException exception is thrown

ok - callback invoked if the transaction completes the commit

error - callback invoked if the transaction cannot complete the commit, after the rollback

Returns:

true if a new transaction has been created or false if an existent transaction has been joined

getRecordFactory

public RecordFactory getRecordFactory()

Specified by:

getRecordFactory in interface DatabaseInternal

getSchema

public Schema getSchema()

Specified by:

getSchema in interface Database

getSerializer

public BinarySerializer getSerializer()

Specified by:

getSerializer in interface DatabaseInternal

getPageManager

public PageManager getPageManager()

Specified by:

getPageManager in interface DatabaseInternal

newDocument

public MutableDocument newDocument(String typeName)

Specified by:

newDocument in interface Database

newEmbeddedDocument

public MutableEmbeddedDocument newEmbeddedDocument(EmbeddedModifier modifier,
                                                   String typeName)

Specified by:

newEmbeddedDocument in interface DatabaseInternal

newVertex

public MutableVertex newVertex(String typeName)

Specified by:

newVertex in interface Database

newEdgeByKeys

public Edge newEdgeByKeys(String sourceVertexType,
                          String[] sourceVertexKeyNames,
                          Object[] sourceVertexKeyValues,
                          String destinationVertexType,
                          String[] destinationVertexKeyNames,
                          Object[] destinationVertexKeyValues,
                          boolean createVertexIfNotExist,
                          String edgeType,
                          boolean bidirectional,
                          Object... properties)

Specified by:

newEdgeByKeys in interface Database

newEdgeByKeys

public Edge newEdgeByKeys(Vertex sourceVertex,
                          String destinationVertexType,
                          String[] destinationVertexKeyNames,
                          Object[] destinationVertexKeyValues,
                          boolean createVertexIfNotExist,
                          String edgeType,
                          boolean bidirectional,
                          Object... properties)

Specified by:

newEdgeByKeys in interface Database

isAutoTransaction

public boolean isAutoTransaction()

Specified by:

isAutoTransaction in interface Database

setAutoTransaction

public void setAutoTransaction(boolean autoTransaction)

Specified by:

setAutoTransaction in interface Database

getFileManager

public FileManager getFileManager()

Specified by:

getFileManager in interface DatabaseInternal

getName

public String getName()

Specified by:

getName in interface Database

getMode

public PaginatedFile.MODE getMode()

Specified by:

getMode in interface Database

checkTransactionIsActive

public boolean checkTransactionIsActive(boolean createTx)

Specified by:

checkTransactionIsActive in interface Database

kill

public void kill()

Test only API.

Specified by:

kill in interface DatabaseInternal

getIndexer

public DocumentIndexer getIndexer()

Specified by:

getIndexer in interface DatabaseInternal

command

public ResultSet command(String language,
                         String query,
                         Object... parameters)

Specified by:

command in interface Database

command

public ResultSet command(String language,
                         String query,
                         Map<String,Object> parameters)

Specified by:

command in interface Database

execute

public ResultSet execute(String language,
                         String script,
                         Map<Object,Object> params)

Specified by:

execute in interface Database

execute

public ResultSet execute(String language,
                         String script,
                         Object... args)

Specified by:

execute in interface Database

query

public ResultSet query(String language,
                       String query,
                       Object... parameters)

Specified by:

query in interface Database

query

public ResultSet query(String language,
                       String query,
                       Map<String,Object> parameters)

Specified by:

query in interface Database

equals

public boolean equals(Object o)

Returns true if two databases are the same.

Overrides:

equals in class Object

getContext

public DatabaseContext.DatabaseContextTL getContext()

Specified by:

getContext in interface DatabaseInternal

executeInReadLock

public <RET> RET executeInReadLock(Callable<RET> callable)

Executes a callback in a shared lock.

Specified by:

executeInReadLock in interface Database

Overrides:

executeInReadLock in class RWLockContext

executeInWriteLock

public <RET> RET executeInWriteLock(Callable<RET> callable)

Executes a callback in an exclusive lock.

Specified by:

executeInWriteLock in interface Database

Overrides:

executeInWriteLock in class RWLockContext

getStatementCache

public StatementCache getStatementCache()

Specified by:

getStatementCache in interface DatabaseInternal

getExecutionPlanCache

public ExecutionPlanCache getExecutionPlanCache()

Specified by:

getExecutionPlanCache in interface DatabaseInternal

getWALFileFactory

public WALFileFactory getWALFileFactory()

Specified by:

getWALFileFactory in interface DatabaseInternal

hashCode

public int hashCode()

Overrides:

hashCode in class Object

executeCallbacks

public void executeCallbacks(DatabaseInternal.CALLBACK_EVENT event)
                      throws IOException

Specified by:

executeCallbacks in interface DatabaseInternal

Throws:

IOException

getEmbedded

public DatabaseInternal getEmbedded()

Specified by:

getEmbedded in interface DatabaseInternal

getConfiguration

public ContextConfiguration getConfiguration()

Specified by:

getConfiguration in interface Database

isOpen

public boolean isOpen()

Specified by:

isOpen in interface Database

toString

public String toString()

Overrides:

toString in class Object

getWrappedDatabaseInstance

public DatabaseInternal getWrappedDatabaseInstance()

Specified by:

getWrappedDatabaseInstance in interface DatabaseInternal

setWrappedDatabaseInstance

public void setWrappedDatabaseInstance(DatabaseInternal wrappedDatabaseInstance)

setEdgeListSize

public void setEdgeListSize(int size)

Specified by:

setEdgeListSize in interface Database

getEdgeListSize

public int getEdgeListSize(int previousSize)

Specified by:

getEdgeListSize in interface DatabaseInternal

checkDatabaseIsOpen

protected void checkDatabaseIsOpen()