|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object nz.ac.waikato.mcennis.rat.graph.model.ModelShell nz.ac.waikato.mcennis.rat.graph.DerbyGraph
public class DerbyGraph
Class that implements all the JDBC code for a Derby backed graph model. This
model differs from persistance in that all loading of actors, links, and properties
is done using lazy techniques (they are not createde until requested). Provided
that the appropriate actor class (DBActor by default) is used, persistance is
maintained with generated references in a manner similar to hibernate.
The first time this system is utilized, it requires initialization to create
the appropriate tables in the database. This database must be the same for the
corresponding actor class, but is handled by default (unless the class is changed
between startup and actor request.)
The system requires two paramters - the directory of the database and the database
name. All JDBC calls are compiled and have auto-commit disabled. Periodic calls
to commit() are required to maintain consistancy between the database and
memory-resident components.
Nested Class Summary | |
---|---|
class |
DerbyGraph.ActorIterator
|
Field Summary | |
---|---|
static long |
serialVersionUID
|
Fields inherited from class nz.ac.waikato.mcennis.rat.graph.model.ModelShell |
---|
listener |
Constructor Summary | |
---|---|
DerbyGraph()
Creates a new instance of DerbyGraph |
Method Summary | |
---|---|
void |
add(Actor u)
Add a user to the graph. |
void |
add(Graph g)
Add a graph (g) to the graph. |
void |
add(Link link)
Adds a userlink to the graph. |
void |
add(PathSet pathSet)
Add a PathSet to this graph. |
void |
add(Property prop)
Add a property to this graph. |
void |
addChild(Graph g)
FIXME: Does not save to database |
void |
anonymize()
Replaces all actor IDs with an anonymous numeric ID. |
void |
clear()
Removes all data from the database. |
void |
close()
Attempts to release all resources created by the startup method |
void |
commit()
Commit the contents to database or storage. |
void |
deleteDatabase()
Attempts to remove the database tables so that initializeDatabase will be needed to utilize the graph again. |
protected void |
finalize()
|
Actor[] |
getActor()
Retrieve an array of all actors of all types. |
Actor[] |
getActor(java.lang.String type)
Retrieve an array of all actors of a given type. |
Actor |
getActor(java.lang.String type,
java.lang.String ID)
Retrieve the users that has the given ID. |
protected java.lang.String |
getActorClass()
Determine what class will be used for the creation of actor objects. |
int |
getActorCount(java.lang.String mode)
Returns the number of actors of the given type |
java.util.Iterator<Actor> |
getActorIterator(java.lang.String type)
Create a read only iterator over all actors. |
java.lang.String[] |
getActorTypes()
List all types - returns null if no actors exist. |
Graph[] |
getChildren()
FIXME: Does not properly access database |
Graph |
getChildren(java.lang.String id)
FIXME: Does not properly access database |
java.io.File |
getDirectory()
Return the directory that this object will or is using. |
Graph[] |
getGraphs(java.util.regex.Pattern pattern)
FIXME: does not return graphs properly |
java.lang.String |
getID()
Return the ID associated with this Graph |
Link[] |
getLink()
Return all user to user links in this graph in an array. |
Link[] |
getLink(java.lang.String type)
Retrieve an array of all userlinks of the given type from this graph or null if no such links are in this graph. |
Link[] |
getLink(java.lang.String type,
Actor sourceActor,
Actor destActor)
Returns all links of the given type (relation) type going from actor sourceActor to actor destActor or null. |
Link[] |
getLinkByDestination(java.lang.String type,
Actor destActor)
Returns all links (edges, arcs) of type (relation) type that point to the given actor. |
Link[] |
getLinkBySource(java.lang.String type,
Actor sourceActor)
Returns all links (edges, arcs) of type (relation) type that go from the given actor to any destination. |
java.lang.String[] |
getLinkTypes()
Returns all link types currently in this graph or null if no links are present. |
Parameter[] |
getParameters()
Obtain a computer-readable description of the parameters and options this graph supports |
Graph |
getParent()
FIXME: Does not properly access database |
PathSet[] |
getPathSet()
Return all PathSets associated with this graph. |
PathSet |
getPathSet(java.lang.String id)
Return the named PathSet. |
Property[] |
getProperty()
Returns an array of all properties associated with this object or null if none exist |
Property |
getProperty(java.lang.String type)
Return a property named by the given string or null if no property by this name exists |
Graph |
getSubGraph(java.util.Properties props,
java.util.Set<Actor> actor)
FIXME: write subgraph code for Derby Graph |
Graph[] |
getSubGraph(Query q)
Return newly created subgraphs that matches the given query FIXME: Currently not implemented in any graph. |
void |
init(java.util.Properties map)
Set the parameters of this graph from the following property object. |
protected void |
initActor()
Performs initialization of the DBActor class - a static call that prepares all subsequent calls for actor creation. |
void |
initializeDatabase()
The first call to be made if the database has never been used before. |
boolean |
isInitialized()
Determine if 'startup' has been called for this graph. |
protected void |
prepareStatement()
Prepares all statements utilized by DerbyGraph. |
void |
publishChange(Model m,
int type,
int argument)
Records changes in properties of this graph, updating the database as needed. |
void |
remove(Actor u)
Identifies the given user and removes it and all links involving it from the graph. |
void |
remove(Link ul)
remove all user links with the same type, user ID, and artist ID from the graph |
protected Actor |
retrieveActor(int id)
Retrieve an actor object from the database with its database's numeric id. |
protected void |
setActorClass(java.lang.String actorClass)
Determine what class will be used for the creation of actor objects. |
protected Property[] |
setActorProperties(int a)
Aquire a set of properties from the database attached to a given actor. |
void |
setDirectory(java.io.File f)
Set the directory that DerbyGraph will look for its database |
void |
setID(java.lang.String id)
Set this graph's ID to this value. |
void |
setSubGraph(Query q)
Same as getSubGraph but the resulting graphs are stored internally NOTE: this interface may be removed. |
void |
startup()
Starts the database Creates a database connection at the directory 'directory' with database name 'database' aquires the graph id of the root graph compiles all the prepared statements used in the class |
Methods inherited from class nz.ac.waikato.mcennis.rat.graph.model.ModelShell |
---|
addListener, fireChange |
Methods inherited from class java.lang.Object |
---|
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface nz.ac.waikato.mcennis.rat.graph.model.Model |
---|
addListener |
Field Detail |
---|
public static final long serialVersionUID
Constructor Detail |
---|
public DerbyGraph()
Method Detail |
---|
public void startup() throws java.sql.SQLException
java.sql.SQLException
protected void initActor()
DBActor
protected void prepareStatement() throws java.sql.SQLException
java.sql.SQLException
public void initializeDatabase() throws java.sql.SQLException
java.sql.SQLException
protected void finalize() throws java.lang.Throwable
finalize
in class java.lang.Object
java.lang.Throwable
public void close()
close
in interface Graph
public boolean isInitialized()
public void clear()
public void deleteDatabase()
public void add(Actor u)
Graph
add
in interface Graph
u
- user to be included in the graph.public void add(Link link)
Graph
add
in interface Graph
link
- description of a named link between two userspublic void remove(Actor u)
Graph
remove
in interface Graph
u
- user to be removed from the graph.public void remove(Link ul)
Graph
remove
in interface Graph
ul
- link to be removed from the graph.public Actor getActor(java.lang.String type, java.lang.String ID)
Graph
getActor
in interface Graph
ID
- ID string identifying an user
public Actor[] getActor()
Graph
getActor
in interface Graph
public Actor[] getActor(java.lang.String type)
Graph
getActor
in interface Graph
type
- class of actor to return
public java.util.Iterator<Actor> getActorIterator(java.lang.String type)
Graph
getActorIterator
in interface Graph
type
- type (mode) of actor to return
public java.lang.String[] getActorTypes()
Graph
getActorTypes
in interface Graph
public Link[] getLink()
Graph
getLink
in interface Graph
protected Actor retrieveActor(int id)
id
- numeric id of this object
public Link[] getLink(java.lang.String type)
Graph
getLink
in interface Graph
public Link[] getLinkBySource(java.lang.String type, Actor sourceActor)
Graph
getLinkBySource
in interface Graph
type
- type (relation) of link to returnsourceActor
- starting point of the link
public Link[] getLinkByDestination(java.lang.String type, Actor destActor)
Graph
getLinkByDestination
in interface Graph
type
- type (relation) of link to returndestActor
- actor pointed to by links
public Link[] getLink(java.lang.String type, Actor sourceActor, Actor destActor)
Graph
getLink
in interface Graph
type
- type (relation) of the link to returnsourceActor
- starting point of the linkdestActor
- actor pointed to by links
public java.lang.String[] getLinkTypes()
Graph
getLinkTypes
in interface Graph
public Graph[] getSubGraph(Query q)
Graph
getSubGraph
in interface Graph
q
- query object to be executed.
public void setSubGraph(Query q)
Graph
setSubGraph
in interface Graph
q
- Query to be executedpublic Property[] getProperty()
Graph
getProperty
in interface Graph
public Property getProperty(java.lang.String type)
Graph
getProperty
in interface Graph
type
- property's name
public void add(Property prop) throws java.lang.NullPointerException
Graph
add
in interface Graph
prop
- property to be added.
java.lang.NullPointerException
public PathSet[] getPathSet()
Graph
getPathSet
in interface Graph
public PathSet getPathSet(java.lang.String id)
Graph
getPathSet
in interface Graph
id
- ID of the PathSet to return
public void add(PathSet pathSet)
Graph
add
in interface Graph
pathSet
- PathSet to be added to this graphpublic void setID(java.lang.String id)
Graph
setID
in interface Graph
id
- graph IDpublic java.lang.String getID()
Graph
getID
in interface Graph
public void setDirectory(java.io.File f)
f
- file representing the target directory.public java.io.File getDirectory()
protected Property[] setActorProperties(int a) throws java.sql.SQLException
a
- unique id of the actor whose properties are to be retrieved
java.sql.SQLException
public void commit()
Graph
commit
in interface Graph
public void add(Graph g)
Graph
add
in interface Graph
g
- graph to be addedpublic void anonymize()
Graph
anonymize
in interface Graph
public void publishChange(Model m, int type, int argument)
publishChange
in interface Listener
m
- property that is modifiedtype
- currently only records adding a propertypublic Graph getParent()
getParent
in interface Graph
public Graph[] getChildren()
getChildren
in interface Graph
public Graph getChildren(java.lang.String id)
getChildren
in interface Graph
id
- ID of the graph to return
public void addChild(Graph g)
addChild
in interface Graph
g
- Child Graphpublic Graph[] getGraphs(java.util.regex.Pattern pattern)
getGraphs
in interface Graph
pattern
-
protected void setActorClass(java.lang.String actorClass)
actorClass
- name of class of actorActorFactory
protected java.lang.String getActorClass()
ActorFactory
public Graph getSubGraph(java.util.Properties props, java.util.Set<Actor> actor) throws java.lang.Exception
getSubGraph
in interface Graph
props
- Properties for creating a new Graphactor
- subset of graph's actors to make the subgraph from
java.lang.Exception
- if actor is null or properties is nullpublic Parameter[] getParameters()
Graph
getParameters
in interface Graph
public void init(java.util.Properties map)
Graph
init
in interface Graph
map
- properties to be setpublic int getActorCount(java.lang.String mode)
Graph
getActorCount
in interface Graph
mode
- type of actor to query
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |