|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectcom.hp.hpl.jena.db.DBConnection
public class DBConnection
Encapsulate the specification of a jdbc connection. This is mostly used to simplify the calling pattern for ModelRDB factory methods.
| Constructor Summary | |
|---|---|
DBConnection(Connection connection,
String databaseType)
Create a connection specification that just wraps up an existing database connection. |
|
DBConnection(String url,
String user,
String password,
String databaseType)
Create a connection specification based on jdbc address and appropriate authentication information. |
|
| Method Summary | |
|---|---|
void |
cleanDB()
Clear all RDF information from the database. |
void |
close()
Close the jdbc connection |
boolean |
containsDefaultModel()
Test if a default model is contained in the database. |
boolean |
containsModel(String name)
Test if a given model is contained in the database. |
com.hp.hpl.jena.util.iterator.ExtendedIterator<String> |
getAllModelNames()
Retrieve a list of all models in the database |
Connection |
getConnection()
Return the jdbc connection or null if we no longer have access to a connection. |
Model |
getDatabaseProperties()
Returns a Jena Model containing database properties. |
String |
getDatabaseType()
Get the database type. |
Model |
getDefaultModelProperties()
Retrieve a default set of model customization properties. |
com.hp.hpl.jena.db.impl.IRDBDriver |
getDriver()
Get the database-specific driver For this to work, it needs to know the type of database being used. |
boolean |
isFormatOK()
Return true if the database seems to be formated for RDF storage. |
void |
setDatabaseProperties(Model dbProperties)
Sets database-specific properties. |
void |
setDatabaseType(String databaseType)
Set the database type manually. |
void |
setDriver(com.hp.hpl.jena.db.impl.IRDBDriver driver)
Set the IRDBDriver to use for this connection. |
| Methods inherited from class java.lang.Object |
|---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public DBConnection(String url,
String user,
String password,
String databaseType)
url - the jdbc url for the database, note that the format of this
is database dependent and that the appropriate jdbc driver will need to
be specified via the standard pattern
Class.forName("my.sql.driver");
user - the user name to log on withpassword - the password corresponding to this userdatabaseType - the type of database to which we are connecting.
public DBConnection(Connection connection,
String databaseType)
connection - the open jdbc connection to usedatabaseType - the type of database to which we are connecting.| Method Detail |
|---|
public Connection getConnection()
throws SQLException
IDBConnection
getConnection in interface IDBConnectionSQLException
public void close()
throws SQLException
IDBConnection
close in interface IDBConnectionSQLException
public void cleanDB()
throws SQLException
IDBConnection
cleanDB in interface IDBConnectionSQLExceptionpublic boolean isFormatOK()
IDBConnection
isFormatOK in interface IDBConnection
public void setDatabaseProperties(Model dbProperties)
throws RDFRDBException
IDBConnectionThese properties may only be set before the first Model has been stored in the database. After that point, the database structure is frozen.
Use these properties to optionally customize the database - this won't change the results you see when using the graph interface, but it may alter the speed with which you get them or the space required by the database.
The properties must form a complete and consistent set. The easist way to get a complete and consistent set is to call getDatabaseProperties, modify the returned model, and then use that as an argument in the call to setDatabaseProperties.
Note that some implementations may choose to delay actually peforming the formatting operation until at least one Graph is constructed in the database. Consequently, a successful return from this call does not necessarily guarantee that the database properties were set correctly.
setDatabaseProperties in interface IDBConnectiondbProperties - is a Model describing the database parameters
RDFRDBException
public Model getDatabaseProperties()
throws RDFRDBException
IDBConnectionThese describe the optimization/layout for the database.
If the database has not been formatted, then a default set of properties is returned. Otherwise the actual properties are returned.
The returned Model is a copy, modifying it will have no effect on the database. (Use setDatabaseProperties to make changes).
getDatabaseProperties in interface IDBConnectionRDFRDBException
public Model getDefaultModelProperties()
throws RDFRDBException
IDBConnection
getDefaultModelProperties in interface IDBConnectionRDFRDBException
public com.hp.hpl.jena.util.iterator.ExtendedIterator<String> getAllModelNames()
throws RDFRDBException
IDBConnection
getAllModelNames in interface IDBConnectionRDFRDBException
public boolean containsModel(String name)
throws RDFRDBException
IDBConnection
containsModel in interface IDBConnectionname - the name of a model which may be in the database
RDFRDBException
public boolean containsDefaultModel()
throws RDFRDBException
IDBConnection
containsDefaultModel in interface IDBConnectionRDFRDBExceptionpublic void setDatabaseType(String databaseType)
IDBConnectionThis is not for public use (it is preferable to specify it in the constructor) - included here to handle older code, which didn't use the new constructor.
setDatabaseType in interface IDBConnectionpublic String getDatabaseType()
IDBConnection
getDatabaseType in interface IDBConnection
public com.hp.hpl.jena.db.impl.IRDBDriver getDriver()
throws RDFRDBException
IDBConnection
getDriver in interface IDBConnectionRDFRDBExceptionpublic void setDriver(com.hp.hpl.jena.db.impl.IRDBDriver driver)
IDBConnection
setDriver in interface IDBConnection
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||