org.neo4j.kernel
Class EmbeddedReadOnlyGraphDatabase

java.lang.Object
  org.neo4j.kernel.AbstractGraphDatabase
      org.neo4j.kernel.EmbeddedReadOnlyGraphDatabase

All Implemented Interfaces:

GraphDatabaseService

public final class EmbeddedReadOnlyGraphDatabase
extends AbstractGraphDatabase
implements GraphDatabaseService

A read-only version of EmbeddedGraphDatabase.

Constructor Summary

EmbeddedReadOnlyGraphDatabase(String storeDir)
Creates an embedded GraphDatabaseService with a store located in storeDir.

EmbeddedReadOnlyGraphDatabase(String storeDir, Map<String,String> params)
A non-standard way of creating an embedded GraphDatabaseService with a set of configuration parameters.

Method Summary

protected void	close()
Node	createNode() Creates a new node.
Config	getConfig() Returns a non-standard configuration object.
KernelData	getKernelData()
<T> Collection<T>	getManagementBeans(Class<T> type)
Node	getNodeById(long id) Looks up a node by id.
Node	getReferenceNode() Returns the reference node, which is a "starting point" in the node space.
Relationship	getRelationshipById(long id) Looks up a relationship by id.
IndexManager	index() Returns the IndexManager paired with this graph database service and is the entry point for managing indexes coupled with this database.
static Map<String,String>	loadConfigurations(String file) A non-standard convenience method that loads a standard property file and converts it into a generic Map.
KernelEventHandler	registerKernelEventHandler(KernelEventHandler handler) Registers handler as a handler for kernel events which are generated from different places in the lifecycle of the kernel.
<T> TransactionEventHandler<T>	registerTransactionEventHandler(TransactionEventHandler<T> handler) Registers handler as a handler for transaction events which are generated from different places in the lifecycle of each transaction.
String	toString()
TransactionBuilder	tx() Returns a new builder where some aspects of the behavior can be configured.
KernelEventHandler	unregisterKernelEventHandler(KernelEventHandler handler) Unregisters handler from the list of kernel event handlers.
<T> TransactionEventHandler<T>	unregisterTransactionEventHandler(TransactionEventHandler<T> handler) Unregisters handler from the list of transaction event handlers.

Methods inherited from class org.neo4j.kernel.AbstractGraphDatabase

beginTx, createStringLogger, getAllNodes, getManagementBean, getMessageLog, getRelationshipTypes, getSingleManagementBean, getStoreDir, isEphemeral, shutdown

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.neo4j.graphdb.GraphDatabaseService

beginTx, getAllNodes, getRelationshipTypes, shutdown

Constructor Detail

EmbeddedReadOnlyGraphDatabase

public EmbeddedReadOnlyGraphDatabase(String storeDir)

Creates an embedded GraphDatabaseService with a store located in storeDir. If the directory shouldn't exist or isn't a neo4j store an exception will be thrown.

Parameters:

storeDir - the store directory for the Neo4j store files

EmbeddedReadOnlyGraphDatabase

public EmbeddedReadOnlyGraphDatabase(String storeDir,
                                     Map<String,String> params)

A non-standard way of creating an embedded GraphDatabaseService with a set of configuration parameters. Will most likely be removed in future releases.

Creates an embedded GraphDatabaseService with a store located in storeDir. If the directory shouldn't exist or isn't a neo4j store an exception will be thrown.

Parameters:

storeDir - the store directory for the db files

params - configuration parameters

Method Detail

loadConfigurations

public static Map<String,String> loadConfigurations(String file)

A non-standard convenience method that loads a standard property file and converts it into a generic Map. Will most likely be removed in future releases.

Parameters:

file - the property file to load

Returns:

a map containing the properties from the file

createNode

public Node createNode()

Description copied from interface: GraphDatabaseService

Creates a new node.

Specified by:

createNode in interface GraphDatabaseService

Returns:

the created node.

getNodeById

public Node getNodeById(long id)

Description copied from interface: GraphDatabaseService

Looks up a node by id.

Specified by:

getNodeById in interface GraphDatabaseService

Parameters:

id - the id of the node

Returns:

the node with id id if found

getRelationshipById

public Relationship getRelationshipById(long id)

Description copied from interface: GraphDatabaseService

Looks up a relationship by id.

Specified by:

getRelationshipById in interface GraphDatabaseService

Parameters:

