com.sparsity.sparksee.gdb
Class Graph

java.lang.Object
  extended by com.sparsity.sparksee.gdb.Graph

public class Graph
extends java.lang.Object

Graph class.

Each Database has a Graph associated, which is the persistent graph which contains all data stored into the graph database and is retrieved from a Session.

Check out the 'API' and the 'SPARKSEE graph database' sections in the SPARKSEE User Manual for more details on the use of this class.

Author:
Sparsity Technologies http://www.sparsity-technologies.com

Method Summary
 void backup(java.lang.String file)
          Dumps all the data to a backup file.
 long countEdges()
          Gets the number of edges.
 long countNodes()
          Gets the number of nodes.
 long degree(long oid, int etype, EdgesDirection dir)
          Gets the number of edges from or to the given node OID and for the given edge type.
 void drop(long oid)
          Drops the given OID.
 void drop(Objects objs)
          Drops all the OIDs from the given collection.
 void dumpData(java.lang.String file)
          Dumps logical data to a file.
 void dumpStorage(java.lang.String file)
          Dumps internal storage data to a file.
 Objects edges(int etype, long tail, long head)
          Gets all the edges of the given type between two given nodes (tail and head).
 Objects explode(long oid, int etype, EdgesDirection dir)
          Selects all edges from or to the given node OID and for the given edge type.
 Objects explode(Objects objs, int etype, EdgesDirection dir)
          Selects all edges from or to each of the node OID in the given collection and for the given edge type.
 void export(java.lang.String file, ExportType type, ExportManager em)
          Exports the Graph.
 int findAttribute(int type, java.lang.String name)
          Gets the Sparksee attribute identifier for the given type identifier and attribute name.
 AttributeList findAttributes(int type)
          Gets all existing Sparksee attribute identifiers for the given type identifier.
 long findEdge(int etype, long tail, long head)
          Gets any of the edges of the given type between two given nodes (tail and head).
 TypeList findEdgeTypes()
          Gets all existing Sparksee edge type identifiers.
 TypeList findNodeTypes()
          Gets all existing Sparksee node type identifiers.
 long findObject(int attr, Value value)
          Finds one object having the given Value for the given attribute.
 long findOrCreateEdge(int etype, long tail, long head)
          Gets any of the edges of the specified type between two given nodes (tail and head).
 long findOrCreateObject(int attr, Value value)
          Finds one object having the given Value for the attribute or it creates one does not exist any.
 int findType(java.lang.String name)
          Gets the Sparksee type identifier for the given type name.
 TypeList findTypes()
          Gets all existing Sparksee node and edge type identifiers.
 Attribute getAttribute(int attr)
          Gets information about the given attribute.
 Value getAttribute(long oid, int attr)
          Gets the Value for the given attribute and OID.
 void getAttribute(long oid, int attr, Value value)
          Gets the Value for the given attribute and OID.
 long getAttributeIntervalCount(int attr, Value lower, boolean includeLower, Value higher, boolean includeHigher)
          Gets how many objects have a value into the given range for the given attribute.
 AttributeList getAttributes(long oid)
          Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.
 AttributeStatistics getAttributeStatistics(int attr, boolean basic)
          Gets statistics from the given attribute.
 TextStream getAttributeText(long oid, int attr)
          Gets the read-only TextStream for the given text attribute and OID.
 EdgeData getEdgeData(long edge)
          Gets information about an edge.
 long getEdgePeer(long edge, long node)
          Gets the other end for the given edge.
 int getObjectType(long oid)
          Gets the Sparksee node or edge type identifier for the given OID.
 Type getType(int type)
          Gets information about the given type.
 Values getValues(int attr)
          Gets the Value collection for the given attribute.
 Objects heads(Objects edges)
          Gets all the heads from the given edges collection.
 void indexAttribute(int attr, AttributeKind kind)
          Updates the index of the given attribute.
 Objects neighbors(long oid, int etype, EdgesDirection dir)
          Selects all neighbor nodes from or to the given node OID and for the given edge type.
 Objects neighbors(Objects objs, int etype, EdgesDirection dir)
          Selects all neighbor nodes from or to each of the node OID in the given collection and for the given edge type.
 int newAttribute(int type, java.lang.String name, DataType dt, AttributeKind kind)
          Creates a new attribute.
 int newAttribute(int type, java.lang.String name, DataType dt, AttributeKind kind, Value defaultValue)
          Creates a new attribute with a default value.
 long newEdge(int type, int tailAttr, Value tailV, int headAttr, Value headV)
          Creates a new edge instance.
 long newEdge(int type, long tail, long head)
          Creates a new edge instance.
 int newEdgeType(java.lang.String name, boolean directed, boolean neighbors)
          Creates a new edge type.
 long newNode(int type)
          Creates a new node instance.
 int newNodeType(java.lang.String name)
          Creates a new node type.
 int newRestrictedEdgeType(java.lang.String name, int tail, int head, boolean neighbors)
          Creates a new restricted edge type.
 int newSessionAttribute(int type, DataType dt, AttributeKind kind)
          Creates a new Session attribute.
 int newSessionAttribute(int type, DataType dt, AttributeKind kind, Value defaultValue)
          Creates a new Session attribute with a default value.
 void removeAttribute(int attr)
          Removes the given attribute.
 void removeType(int type)
          Removes the given type.
 void renameAttribute(int attr, java.lang.String newName)
          Renames an attribute.
 void renameType(int type, java.lang.String newName)
          Renames a type.
 void renameType(java.lang.String oldName, java.lang.String newName)
          Renames a type.
 Objects select(int type)
          Selects all OIDs belonging to the given type.
 Objects select(int attr, Condition cond, Value value)
          Selects all OIDs satisfying the given condition for the given attribute.
 Objects select(int attr, Condition cond, Value value, Objects restriction)
          Selects all OIDs satisfying the given condition for the given attribute.
 Objects select(int attr, Condition cond, Value lower, Value higher)
          Selects all OIDs satisfying the given condition for the given attribute.
 Objects select(int attr, Condition cond, Value lower, Value higher, Objects restriction)
          Selects all OIDs satisfying the given condition for the given attribute.
 void setAttribute(long oid, int attr, Value value)
          Sets the Value for the given attribute and OID.
 void setAttributeDefaultValue(int attr, Value value)
          Sets a default value for an attribute.
 void setAttributeText(long oid, int attr, TextStream tstream)
          Sets the writable TextStream for the given text attribute and OID.
 Objects tails(Objects edges)
          Gets all the tails from the given edges collection.
 void tailsAndHeads(Objects edges, Objects tails, Objects heads)
          Gets all the tails and heads from the given edges collection.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

