Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

nl.aidministrator.rdf.ral.ordbms
Class SqlNamespaceIterator  view SqlNamespaceIterator download SqlNamespaceIterator.java

java.lang.Object
  extended bynl.aidministrator.rdf.ral.ordbms.SqlNamespaceIterator
All Implemented Interfaces:
nl.aidministrator.rdf.ral.NamespaceIterator

public class SqlNamespaceIterator
extends java.lang.Object
implements nl.aidministrator.rdf.ral.NamespaceIterator

A NamespaceIterator that executes an SQL query. The ResultSet should contain at least two columns. The value of these columns is expected to represent the namespace prefix and the namespace name respectively.


Field Summary
protected  java.sql.Connection _dbConn
          Connection to the database.
protected  boolean _hasNext
          Flag indicating whether there are any more results.
protected  java.lang.String _name
          Namespace name.
protected  java.lang.String _prefix
          Namespace prefix.
protected  java.lang.String _query
          The query to execute.
protected  java.sql.ResultSet _resultSet
          ResultSet for the query.
protected  java.sql.Statement _statement
          SQL statement that was used to generate the ResultSet, but which cannot be closed until all results have been read from the ResultSet.
 
Constructor Summary
SqlNamespaceIterator(java.sql.Connection dbConn, java.lang.String query)
          Calls the supplied query and returns its results one by one.
 
Method Summary
private  void _execQuery()
           
 void close()
          Closes all connections to the repository.
protected  void finalize()
          Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed.
 java.lang.String getName()
          Gets the namespace name.
 java.lang.String getPrefix()
          Gets the namespace prefix.
 boolean hasNext()
          Checks whether there are any more results available.
 void next()
          Gets the next result.
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_resultSet

protected java.sql.ResultSet _resultSet
ResultSet for the query.


_statement

protected java.sql.Statement _statement
SQL statement that was used to generate the ResultSet, but which cannot be closed until all results have been read from the ResultSet.


_dbConn

protected java.sql.Connection _dbConn
Connection to the database.


_query

protected java.lang.String _query
The query to execute.


_hasNext

protected boolean _hasNext
Flag indicating whether there are any more results.


_prefix

protected java.lang.String _prefix
Namespace prefix.


_name

protected java.lang.String _name
Namespace name.

Constructor Detail

SqlNamespaceIterator

public SqlNamespaceIterator(java.sql.Connection dbConn,
                            java.lang.String query)
Calls the supplied query and returns its results one by one. The query result should contain (at least) three columns. The first is expected to be the subject, the second the predicate, * and the third the object.

Method Detail

_execQuery

private void _execQuery()

hasNext

public boolean hasNext()
Checks whether there are any more results available.

Specified by:
hasNext in interface nl.aidministrator.rdf.ral.NamespaceIterator

next

public void next()
Gets the next result.

Specified by:
next in interface nl.aidministrator.rdf.ral.NamespaceIterator

getPrefix

public java.lang.String getPrefix()
Gets the namespace prefix.

Specified by:
getPrefix in interface nl.aidministrator.rdf.ral.NamespaceIterator

getName

public java.lang.String getName()
Gets the namespace name.

Specified by:
getName in interface nl.aidministrator.rdf.ral.NamespaceIterator

close

public void close()
Description copied from interface: nl.aidministrator.rdf.ral.NamespaceIterator
Closes all connections to the repository.

Specified by:
close in interface nl.aidministrator.rdf.ral.NamespaceIterator

finalize

protected void finalize()
Description copied from class: java.lang.Object
Called on an object by the Virtual Machine at most once, at some point after the Object is determined unreachable but before it is destroyed. You would think that this means it eventually is called on every Object, but this is not necessarily the case. If execution terminates abnormally, garbage collection does not always happen. Thus you cannot rely on this method to always work. For finer control over garbage collection, use references from the java.lang.ref package.

Virtual Machines are free to not call this method if they can determine that it does nothing important; for example, if your class extends Object and overrides finalize to do simply super.finalize().

finalize() will be called by a java.lang.Thread that has no locks on any Objects, and may be called concurrently. There are no guarantees on the order in which multiple objects are finalized. This means that finalize() is usually unsuited for performing actions that must be thread-safe, and that your implementation must be use defensive programming if it is to always work.

If an Exception is thrown from finalize() during garbage collection, it will be patently ignored and the Object will still be destroyed.

It is allowed, although not typical, for user code to call finalize() directly. User invocation does not affect whether automatic invocation will occur. It is also permitted, although not recommended, for a finalize() method to "revive" an object by making it reachable from normal code again.

Unlike constructors, finalize() does not get called for an object's superclass unless the implementation specifically calls super.finalize().

The default implementation does nothing.