ISSearch
Class ISDB

java.lang.Object
  ISSearch.ISDB

All Implemented Interfaces:

ISDBinterface

public class ISDB
extends java.lang.Object
implements ISDBinterface

This class is used to open and close the database connection, to prepare the DB schema (tables and indexes) for storage, and to store crawled data into this schema.

See Also:

Connection, ResultSet, Statement, PreparedStatement, OracleConnection, DriverManager

Constructor Summary

ISDB()

Method Summary

void	closeConnection() Closes the open database connection.
boolean	createFeatures() This method creates document features from previously stored word stems and stores them (as well as associated feature weights) into additional schema tables.
boolean	createSchema() This method creates the database infrastructure that is required for storage of crawled information: relations (tables), index structures, and integrity constraints.
void	dropSchema() This method drops all previously created schema elements (tables, associated indexes, and integrity contraints) to fully cleanup the database account for next experiment.
java.sql.Connection	getConnection() Returns the internal database connection of the database interface (only when it is open and valid).
boolean	isOpen() Returns the current state of the database connection
boolean	openConnection(java.lang.String user, java.lang.String password, java.lang.String hostname, int port, java.lang.String service_name) Opens the Database connection to the Oracle instance specified by input parameters.
void	setConnection(java.sql.Connection con)
boolean	store(java.net.URL url, ISDocumentInterface doc) Stores the content of an ISDocument and its URL into the database.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ISDB

public ISDB()

Method Detail

openConnection

public boolean openConnection(java.lang.String user,
                              java.lang.String password,
                              java.lang.String hostname,
                              int port,
                              java.lang.String service_name)

Opens the Database connection to the Oracle instance specified by input parameters.

Specified by:

openConnection in interface ISDBinterface

Parameters:

user - the Oracle user name

password - the database password

hostname - the hostname (or IP address) of the Oracle server

port - the port of the Oracle listener for connections over a TCP/IP network (standard is 1521)

service_name - the name of the requested Oracle service

Returns:

true, if the connect was succesful; false otherwise.

closeConnection

public void closeConnection()

Closes the open database connection.

Specified by:

closeConnection in interface ISDBinterface

isOpen

public boolean isOpen()

Returns the current state of the database connection

Specified by:

isOpen in interface ISDBinterface

Returns:

true, if the database was successfully opened and is currently not yet closed.

getConnection

public java.sql.Connection getConnection()

Returns the internal database connection of the database interface (only when it is open and valid). This method must return the current internal database connection (when available), it should NOT open any additional connections.

Specified by:

getConnection in interface ISDBinterface

Returns:

the database connection (when open and valid); null otherwise.

setConnection

public void setConnection(java.sql.Connection con)

store

public boolean store(java.net.URL url,
                     ISDocumentInterface doc)

Stores the content of an ISDocument and its URL into the database. At least stems of all words from the ISDocument and the absolute URL of the source Web document are required for the search engine; the storage of other available informations (original words and positions, links) is optional.

Specified by:

store in interface ISDBinterface

Returns:

true, if the storage attempt was successful; false otherwise.

createSchema

public boolean createSchema()

This method creates the database infrastructure that is required for storage of crawled information: relations (tables), index structures, and integrity constraints. At least stems of all words from the ISDocument and the absolute URL of the source Web document are required for the search engine. Additionally, you should provide data structures for document features (stem, RTF weight, TF*IDF weight) that will be computed from stored word stems after the crawl. Of course, the schema must also contain information about associations between features, terms, and URLs (e.g. using unique Doc-IDs) to allow the keyword-based search on stored data.

Specified by:

createSchema in interface ISDBinterface

Returns:

true, if the schema was created successfully; false otherwise.

dropSchema

public void dropSchema()

This method drops all previously created schema elements (tables, associated indexes, and integrity contraints) to fully cleanup the database account for next experiment.

Specified by:

dropSchema in interface ISDBinterface

createFeatures

public boolean createFeatures()

This method creates document features from previously stored word stems and stores them (as well as associated feature weights) into additional schema tables. At least, the string of the word stem, the RTF weight, and the TF*IDF weight must be stored for each feature and document. Of course, the schema must also contain information about associations between features, terms, and URLs (e.g. using unique Doc-IDs) to allow keyword-based search on stored data.

Specified by:

createFeatures in interface ISDBinterface