|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.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(java.sql.Connection connection,
java.lang.String databaseType)
Create a connection specification that just wraps up an existing database connection. |
|
DBConnection(java.lang.String url,
java.lang.String user,
java.lang.String password,
java.lang.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(java.lang.String name)
Test if a given model is contained in the database. |
com.hp.hpl.jena.util.iterator.ExtendedIterator<java.lang.String> |
getAllModelNames()
Retrieve a list of all models in the database |
java.sql.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. |
java.lang.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(java.lang.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(java.lang.String url, java.lang.String user, java.lang.String password, java.lang.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(java.sql.Connection connection, java.lang.String databaseType)
connection
- the open jdbc connection to usedatabaseType
- the type of database to which we are connecting.Method Detail |
---|
public java.sql.Connection getConnection() throws java.sql.SQLException
IDBConnection
getConnection
in interface IDBConnection
java.sql.SQLException
public void close() throws java.sql.SQLException
IDBConnection
close
in interface IDBConnection
java.sql.SQLException
public void cleanDB() throws java.sql.SQLException
IDBConnection
cleanDB
in interface IDBConnection
java.sql.SQLException
public boolean isFormatOK()
IDBConnection
isFormatOK
in interface IDBConnection
public void setDatabaseProperties(Model dbProperties) throws RDFRDBException
IDBConnection
These 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 IDBConnection
dbProperties
- is a Model describing the database parameters
RDFRDBException
public Model getDatabaseProperties() throws RDFRDBException
IDBConnection
These 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 IDBConnection
RDFRDBException
public Model getDefaultModelProperties() throws RDFRDBException
IDBConnection
getDefaultModelProperties
in interface IDBConnection
RDFRDBException
public com.hp.hpl.jena.util.iterator.ExtendedIterator<java.lang.String> getAllModelNames() throws RDFRDBException
IDBConnection
getAllModelNames
in interface IDBConnection
RDFRDBException
public boolean containsModel(java.lang.String name) throws RDFRDBException
IDBConnection
containsModel
in interface IDBConnection
name
- the name of a model which may be in the database
RDFRDBException
public boolean containsDefaultModel() throws RDFRDBException
IDBConnection
containsDefaultModel
in interface IDBConnection
RDFRDBException
public void setDatabaseType(java.lang.String databaseType)
IDBConnection
This 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 IDBConnection
public java.lang.String getDatabaseType()
IDBConnection
getDatabaseType
in interface IDBConnection
public com.hp.hpl.jena.db.impl.IRDBDriver getDriver() throws RDFRDBException
IDBConnection
getDriver
in interface IDBConnection
RDFRDBException
public 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 |