gnu.beanfactory.jdbc
Class Query

java.lang.Object
  |
  +--gnu.beanfactory.jdbc.Query
Direct Known Subclasses:
CachedQuery

public abstract class Query
extends java.lang.Object

Abstract class for defining SQL queries. Caching hooks exist for subclasses to implement. Important properties are:
propertyNamedescriptionrequired?
connectionPoolURL reference to a ConnectionPooltrue
dataBeanClassFully qualified class name of the data beantrue
sqlselect SQL statementtrue
propertyMapProperties cotaining columnName to propertyName mappingsfalse

Version:
$Id: Query.java,v 1.15 2001/10/01 03:07:17 rschoening Exp $
Author:
Rob Schoening

Inner Class Summary
 class Query.CacheKey
           
 
Constructor Summary
Query()
           
 
Method Summary
protected abstract  void cacheResults(Query.CacheKey key, java.lang.Object[] val)
           
 java.lang.String columnToPropertyName(java.lang.String n)
           
 java.lang.Object[] doSelect(Query.CacheKey key)
           
protected abstract  void flushCache()
           
protected abstract  void flushCache(Query.CacheKey key)
           
 ConnectionPool getConnectionPool()
           
 java.lang.String getDataBeanClass()
           
 java.util.Properties getPropertyMap()
           
protected abstract  java.lang.Object[] getResultsFromCache(Query.CacheKey key)
           
 java.lang.String getSql()
           
 java.lang.Object newRowBean()
           
 java.lang.Object[] select()
           
 java.lang.Object[] select(java.lang.Object arg1)
           
 java.lang.Object[] select(java.lang.Object[] args)
           
 java.lang.Object selectFirst()
           
 java.lang.Object selectFirst(java.lang.Object arg)
           
 java.lang.Object selectFirst(java.lang.Object[] args)
           
 java.lang.Object selectFirstUncached()
           
 java.lang.Object selectFirstUncached(java.lang.Object arg)
           
 java.lang.Object selectFirstUncached(java.lang.Object[] args)
           
 java.lang.Object[] selectUncached()
           
 java.lang.Object[] selectUncached(java.lang.Object arg)
           
 java.lang.Object[] selectUncached(java.lang.Object[] args)
           
 void setConnectionPool(ConnectionPool cp)
           
 void setDataBeanClass(java.lang.String s)
           
 void setPropertyMap(java.util.Properties p)
           
 void setSql(java.lang.String s)
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Query

public Query()
Method Detail

getPropertyMap

public java.util.Properties getPropertyMap()

setPropertyMap

public void setPropertyMap(java.util.Properties p)

getSql

public java.lang.String getSql()

setSql

public void setSql(java.lang.String s)

getConnectionPool

public ConnectionPool getConnectionPool()

setConnectionPool

public void setConnectionPool(ConnectionPool cp)

cacheResults

protected abstract void cacheResults(Query.CacheKey key,
                                     java.lang.Object[] val)

getResultsFromCache

protected abstract java.lang.Object[] getResultsFromCache(Query.CacheKey key)

flushCache

protected abstract void flushCache()

flushCache

protected abstract void flushCache(Query.CacheKey key)

select

public final java.lang.Object[] select()
                                throws java.sql.SQLException

select

public final java.lang.Object[] select(java.lang.Object arg1)
                                throws java.sql.SQLException

select

public final java.lang.Object[] select(java.lang.Object[] args)
                                throws java.sql.SQLException

selectUncached

public final java.lang.Object[] selectUncached()
                                        throws java.sql.SQLException

selectUncached

public final java.lang.Object[] selectUncached(java.lang.Object arg)
                                        throws java.sql.SQLException

selectUncached

public final java.lang.Object[] selectUncached(java.lang.Object[] args)
                                        throws java.sql.SQLException

selectFirst

public final java.lang.Object selectFirst()
                                   throws java.sql.SQLException

selectFirst

public final java.lang.Object selectFirst(java.lang.Object arg)
                                   throws java.sql.SQLException

selectFirst

public final java.lang.Object selectFirst(java.lang.Object[] args)
                                   throws java.sql.SQLException

selectFirstUncached

public final java.lang.Object selectFirstUncached()
                                           throws java.sql.SQLException

selectFirstUncached

public final java.lang.Object selectFirstUncached(java.lang.Object arg)
                                           throws java.sql.SQLException

selectFirstUncached

public final java.lang.Object selectFirstUncached(java.lang.Object[] args)
                                           throws java.sql.SQLException

doSelect

public java.lang.Object[] doSelect(Query.CacheKey key)
                            throws java.sql.SQLException

columnToPropertyName

public java.lang.String columnToPropertyName(java.lang.String n)

getDataBeanClass

public java.lang.String getDataBeanClass()

setDataBeanClass

public void setDataBeanClass(java.lang.String s)

newRowBean

public java.lang.Object newRowBean()
                            throws java.lang.ClassNotFoundException,
                                   java.lang.InstantiationException,
                                   java.lang.IllegalAccessException