org.apache.commons.dbutils.wrappers
クラス SqlNullCheckedResultSet

java.lang.Object
  org.apache.commons.dbutils.wrappers.SqlNullCheckedResultSet

すべての実装インタフェース:

InvocationHandler

public class SqlNullCheckedResultSet

extends Object

implements InvocationHandler

ResultSet の各 getXXX メソッドに SQL NULL 値の判定処理を追加します。 getXXX メソッドによって SQL NULL でないカラム値が取得された場合、そのカラム値が返されます。 一方、カラム値が SQL NULL であった場合には代替値が返されます。 デフォルトの代替値は、当該クラスのインスタンスへオーバーライドすることが可能な Java の null 値です。

役に立つ例題:

 Connection conn = // 接続を取得する
 Statement stmt = conn.createStatement();
 ResultSet rs = stmt.executeQuery("SELECT col1, col2 FROM table1");
 
 // SQL NULLを判定する結果セットをラップする
 SqlNullCheckedResultSet wrapper = new SqlNullCheckedResultSet(rs);
 wrapper.setNullString("---N/A---"); // null文字列に対して設定する
 wrapper.setNullInt(-999); // null 数値に対して設定する
 rs = ProxyFactory.instance().createResultSet(wrapper);
 
 while (rs.next()) {
     // col1 がSQL NULL の場合、"---N/A---" が値として返される
     String col1 = rs.getString("col1");
     // col2 がSQL NULL の場合、-999 が値として返される
     int col2 = rs.getInt("col2");
 }
 rs.close();
 

rs.close(); }

バージョン:

$Id: SqlNullCheckedResultSet.java,v 1.1.1.1 2004/02/13 10:02:04 hioki Exp $

作成者:

Steven Caswell, David Graham

翻訳者:

小川 環

校正者:

日置 聡

コンストラクタの概要

SqlNullCheckedResultSet(ResultSet rs)
指定された ResultSet をラップした SqlNullCheckedResultSet の新規インスタンスを作成します。

メソッドの概要

InputStream	getNullAsciiStream() getAsciiStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
BigDecimal	getNullBigDecimal() getBigDecimal メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
InputStream	getNullBinaryStream() getBinaryStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Blob	getNullBlob() getBlob メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
boolean	getNullBoolean() getBoolean メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
byte	getNullByte() getByte メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
byte[]	getNullBytes() getBytes メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Reader	getNullCharacterStream() getCharacterStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Clob	getNullClob() getClob メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Date	getNullDate() getDate メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
double	getNullDouble() getDouble メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
float	getNullFloat() getFloat メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
int	getNullInt() getInt メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
long	getNullLong() getLong メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Object	getNullObject() getObject メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Ref	getNullRef() getRef メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
short	getNullShort() getShort メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
String	getNullString() getString メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Time	getNullTime() getTime メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Timestamp	getNullTimestamp() getTimestamp メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
URL	getNullURL() getURL メソッドの処理結果が SQL NULL だった場合に使用する値を返します。
Object	invoke(Object proxy, Method method, Object[] args) get* メソッドの呼び出しを捕捉し、ResultSet が null を返す場合、適切な getNull* メソッドを呼び出します。
void	setNullAsciiStream(InputStream nullAsciiStream) getAsciiStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullBigDecimal(BigDecimal nullBigDecimal) getBigDecimal メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullBinaryStream(InputStream nullBinaryStream) getBinaryStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullBlob(Blob nullBlob) getBlob メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullBoolean(boolean nullBoolean) getBoolean メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullByte(byte nullByte) getByte メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullBytes(byte[] nullBytes) getBytes メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullCharacterStream(Reader nullCharacterStream) getCharacterStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullClob(Clob nullClob) getClob メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullDate(Date nullDate) getDate メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullDouble(double nullDouble) getDouble メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullFloat(float nullFloat) getFloat メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullInt(int nullInt) getInt メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullLong(long nullLong) getLong メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullObject(Object nullObject) getObject メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullRef(Ref nullRef) getRef メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullShort(short nullShort) getShort メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullString(String nullString) getString メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullTime(Time nullTime) getTime メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullTimestamp(Timestamp nullTimestamp) getTimestamp メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
void	setNullURL(URL nullURL) getURL メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。
static ResultSet	wrap(ResultSet rs) このクラスのインスタンスに ResultSet をラップします。

クラス java.lang.Object から継承したメソッド

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

コンストラクタの詳細

SqlNullCheckedResultSet

public SqlNullCheckedResultSet(ResultSet rs)

指定された ResultSet をラップした SqlNullCheckedResultSet の新規インスタンスを作成します。

メソッドの詳細

wrap

public static ResultSet wrap(ResultSet rs)

このクラスのインスタンスに ResultSet をラップします。 これは、次のコードと等しいです。

 ProxyFactory.instance().createResultSet(new SqlNullCheckedResultSet(rs));
 