setAttributeText

public void setAttributeText(long oid,
                             int attr,
                             TextStream tstream)
Sets the writable TextStream for the given text attribute and OID.

Parameters:
oid - [in] Sparksee OID.
attr - [in] Sparksee attribute identifier.
tstream - [in] New Text value. This corresponds to a TextStream to write.

dumpData

public void dumpData(java.lang.String file)
              throws java.io.FileNotFoundException,
                     java.lang.RuntimeException
Dumps logical data to a file.

Parameters:
file - [in] Output file path.
Throws:
java.io.FileNotFoundException - If the given file cannot be created.
java.lang.RuntimeException - null

findTypes

public TypeList findTypes()
Gets all existing Sparksee node and edge type identifiers.

Returns:
Sparksee node and edge type identifier list.

renameAttribute

public void renameAttribute(int attr,
                            java.lang.String newName)
Renames an attribute.

The new name must be available.

Parameters:
attr - [in] Sparksee attribute identifier.
newName - [in] The new name for the attribute.

select

public Objects select(int attr,
                      Condition cond,
                      Value value,
                      Objects restriction)
Selects all OIDs satisfying the given condition for the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
cond - [in] Condition to be satisfied.
value - [in] Value to be satisfied.
restriction - [in] Objects to limit the select in this set of objects.
Returns:
Objects instance.

getAttributeIntervalCount

public long getAttributeIntervalCount(int attr,
                                      Value lower,
                                      boolean includeLower,
                                      Value higher,
                                      boolean includeHigher)
Gets how many objects have a value into the given range for the given attribute.

This only works for the attributes with the AttributeKind Indexed or Unique.

Given values must belong to the same DataType than the attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
lower - [in] Lower bound Value of the range.
includeLower - [in] If TRUE, include lower bound Value of the range.
higher - [in] Higher bound Value of the range.
includeHigher - [in] If TRUE, include higher bound Value of the range.
Returns:
Number of objects having a value into the given range.

