org.neo4j.kernel
Class EmbeddedReadOnlyGraphDatabase

java.lang.Object
  extended by org.neo4j.kernel.EmbeddedReadOnlyGraphDatabase
All Implemented Interfaces:
GraphDatabaseService

public final class EmbeddedReadOnlyGraphDatabase
extends Object
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
 Transaction beginTx()
          Starts a new transaction and associates it with the current thread.
 Node createNode()
          Creates a new node.
 boolean enableRemoteShell()
          Enables remote shell access (with default configuration) to this Neo4j instance, if the Neo4j shell component is available on the classpath.
 boolean enableRemoteShell(Map<String,Serializable> initialProperties)
          Enables remote shell access to this Neo4j instance, if the Neo4j Shell component is available on the classpath.
 Iterable<Node> getAllNodes()
          Returns all nodes in the node space.
 Config getConfig()
          Returns a non-standard configuration object.
 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.
 Iterable<RelationshipType> getRelationshipTypes()
          Returns all relationship types currently in the underlying store.
 String getStoreDir()
           
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.
 void shutdown()
          Shuts down Neo4j.
 String toString()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

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

shutdown

public void shutdown()
Description copied from interface: GraphDatabaseService
Shuts down Neo4j. After this method has been invoked, it's invalid to invoke any methods in the Neo4j API and all references to this instance of GraphDatabaseService should be discarded.

Specified by:
shutdown in interface GraphDatabaseService

enableRemoteShell

public boolean enableRemoteShell()
Description copied from interface: GraphDatabaseService
Enables remote shell access (with default configuration) to this Neo4j instance, if the Neo4j shell component is available on the classpath. This method is identical to invoking enableRemoteShell( null ).

Specified by:
enableRemoteShell in interface GraphDatabaseService
Returns:
true if the shell has been enabled, false otherwise (false usually indicates that the shell jar dependency is not on the classpath)

enableRemoteShell

public boolean enableRemoteShell(Map<String,Serializable> initialProperties)
Description copied from interface: GraphDatabaseService
Enables remote shell access to this Neo4j instance, if the Neo4j Shell component is available on the classpath. This will publish a shell access interface on an RMI registry on localhost (with configurable port and RMI binding name). It can be accessed by a client that implements org.neo4j.shell.ShellClient from the Neo4j Shell project. Typically, the neo4j-shell binary package is used (see neo4j.org/download).

The shell is parameterized by a map of properties passed in to this method. Currently, two properties are used:

Specified by:
enableRemoteShell in interface GraphDatabaseService
Parameters:
initialProperties - a set of properties that will be used to configure the remote shell, or null if the default properties should be used
Returns:
true if the shell has been enabled, false otherwise (false usually indicates that the shell jar dependency is not on the classpath)

getRelationshipTypes

public Iterable<RelationshipType> getRelationshipTypes()
Description copied from interface: GraphDatabaseService
Returns all relationship types currently in the underlying store. Relationship types are added to the underlying store the first time they are used in a successfully commited node.createRelationshipTo(...). Note that this method is guaranteed to return all known relationship types, but it does not guarantee that it won't return more than that (e.g. it can return "historic" relationship types that no longer have any relationships in the node space).

Specified by:
getRelationshipTypes in interface GraphDatabaseService
Returns:
all relationship types in the underlying store

beginTx

public Transaction beginTx()
Description copied from interface: GraphDatabaseService
Starts a new transaction and associates it with the current thread.

Specified by:
beginTx in interface GraphDatabaseService
Returns:
a new transaction instance
Throws:
org.neo4j.kernel.impl.transaction.TransactionFailureException - if unable to start transaction

getConfig

public Config getConfig()
Returns a non-standard configuration object. Will most likely be removed in future releases.

Returns:
a configuration object

toString

public String toString()
Overrides:
toString in class Object

getStoreDir

public String getStoreDir()

getAllNodes

public Iterable<Node> getAllNodes()
Description copied from interface: GraphDatabaseService
Returns all nodes in the node space.

Specified by:
getAllNodes in interface GraphDatabaseService
Returns:
all nodes in the node space


Copyright © 2010 Neo4j. All Rights Reserved.