id - the id of the relationship

Returns:

the relationship with id id if found

getReferenceNode

public Node getReferenceNode()

Description copied from interface: GraphDatabaseService

Returns the reference node, which is a "starting point" in the node space. Usually, a client attaches relationships to this node that leads into various parts of the node space. For more information about common node space organizational patterns, see the design guide at wiki.neo4j.org/content/Design_Guide.

Specified by:

getReferenceNode in interface GraphDatabaseService

Returns:

the reference node

close

protected void close()

Specified by:

close in class AbstractGraphDatabase

tx

public TransactionBuilder tx()

Description copied from class: AbstractGraphDatabase

Returns a new builder where some aspects of the behavior can be configured. The transaction will ultimately begin when calling TransactionBuilder.begin().

Specified by:

tx in class AbstractGraphDatabase

Returns:

a builder for configuring transaction behavior and ultimately begin a transaction.

getConfig

public Config getConfig()

Returns a non-standard configuration object. Will most likely be removed in future releases.

Specified by:

getConfig in class AbstractGraphDatabase

Returns:

a configuration object

getManagementBeans

public <T> Collection<T> getManagementBeans(Class<T> type)

Specified by:

getManagementBeans in class AbstractGraphDatabase

getKernelData

public KernelData getKernelData()

Specified by:

getKernelData in class AbstractGraphDatabase

toString

public String toString()

Overrides:

toString in class AbstractGraphDatabase

registerKernelEventHandler

public KernelEventHandler registerKernelEventHandler(KernelEventHandler handler)

Description copied from interface: GraphDatabaseService

Registers handler as a handler for kernel events which are generated from different places in the lifecycle of the kernel. To guarantee proper behaviour the handler should be registered right after the graph database has been started. If the specified handler instance has already been registered this method will do nothing.

Specified by:

registerKernelEventHandler in interface GraphDatabaseService

Parameters:

handler - the handler to receive events about different states in the kernel lifecycle.

Returns:

the handler passed in as the argument.

registerTransactionEventHandler

public <T> TransactionEventHandler<T> registerTransactionEventHandler(TransactionEventHandler<T> handler)

Description copied from interface: GraphDatabaseService

Registers handler as a handler for transaction events which are generated from different places in the lifecycle of each transaction. To guarantee that the handler gets all events properly it shouldn't be registered when the application is running (i.e. in the middle of one or more transactions). If the specified handler instance has already been registered this method will do nothing.

Specified by:

registerTransactionEventHandler in interface GraphDatabaseService

Type Parameters:

T - the type of state object used in the handler, see more documentation about it at TransactionEventHandler.

Parameters:

handler - the handler to receive events about different states in transaction lifecycles.

Returns:

the handler passed in as the argument.

unregisterKernelEventHandler

public KernelEventHandler unregisterKernelEventHandler(KernelEventHandler handler)

Description copied from interface: GraphDatabaseService

Unregisters handler from the list of kernel event handlers. If handler hasn't been registered with GraphDatabaseService.registerKernelEventHandler(KernelEventHandler) prior to calling this method an IllegalStateException will be thrown. After a successful call to this method the handler will no longer receive any kernel events.

Specified by:

unregisterKernelEventHandler in interface GraphDatabaseService

Parameters:

handler - the handler to receive events about different states in the kernel lifecycle.

Returns:

the handler passed in as the argument.

unregisterTransactionEventHandler

public <T> TransactionEventHandler<T> unregisterTransactionEventHandler(TransactionEventHandler<T> handler)

Description copied from interface: GraphDatabaseService

Unregisters handler from the list of transaction event handlers. If handler hasn't been registered with GraphDatabaseService.registerTransactionEventHandler(TransactionEventHandler) prior to calling this method an IllegalStateException will be thrown. After a successful call to this method the handler will no longer receive any transaction events.

Specified by:

unregisterTransactionEventHandler in interface GraphDatabaseService

Type Parameters:

T - the type of state object used in the handler, see more documentation about it at TransactionEventHandler.

Parameters:

handler - the handler to receive events about different states in transaction lifecycles.

Returns:

the handler passed in as the argument.

index

public IndexManager index()

Description copied from interface: GraphDatabaseService

Returns the IndexManager paired with this graph database service and is the entry point for managing indexes coupled with this database.

Specified by:

index in interface GraphDatabaseService

Returns:

the IndexManager for this database.