tailsAndHeads

public void tailsAndHeads(Objects edges,
                          Objects tails,
                          Objects heads)
Gets all the tails and heads from the given edges collection.

Parameters:
edges - [in] Sparksee edge identifier collection.
tails - [in|out] If not NULL, all the tails will be stored here.
heads - [in|out] If not NULL, all the heads will be stored here.

degree

public long degree(long oid,
                   int etype,
                   EdgesDirection dir)
Gets the number of edges from or to the given node OID and for the given edge type.

Parameters:
oid - [in] Sparksee node OID.
etype - [in] Sparksee edge type identifier.
dir - [in] Direction.
Returns:
The number of edges.

renameType

public void renameType(java.lang.String oldName,
                       java.lang.String newName)
Renames a type.

The new name must be available.

Parameters:
oldName - [in] The current name of the type to be renamed.
newName - [in] The new name for the type.

dumpStorage

public void dumpStorage(java.lang.String file)
                 throws java.io.FileNotFoundException,
                        java.lang.RuntimeException
Dumps internal storage data to a file.

Parameters:
file - [in] Output file path.
Throws:
java.io.FileNotFoundException - If the given file cannot be created.
java.lang.RuntimeException - null

neighbors

public Objects neighbors(Objects objs,
                         int etype,
                         EdgesDirection dir)
Selects all neighbor nodes from or to each of the node OID in the given collection and for the given edge type.

Parameters:
objs - [in] Sparksee node OID collection.
etype - [in] Sparksee edge type identifier.
dir - [in] Direction.
Returns:
Objects instance.

getAttributes

public AttributeList getAttributes(long oid)
Gets all Sparksee attribute identifiers with a non-NULL value for the given Sparksee OID.

Parameters:
oid - [in] Sparksee OID.
Returns:
Sparksee attribute identifier list.

getAttributeStatistics

public AttributeStatistics getAttributeStatistics(int attr,
                                                  boolean basic)
Gets statistics from the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
basic - [in] If FALSE all statistics are computed, if TRUE just those statistics marked as basic will be computed (see description of the AttributeStatistics class). Of course, computing just basic statistics will be faster than computing all of them.
Returns:
An AttributeStatistics instace.

newNode

public long newNode(int type)
Creates a new node instance.

Parameters:
type - [in] Sparksee type identifier.
Returns:
Unique OID of the new node instance.

getAttributeText

public TextStream getAttributeText(long oid,
                                   int attr)
Gets the read-only TextStream for the given text attribute and OID.

Parameters:
oid - [in] Sparksee OID.
attr - [in] Sparksee attribute identifier.
Returns:
A TextStream. This returns a TextStream to read.

countEdges

public long countEdges()
Gets the number of edges.

Returns:
The number of edges.

findEdgeTypes

public TypeList findEdgeTypes()
Gets all existing Sparksee edge type identifiers.

Returns:
Sparksee edge type identifier list.

select

public Objects select(int attr,
                      Condition cond,
                      Value lower,
                      Value higher)
Selects all OIDs satisfying the given condition for the given attribute.

This allows to perform the Between operation, thus it has two Value arguments.

Parameters:
attr - [in] Sparksee attribute identifier.
cond - [in] Condition to be satisfied. It must be the Between Condition.
lower - [in] Lower-bound Value to be satisfied.
higher - [in] Higher-bound Value to be satisfied.
Returns:
Objects instance.

indexAttribute

public void indexAttribute(int attr,
                           AttributeKind kind)
Updates the index of the given attribute.

This just works if the current index of the attribute corresponds to the AttributeKind Basic and the new one is Indexed or Unique.

Parameters:
attr - [in] Sparksee attribute identifier.
kind - [in] Attribute kind.

getType

public Type getType(int type)
Gets information about the given type.

Parameters:
type - [in] Sparksee type identifier.
Returns:
The Type for the given Sparksee type identifier.

findAttribute

public int findAttribute(int type,
                         java.lang.String name)
Gets the Sparksee attribute identifier for the given type identifier and attribute name.

Parameters:
type - [in] Sparksee type identifier.
name - [in] Unique attribute name.
Returns:
The Sparksee attribute identifier for the given type and attribute name or InvalidAttribute if there is no attribute with the given name for the given type.

newAttribute

public int newAttribute(int type,
                        java.lang.String name,
                        DataType dt,
                        AttributeKind kind)