パラメータ:

rs - ラップする ResultSet。

getNullAsciiStream

public InputStream getNullAsciiStream()

getAsciiStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullBigDecimal

public BigDecimal getNullBigDecimal()

getBigDecimal メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullBinaryStream

public InputStream getNullBinaryStream()

getBinaryStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullBlob

public Blob getNullBlob()

getBlob メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullBoolean

public boolean getNullBoolean()

getBoolean メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullByte

public byte getNullByte()

getByte メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullBytes

public byte[] getNullBytes()

getBytes メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullCharacterStream

public Reader getNullCharacterStream()

getCharacterStream メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullClob

public Clob getNullClob()

getClob メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullDate

public Date getNullDate()

getDate メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullDouble

public double getNullDouble()

getDouble メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullFloat

public float getNullFloat()

getFloat メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullInt

public int getNullInt()

getInt メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullLong

public long getNullLong()

getLong メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullObject

public Object getNullObject()

getObject メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullRef

public Ref getNullRef()

getRef メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullShort

public short getNullShort()

getShort メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullString

public String getNullString()

getString メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullTime

public Time getNullTime()

getTime メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullTimestamp

public Timestamp getNullTimestamp()

getTimestamp メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

getNullURL

public URL getNullURL()

getURL メソッドの処理結果が SQL NULL だった場合に使用する値を返します。

戻り値:

( SQL null の代わりに返す)値

invoke

public Object invoke(Object proxy,
                     Method method,
                     Object[] args)
              throws Throwable

get* メソッドの呼び出しを捕捉し、ResultSet が null を返す場合、適切な getNull* メソッドを呼び出します。

定義:

インタフェース InvocationHandler 内の invoke

例外:

Throwable

関連項目:

InvocationHandler.invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[])

setNullAsciiStream

public void setNullAsciiStream(InputStream nullAsciiStream)

getAsciiStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullAsciiStream - ( SQL null の代わりに返す)値

setNullBigDecimal

public void setNullBigDecimal(BigDecimal nullBigDecimal)

getBigDecimal メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullBigDecimal - ( SQL null の代わりに返す)値

setNullBinaryStream

public void setNullBinaryStream(InputStream nullBinaryStream)

getBinaryStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullBinaryStream - ( SQL null の代わりに返す)値

setNullBlob

public void setNullBlob(Blob nullBlob)

getBlob メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullBlob - ( SQL null の代わりに返す)値

setNullBoolean

public void setNullBoolean(boolean nullBoolean)

getBoolean メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullBoolean - ( SQL null の代わりに返す)値

setNullByte

public void setNullByte(byte nullByte)

getByte メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullByte - ( SQL null の代わりに返す)値

setNullBytes

public void setNullBytes(byte[] nullBytes)

getBytes メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullBytes - ( SQL null の代わりに返す)値

setNullCharacterStream

public void setNullCharacterStream(Reader nullCharacterStream)

getCharacterStream メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullCharacterStream - ( SQL null の代わりに返す)値

setNullClob

public void setNullClob(Clob nullClob)

getClob メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullClob - ( SQL null の代わりに返す)値

setNullDate

public void setNullDate(Date nullDate)

getDate メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullDate - ( SQL null の代わりに返す)値

setNullDouble

public void setNullDouble(double nullDouble)

getDouble メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullDouble - ( SQL null の代わりに返す)値

setNullFloat

public void setNullFloat(float nullFloat)

getFloat メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullFloat - ( SQL null の代わりに返す)値

setNullInt

public void setNullInt(int nullInt)

getInt メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullInt - ( SQL null の代わりに返す)値

setNullLong

public void setNullLong(long nullLong)

getLong メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullLong - ( SQL null の代わりに返す)値

setNullObject

public void setNullObject(Object nullObject)

getObject メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullObject - ( SQL null の代わりに返す)値

setNullRef

public void setNullRef(Ref nullRef)

getRef メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullRef - ( SQL null の代わりに返す)値

setNullShort

public void setNullShort(short nullShort)

getShort メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullShort - ( SQL null の代わりに返す)値

setNullString

public void setNullString(String nullString)

getString メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullString - ( SQL null の代わりに返す)値

setNullTime

public void setNullTime(Time nullTime)

getTime メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullTime - ( SQL null の代わりに返す)値

setNullTimestamp

public void setNullTimestamp(Timestamp nullTimestamp)

getTimestamp メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullTimestamp - ( SQL null の代わりに返す)値

setNullURL

public void setNullURL(URL nullURL)

getURL メソッドの処理結果が SQL NULL だった場合に使用する値を設定します。

パラメータ:

nullURL - ( SQL null の代わりに返す)値