Creates a new attribute.

Parameters:
type - [in] Sparksee node or edge type identifier.
name - [in] Unique name for the new attribute.
dt - [in] Data type for the new attribute.
kind - [in] Attribute kind.
Returns:
Unique Sparksee attribute identifier.

edges

public Objects edges(int etype,
                     long tail,
                     long head)
Gets all the edges of the given type between two given nodes (tail and head).

Parameters:
etype - [in] Sparksee edge type identifier.
tail - [in] Tail node identifier.
head - [in] Head node identifier.
Returns:
Objects instance.

select

public Objects select(int type)
Selects all OIDs belonging to the given type.

Parameters:
type - [in] Sparksee type identifier.
Returns:
Objects instance.

select

public Objects select(int attr,
                      Condition cond,
                      Value value)
Selects all OIDs satisfying the given condition for the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
cond - [in] Condition to be satisfied.
value - [in] Value to be satisfied.
Returns:
Objects instance.

findOrCreateObject

public long findOrCreateObject(int attr,
                               Value value)
Finds one object having the given Value for the attribute or it creates one does not exist any.

If the attribute is a node or edge attribute and at least one node/edge with that value is found, it returns one of them. But if it does not exist, then: If it's a node attribute it will create it and set the attribute. If it's an edge attribute it will return the InvalidOID.

Using this method with a global attribute will return the InvalidOID.

Parameters:
attr - [in] Sparksee attribute identifier.
value - [in] Value.
Returns:
Sparksee OID or the Objects InvalidOID.

findNodeTypes

public TypeList findNodeTypes()
Gets all existing Sparksee node type identifiers.

Returns:
Sparksee node type identifier list.

getAttribute

public Value getAttribute(long oid,
                          int attr)
Gets the Value for the given attribute and OID.

The other version of this call, where the Value is an output parameter instead of the return, is better because it allows the user to reuse an existing Value instance, whereas this call always creates a new Value instance to be returned.

It never returns NULL. Thus, in case the OID has a NULL value for the attribute it returns a NULL Value instance.

Parameters:
oid - [in] Sparksee OID.
attr - [in] Sparksee attribute identifier.
Returns:
A new Value instance having the attribute value for the given OID.

removeAttribute

public void removeAttribute(int attr)
Removes the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.

setAttributeDefaultValue

public void setAttributeDefaultValue(int attr,
                                     Value value)
Sets a default value for an attribute.

The default value will be applied to all the new nodes or edges.

The given value must have the same DataType as the attribute or be a NULL value to remove the current default value.

Parameters:
attr - [in] The attribute.
value - [in] The default value to use for this attribute.

backup

public void backup(java.lang.String file)
            throws java.io.FileNotFoundException,
                   java.lang.RuntimeException
Dumps all the data to a backup file.

See the Sparksee class Restore method.

Parameters:
file - [in] Output backup file path.
Throws:
java.io.FileNotFoundException - If the given file cannot be created.
java.lang.RuntimeException - null

newSessionAttribute

public int newSessionAttribute(int type,
                               DataType dt,
                               AttributeKind kind,
                               Value defaultValue)
Creates a new Session attribute with a default value.

Session attributes are exclusive for the Session (just its Session can use the attribute) and are automatically removed when the Session is closed (thus, attribute data is not persistent into the database).

Since they are not persistent, they cannot be retrieved from the database, so they do not have an identifier name.

Parameters:
type - [in] Sparksee node or edge type identifier.
dt - [in] Data type for the new attribute.
kind - [in] Attribute kind.
defaultValue - [in] The default value to use in each new node/edge.
Returns:
Unique Sparksee attribute identifier.

findAttributes

public AttributeList findAttributes(int type)
Gets all existing Sparksee attribute identifiers for the given type identifier.

Parameters:
type - [in] Sparksee type identifier.
Returns:
Sparksee attribute identifier list.

getAttribute

public void getAttribute(long oid,
                         int attr,
                         Value value)
Gets the Value for the given attribute and OID.

Parameters:
oid - [in] Sparksee OID.
attr - [in] Sparksee attribute identifier.
value - [in|out] Value for the given attribute and for the given OID.

countNodes

public long countNodes()
Gets the number of nodes.

Returns:
The number of nodes.

setAttribute

public void setAttribute(long oid,
                         int attr,
                         Value value)
Sets the Value for the given attribute and OID.

Parameters:
oid - [in] Sparksee OID.
attr - [in] Sparksee attribute identifier.
value - [in] Value for the given attribute and for the given OID.

getEdgeData

public EdgeData getEdgeData(long edge)
Gets information about an edge.

Parameters:
edge - [in] Sparksee edge identifier.
Returns:
An EdgeData instance.

neighbors

public Objects neighbors(long oid,
                         int etype,
                         EdgesDirection dir)
Selects all neighbor nodes from or to the given node OID and for the given edge type.

Parameters:
oid - [in] Sparksee node OID.
etype - [in] Sparksee edge type identifier.
dir - [in] Direction.
Returns:
Objects instance.

renameType

public void renameType(int type,
                       java.lang.String newName)
Renames a type.

The new name must be available.

Parameters:
type - [in] The type to be renamed.
newName - [in] The new name for the type.

explode

public Objects explode(Objects objs,
                       int etype,
                       EdgesDirection dir)
Selects all edges from or to each of the node OID in the given collection and for the given edge type.

Parameters:
objs - [in] Sparksee node OID collection.
etype - [in] Sparksee edge type identifier.
dir - [in] Direction.
Returns:
Objects instance.

newNodeType

public int newNodeType(java.lang.String name)
Creates a new node type.

Parameters:
name - [in] Unique name for the new node type.
Returns:
Unique Sparksee type identifier.

newSessionAttribute

public int newSessionAttribute(int type,
                               DataType dt,
                               AttributeKind kind)
Creates a new Session attribute.

Session attributes are exclusive for the Session (just its Session can use the attribute) and are automatically removed when the Session is closed (thus, attribute data is not persistent into the database).

Since they are not persistent, they cannot be retrieved from the database, so they do not have an identifier name.

Parameters:
type - [in] Sparksee node or edge type identifier.
dt - [in] Data type for the new attribute.
kind - [in] Attribute kind.
Returns:
Unique Sparksee attribute identifier.

tails

public Objects tails(Objects edges)
Gets all the tails from the given edges collection.

Parameters:
edges - [in] Sparksee edge identifier collection.
Returns:
The tails collection.

findOrCreateEdge

public long findOrCreateEdge(int etype,
                             long tail,
                             long head)
Gets any of the edges of the specified type between two given nodes (tail and head).

If it can not find any edge of this type between them it tries to create a new one.

Parameters:
etype - [in] Sparksee edge type identifier.
tail - [in] Tail node identifier.
head - [in] Head node identifier.
Returns:
Any of the edges or the Objects InvalidOID.

drop

public void drop(long oid)
Drops the given OID.

It also removes its egdges as well as its attribute values.

Parameters:
oid - [in] Sparksee OID to be removed.

newEdgeType

public int newEdgeType(java.lang.String name,
                       boolean directed,
                       boolean neighbors)
Creates a new edge type.

Parameters:
name - [in] Unique name for the new edge type.
directed - [in] If TRUE, this creates a directed edge type, otherwise this creates a undirected edge type.
neighbors - [in] If TRUE, this indexes neighbor nodes, otherwise not.
Returns:
Unique Sparksee type identifier.

heads

public Objects heads(Objects edges)
Gets all the heads from the given edges collection.

Parameters:
edges - [in] Sparksee edge identifier collection.
Returns:
The heads collection.

findEdge

public long findEdge(int etype,
                     long tail,
                     long head)
Gets any of the edges of the given type between two given nodes (tail and head).

If there are more than one, then any of them will be returned. And in case there are no edge between the given tail and head, the Objects InvalidOID will be returned.

Parameters:
etype - [in] Sparksee edge type identifier.
tail - [in] Tail node identifier.
head - [in] Head node identifier.
Returns:
Any of the edges or the Objects InvalidOID.

explode

public Objects explode(long oid,
                       int etype,
                       EdgesDirection dir)
Selects all edges from or to the given node OID and for the given edge type.

Parameters:
oid - [in] Sparksee node OID.
etype - [in] Sparksee edge type identifier.
dir - [in] Direction.
Returns:
Objects instance.

findObject

public long findObject(int attr,
                       Value value)
Finds one object having the given Value for the given attribute.

If there are more than one, then any of them will be returned. And in case there are no object having this Value, the Objects InvalidOID will be returned.

Parameters:
attr - [in] Sparksee attribute identifier.
value - [in] Value.
Returns:
Sparksee OID or the Objects InvalidOID.

drop

public void drop(Objects objs)
Drops all the OIDs from the given collection.

See Drop method with the single OID parameter. This performs that call for all the elements into the collection.

Parameters:
objs - [in] Objects collection with the OIDs to be removed.

newAttribute

public int newAttribute(int type,
                        java.lang.String name,
                        DataType dt,
                        AttributeKind kind,
                        Value defaultValue)
Creates a new attribute with a default value.

Parameters:
type - [in] Sparksee node or edge type identifier.
name - [in] Unique name for the new attribute.
dt - [in] Data type for the new attribute.
kind - [in] Attribute kind.
defaultValue - [in] The default value to use in each new node/edge.
Returns:
Unique Sparksee attribute identifier.

getObjectType

public int getObjectType(long oid)
Gets the Sparksee node or edge type identifier for the given OID.

Parameters:
oid - [in] Sparksee OID.
Returns:
Sparksee node or edge type identifier.

getAttribute

public Attribute getAttribute(int attr)
Gets information about the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
Returns:
The Attribute for the given Sparksee attribute identifier.

export

public void export(java.lang.String file,
                   ExportType type,
                   ExportManager em)
            throws java.io.IOException
Exports the Graph.

Parameters:
file - [in] Output file.
type - [in] Export type.
em - [in] Defines how to do the export for each graph object.
Throws:
java.io.IOException - null

newEdge

public long newEdge(int type,
                    int tailAttr,
                    Value tailV,
                    int headAttr,
                    Value headV)
Creates a new edge instance.

The tail of the edge will be any node having the given tailV Value for the given tailAttr attribute identifier, and the head of the edge will be any node having the given headV Value for the given headAttr attribute identifier.

Parameters:
type - [in] Sparksee type identifier.
tailAttr - [in] Sparksee attribute identifier.
tailV - [in] Value.
headAttr - [in] Sparksee attribute identifier.
headV - [in] Value.
Returns:
Unique OID of the new edge instance.

getValues

public Values getValues(int attr)
Gets the Value collection for the given attribute.

Parameters:
attr - [in] Sparksee attribute identifier.
Returns:
Returns a Values object.

getEdgePeer

public long getEdgePeer(long edge,
                        long node)
Gets the other end for the given edge.

Parameters:
edge - [in] Sparksee edge identifier.
node - [in] Sparksee node identifier. It must be one of the ends of the edge.
Returns:
The other end of the edge.

newEdge

public long newEdge(int type,
                    long tail,
                    long head)
Creates a new edge instance.

Parameters:
type - [in] Sparksee type identifier.
tail - [in] Source Sparksee OID.
head - [in] Target Sparksee OID.
Returns:
Unique OID of the new edge instance.

select

public Objects select(int attr,
                      Condition cond,
                      Value lower,
                      Value higher,
                      Objects restriction)
Selects all OIDs satisfying the given condition for the given attribute.

This allows to perform the Between operation, thus it has two Value arguments.

Parameters:
attr - [in] Sparksee attribute identifier.
cond - [in] Condition to be satisfied. It must be the Between Condition.
lower - [in] Lower-bound Value to be satisfied.
higher - [in] Higher-bound Value to be satisfied.
restriction - [in] Objects to limit the select in this set of objects.
Returns:
Objects instance.

findType

public int findType(java.lang.String name)
Gets the Sparksee type identifier for the given type name.

Parameters:
name - [in] Unique type name.
Returns:
The Sparksee type identifier for the given type name or the Type InvalidType if there is no type with the given name.

removeType

public void removeType(int type)
Removes the given type.

This fails if there exist attributes defined for the type or if there exist restricted edges referencing this type.

Parameters:
type - [in] Sparksee type identifier.

newRestrictedEdgeType

public int newRestrictedEdgeType(java.lang.String name,
                                 int tail,
                                 int head,
                                 boolean neighbors)
Creates a new restricted edge type.

Parameters:
name - [in] Unique name for the new edge type.
tail - [in] Tail Sparksee node type identifier.
head - [in] Head Sparksee node type identifier.
neighbors - [in] If TRUE, this indexes neighbor nodes, otherwise not.
Returns:
Unique Sparksee type identifier.