DataSource.Instance (jdbc-util 0.3.3 API)

java.lang.Object
- net.osdn.util.sql.DataSource.Instance

含まれているクラス:

DataSource
```
public static class DataSource.Instance
extends java.lang.Object
```
データソース・ユーティリティーの実装クラスです。
複数のデータソースを扱う場合は、明示的にDataSource.Instanceのインスタンスを作成する必要があります。

コンストラクタのサマリー

コンストラクタ
コンストラクタと説明
`Instance(javax.sql.ConnectionPoolDataSource datasource)` `ConnectionPoolDataSource`インターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
`Instance(javax.sql.ConnectionPoolDataSource datasource, java.lang.String username, java.lang.String password)` `ConnectionPoolDataSource`インターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
`Instance(javax.sql.DataSource datasource)` `DataSource`インターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
`Instance(javax.sql.DataSource datasource, java.lang.String username, java.lang.String password)` `DataSource`インターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
`Instance(java.lang.String jndiNameOrJdbcUrl)` JNDIリソース名またはJDBC接続文字列を指定してDataSource.Instanceを作成します。
`Instance(java.lang.String jdbcUrl, java.util.Properties info)` JDBC接続文字列を指定してDataSource.Instanceを作成します。
`Instance(java.lang.String jndiNameOrJdbcUrl, java.lang.String username, java.lang.String password)` JNDIリソース名またはJDBC接続文字列を指定してDataSource.Instanceを作成します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド concreteメソッド
修飾子とタイプ	メソッドと説明
`Transaction`	`beginTransaction()` 新しいデータベースへの接続を作成してトランザクションを開始します。
`Transaction`	`beginTransaction(IsolationLevel level)` 新しいデータベースへの接続を作成して指定された分離レベルのトランザクションを開始します。
`void`	`close()` データソースがjavax.sql.ConnectionPoolDataSrouceを実装している場合、このメソッドは接続プールを閉じます。
`int[]`	`delete(java.util.Collection<?> objects)` 指定された複数のオブジェクトそれぞれに対してDELETE文を構築し、データソースから行の削除を試みます。
`int[]`	`delete(java.lang.Object... objects)` 指定された複数のオブジェクトそれぞれに対してDELETE文を構築し、データソースから行の削除を試みます。
`int`	`delete(java.lang.Object obj)` 指定されたオブジェクトでDELETE文を構築し、データソースから行の削除を試みます。
`java.sql.ResultSet`	`executeQuery(NamedParameterStatement statement)` 指定された名前付きパラメーターステートメントを実行し、単一のResultSetオブジェクトを返します。
`java.sql.ResultSet`	`executeQuery(java.lang.String sql)` 指定されたSQL文を実行し、単一のResultSetオブジェクトを返す、します。
`java.sql.ResultSet`	`executeQuery(java.lang.String sql, java.util.Collection<?> parameters)` 指定されたSQL文にパラメーターを設定して実行し、単一のResultSetオブジェクトを返します。
`java.sql.ResultSet`	`executeQuery(java.lang.String sql, java.lang.Object... parameters)` 指定されたSQL文にパラメーターを設定して実行し、単一のResultSetオブジェクトを返します。
`java.sql.ResultSet`	`executeQueryWaitForRows(long timeout, NamedParameterStatement statement)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`java.sql.ResultSet`	`executeQueryWaitForRows(long timeout, java.lang.String sql, java.util.Collection<?> parameters)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`java.sql.ResultSet`	`executeQueryWaitForRows(long timeout, java.lang.String sql, java.lang.Object... parameters)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`java.sql.ResultSet`	`executeQueryWaitForRows(Monitor.MultipleObjects waiters, NamedParameterStatement statement)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`java.sql.ResultSet`	`executeQueryWaitForRows(Monitor.MultipleObjects waiters, java.lang.String sql, java.util.Collection<?> parameters)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`java.sql.ResultSet`	`executeQueryWaitForRows(Monitor.MultipleObjects waiters, java.lang.String sql, java.lang.Object... parameters)` 1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
`<T> T`	`executeScalar(NamedParameterStatement statement)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
`<T> T`	`executeScalar(java.lang.String sql)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
`<T> T`	`executeScalar(java.lang.String sql, java.util.Collection<?> parameters)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
`<T> T`	`executeScalar(java.lang.String sql, java.lang.Object... parameters)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
`int`	`executeUpdate(NamedParameterStatement statement)` SQL文を実行します。
`int`	`executeUpdate(java.lang.Object notifier, NamedParameterStatement statement)` SQL文を実行して待機スレッドを再開させます。
`int`	`executeUpdate(java.lang.Object notifier, java.lang.String sql, java.util.Collection<?> parameters)` SQL文を実行して待機スレッドを再開させます。
`int`	`executeUpdate(java.lang.Object notifier, java.lang.String sql, java.lang.Object... parameters)` SQL文を実行して待機スレッドを再開させます。
`int`	`executeUpdate(java.lang.String sql)` SQL文を実行します。
`int`	`executeUpdate(java.lang.String sql, java.util.Collection<?> parameters)` SQL文を実行します。
`int`	`executeUpdate(java.lang.String sql, java.lang.Object... parameters)` SQL文を実行します。
`java.sql.Connection`	`getConnection()` データソースへの接続を取得します。
`java.sql.Connection`	`getConnection(int options)`
`SqlExecutionHandler`	`getSqlExecutionHandler()` SQL実行ハンドラーを取得します。
`int[]`	`insert(java.util.Collection<?> objects)` 指定された複数のオブジェクトそれぞれに対してINSERT文を構築し、データソースへ行の追加を試みます。
`int[]`	`insert(java.lang.Object... objects)` 指定された複数のオブジェクトそれぞれに対してINSERT文を構築し、データソースへ行の追加を試みます。
`int`	`insert(java.lang.Object obj)` 指定されたオブジェクトでINSERT文を構築し、データソースへ行の追加を試みます。
`int[]`	`merge(java.util.Collection<?> objects)` 指定された複数のオブジェクトそれぞれに対してMERGE文を構築し、データソースへ行の追加または更新を試みます。
`int[]`	`merge(java.lang.Object... objects)` 指定された複数のオブジェクトそれぞれに対してMERGE文を構築し、データソースへ行の追加または更新を試みます。
`int`	`merge(java.lang.Object obj)` 指定されたオブジェクトでMERGE文を構築し、データソースへ行の追加または更新を試みます。
`javax.sql.rowset.CachedRowSet`	`populate(java.sql.ResultSet rs)` 指定したResultSetオブジェクトのデータを読み込んでCachedRowSetを作成します。
`<T> T`	`select(java.lang.Class<T> returnClass)` 指定したクラスでSELECT文を構築し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Class<T> returnClass, NamedParameterStatement statement)` 指定された名前付きパラメーターステートメントを実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Class<T> returnClass, java.lang.Object obj)` 指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Class<T> returnClass, java.lang.String sql)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Class<T> returnClass, java.lang.String sql, java.util.Collection<?> parameters)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Class<T> returnClass, java.lang.String sql, java.lang.Object... parameters)` 指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
`<T> T`	`select(java.lang.Object obj)` 指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行をオブジェクトとして返します。
`<T> T`	`select(java.lang.String columnName, java.lang.Object obj)` 指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行から指定された列名の値を返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass)` 指定されたクラスでSELECT文を構築し、そのクエリーが返す結果セットをクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass, NamedParameterStatement statement)` 指定された名前付きパラメーターステートメントを実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass, java.lang.Object obj)` 指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass, java.lang.String sql)` 指定されたSQL文を実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass, java.lang.String sql, java.util.Collection<?> parameters)` 指定されたSQL文にパラメーターを設定して実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Class<T> returnClass, java.lang.String sql, java.lang.Object... parameters)` 指定されたSQL文にパラメーターを設定して実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
`<T> java.util.List<T>`	`selectAsList(java.lang.Object obj)` 指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットをオブジェクトのクラスのリストとして返します。
`void`	`setSqlExecutionHandler(SqlExecutionHandler sqlExecutionHandler)` SQL実行ハンドラーを設定します。
`int[]`	`update(java.util.Collection<?> objects)` 指定された複数のオブジェクトそれぞれに対してUPDATE文を構築し、データソースへ行の更新を試みます。
`int[]`	`update(java.lang.Object... objects)` 指定された複数のオブジェクトそれぞれに対してUPDATE文を構築し、データソースへ行の更新を試みます。
`int`	`update(java.lang.Object obj)` 指定されたオブジェクトでUPDATE文を構築し、データソースへ行の更新を試みます。

クラスから継承されたメソッド java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- コンストラクタの詳細
  - Instance
```
public Instance(java.lang.String jndiNameOrJdbcUrl)
         throws javax.naming.NamingException,
                java.sql.SQLException
```
    JNDIリソース名またはJDBC接続文字列を指定してDataSource.Instanceを作成します。第1引数の文字列が jdbc: で始まる場合、JDBC接続文字列として扱われます。それ以外の場合は JNDIリソース名としてリソースを検索します。
    
    パラメータ:
    
    jndiNameOrJdbcUrl - JNDIリソース名またはJDBC接続文字列
    
    例外:
    
    javax.naming.NamingException - ネーミング例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(java.lang.String jndiNameOrJdbcUrl,
                java.lang.String username,
                java.lang.String password)
         throws javax.naming.NamingException,
                java.sql.SQLException
```
    JNDIリソース名またはJDBC接続文字列を指定してDataSource.Instanceを作成します。データベースへの接続には username と password を使用します。第1引数の文字列が jdbc: で始まる場合、JDBC接続文字列として扱われます。それ以外の場合は JNDIリソース名としてリソースを検索します。
    
    パラメータ:
    
    jndiNameOrJdbcUrl - JNDIリソース名またはJDBC接続文字列
    
    username - データベース接続に使用するユーザー名
    
    password - データベース接続に使用するユーザーのパスワード
    
    例外:
    
    javax.naming.NamingException - ネーミング例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(java.lang.String jdbcUrl,
                java.util.Properties info)
         throws java.sql.SQLException
```
    JDBC接続文字列を指定してDataSource.Instanceを作成します。
    
    パラメータ:
    
    jdbcUrl - JDBC接続文字列
    
    info - ユーザー名やパスワードを保持するプロパティ情報
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(javax.sql.DataSource datasource)
         throws java.sql.SQLException
```
    DataSourceインターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
    
    パラメータ:
    
    datasource - DataSourceインターフェースを実装しているデータソース
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(javax.sql.DataSource datasource,
                java.lang.String username,
                java.lang.String password)
         throws java.sql.SQLException
```
    DataSourceインターフェースを実装したデータソースを持つDataSource.Instanceを作成します。データベースへの接続には username と password を使用します。
    
    パラメータ:
    
    datasource - DataSourceインターフェースを実装しているデータソース
    
    username - データベース接続に使用するユーザー名
    
    password - データベース接続に使用するユーザーのパスワード
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(javax.sql.ConnectionPoolDataSource datasource)
         throws java.sql.SQLException
```
    ConnectionPoolDataSourceインターフェースを実装したデータソースを持つDataSource.Instanceを作成します。
    
    パラメータ:
    
    datasource - ConnectionPoolDataSourceインターフェースを実装しているデータソース
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - Instance
```
public Instance(javax.sql.ConnectionPoolDataSource datasource,
                java.lang.String username,
                java.lang.String password)
         throws java.sql.SQLException
```
    ConnectionPoolDataSourceインターフェースを実装したデータソースを持つDataSource.Instanceを作成します。データベースへの接続には username と password を使用します。
    
    パラメータ:
    
    datasource - ConnectionPoolDataSourceインターフェースを実装しているデータソース
    
    username - データベース接続に使用するユーザー名
    
    password - データベース接続に使用するユーザーのパスワード
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
- メソッドの詳細
  - setSqlExecutionHandler
```
public void setSqlExecutionHandler(SqlExecutionHandler sqlExecutionHandler)
```
    SQL実行ハンドラーを設定します。 SQL実行ハンドラーを設定すると、DataSource または Transaction を通して実行されるSQLの各局面(onBeforeExecution, onAfterReturning, onAfterThrowing, onAfterExecution)でSQL実行ハンドラーが呼び出されるようになります。 SQL実行ハンドラーはログを出力するのに役立ちます。 getConnectionメソッドなどで直接取得した接続を使ってSQLを実行した場合は、SQL実行ハンドラーは呼び出されないことに注意してください。
    
    パラメータ:
    
    sqlExecutionHandler - SQL実行ハンドラー
  - getSqlExecutionHandler
```
public SqlExecutionHandler getSqlExecutionHandler()
```
    SQL実行ハンドラーを取得します。
    
    戻り値:
    
    SQL実行ハンドラー。設定されていない場合は null
  - beginTransaction
```
public Transaction beginTransaction()
                             throws java.sql.SQLException
```
    新しいデータベースへの接続を作成してトランザクションを開始します。トランザクション分離レベルは READ COMMITTED に設定されます。
    
    戻り値:
    
    トランザクション
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - beginTransaction
```
public Transaction beginTransaction(IsolationLevel level)
                             throws java.sql.SQLException
```
    新しいデータベースへの接続を作成して指定された分離レベルのトランザクションを開始します。
    
    パラメータ:
    
    level - トランザクション分離レベル
    
    戻り値:
    
    トランザクション
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - getConnection
```
public java.sql.Connection getConnection()
                                  throws java.sql.SQLException
```
    データソースへの接続を取得します。
    データソースがjavax.sql.ConnectionPoolDataSourceインターフェースを実装している場合、このメソッドはプールされている接続を返します。
    
    戻り値:
    
    データソースへの接続
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - getConnection
```
public java.sql.Connection getConnection(int options)
                                  throws java.sql.SQLException
```
    例外:
    
    java.sql.SQLException
  - close
```
public void close()
```
    データソースがjavax.sql.ConnectionPoolDataSrouceを実装している場合、このメソッドは接続プールを閉じます。
    接続プールが閉じられると、プールされているすべての接続も閉じられます。ただし、getConnection()メソッドによって払い出されているアクティブな接続が強制的に閉じられることはありません。このメソッドの呼び出し以降、getConnection()メソッドによって払い出されているアクティブな接続のclose()メソッドを呼び出すと、接続はプールに戻されるのではなく、データソースとの物理的な接続が閉じられます。
  - populate
```
public javax.sql.rowset.CachedRowSet populate(java.sql.ResultSet rs)
                                       throws java.sql.SQLException
```
    指定したResultSetオブジェクトのデータを読み込んでCachedRowSetを作成します。
    CachedRowSet オブジェクトは、メモリー内に行をキャッシュする、データ行のコンテナであり、常にそのデータソースに接続していなくても処理を実行できます。
    
    パラメータ:
    
    rs - ResultSetオブジェクト
    
    戻り値:
    
    ResultSetオブジェクトのデータを読み込んだCachedRowSet
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
  - executeQuery
```
public java.sql.ResultSet executeQuery(java.lang.String sql)
                                throws java.sql.SQLException,
                                       java.io.IOException
```
    指定されたSQL文を実行し、単一のResultSetオブジェクトを返す、します。
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    sql - データベースに送られるSQL文。通常は静的なSELECT文です。
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQuery
```
public java.sql.ResultSet executeQuery(java.lang.String sql,
                                       java.lang.Object... parameters)
                                throws java.sql.SQLException,
                                       java.io.IOException
```
    指定されたSQL文にパラメーターを設定して実行し、単一のResultSetオブジェクトを返します。
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQuery
```
public java.sql.ResultSet executeQuery(java.lang.String sql,
                                       java.util.Collection<?> parameters)
                                throws java.sql.SQLException,
                                       java.io.IOException
```
    指定されたSQL文にパラメーターを設定して実行し、単一のResultSetオブジェクトを返します。
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQuery
```
public java.sql.ResultSet executeQuery(NamedParameterStatement statement)
                                throws java.sql.SQLException,
                                       java.io.IOException
```
    指定された名前付きパラメーターステートメントを実行し、単一のResultSetオブジェクトを返します。
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
    
    関連項目:
    
    NamedParameterStatement
  - executeUpdate
```
public int executeUpdate(java.lang.String sql)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行します。
    それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    
    パラメータ:
    
    sql - 結果セットを返さないSQL文
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(java.lang.String sql,
                         java.lang.Object... parameters)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行します。
    それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第2引数を省略してこのメソッドを呼び出します。
    
    パラメータ:
    
    sql - 結果セットを返さないSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(java.lang.String sql,
                         java.util.Collection<?> parameters)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行します。
    それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第2引数を省略してこのメソッドを呼び出します。
    
    パラメータ:
    
    sql - 結果セットを返さないSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(NamedParameterStatement statement)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行します。
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    それはSQLデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さないSQL文でなければなりません。
    
    パラメータ:
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(java.lang.Object notifier,
                         java.lang.String sql,
                         java.lang.Object... parameters)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行して待機スレッドを再開させます。
    SQL文を実行して影響を受けた行数が1行以上あった場合、このデータソースが保持する Monitor を使って notifierオブジェクトに通知を送ります。notifierオブジェクトを含むMultipleObjectsで待機しているスレッドがあれば再開されます。
    
    SQL文はデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さない文でなければなりません。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第2引数を省略してこのメソッドを呼び出します。
    
    パラメータ:
    
    notifier - 待機中のスレッドを再開させるためのオブジェクト
    
    sql - 結果セットを返さないSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(java.lang.Object notifier,
                         java.lang.String sql,
                         java.util.Collection<?> parameters)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行して待機スレッドを再開させます。
    SQL文を実行して影響を受けた行数が1行以上あった場合、このデータソースが保持する Monitor を使って notifierオブジェクトに通知を送ります。notifierオブジェクトを含むMultipleObjectsで待機しているスレッドがあれば再開されます。
    
    SQL文はデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さない文でなければなりません。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第2引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第2引数を省略してこのメソッドを呼び出します。
    
    パラメータ:
    
    notifier - 待機中のスレッドを再開させるためのオブジェクト
    
    sql - 結果セットを返さないSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeUpdate
```
public int executeUpdate(java.lang.Object notifier,
                         NamedParameterStatement statement)
                  throws java.sql.SQLException,
                         java.io.IOException
```
    SQL文を実行して待機スレッドを再開させます。
    SQL文を実行して影響を受けた行数が1行以上あった場合、このデータソースが保持する Monitor を使って notifierオブジェクトに通知を送ります。notifierオブジェクトを含むMultipleObjectsで待機しているスレッドがあれば再開されます。
    
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    SQL文はデータ操作言語(DML)文(INSERT文、UPDATE文、DELETE文など)であるか、DDL文のような何も返さない文でなければなりません。
    
    パラメータ:
    
    notifier - 待機中のスレッドを再開させるためのオブジェクト
    
    statement - 結果セットを返さないSQL文
    
    戻り値:
    
    (1) SQLデータ操作言語(DML)文の場合は行数、(2) 何も返さないSQL文の場合は 0
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
    
    関連項目:
    
    NamedParameterStatement
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(long timeout,
                                                  java.lang.String sql,
                                                  java.lang.Object... parameters)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、暗黙的な待機オブジェクトを使ってこのスレッドを待機させます。暗黙的な待機オブジェクトはSQL文に最初に出現するテーブル名を持つString型です。ほかのスレッドがこのテーブル名を指定して、データソースが保持する Monitor のnotifyAll(String)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    timeout - ミリ秒単位の待機時間
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(long timeout,
                                                  java.lang.String sql,
                                                  java.util.Collection<?> parameters)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、暗黙的な待機オブジェクトを使ってこのスレッドを待機させます。暗黙的な待機オブジェクトはSQL文に最初に出現するテーブル名を持つString型です。ほかのスレッドがこのテーブル名を指定して、データソースが保持する Monitor のnotifyAll(String)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    timeout - ミリ秒単位の待機時間
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(long timeout,
                                                  NamedParameterStatement statement)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、暗黙的な待機オブジェクトを使ってこのスレッドを待機させます。暗黙的な待機オブジェクトはSQL文に最初に出現するテーブル名を持つString型です。ほかのスレッドがこのテーブル名を指定して、データソースが保持する Monitor のnotifyAll(Object)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    timeout - ミリ秒単位の待機時間
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
    
    関連項目:
    
    NamedParameterStatement
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(Monitor.MultipleObjects waiters,
                                                  java.lang.String sql,
                                                  java.lang.Object... parameters)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、指定された Monitor.MultipleObjects waitersを使ってこのスレッドを待機させます。ほかのスレッドがwaitersに含まれるオブジェクトのいずれかを指定して、データソースが保持する Monitor のnotifyAll(Object)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    waiters - 待機中のスレッドを再開させるためのオブジェクトを含むMultipleObjects
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(Monitor.MultipleObjects waiters,
                                                  java.lang.String sql,
                                                  java.util.Collection<?> parameters)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、指定された Monitor.MultipleObjects waitersを使ってこのスレッドを待機させます。ほかのスレッドがwaitersに含まれるオブジェクトのいずれかを指定して、データソースが保持する Monitor のnotifyAll(Object)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    waiters - 待機中のスレッドを再開させるためのオブジェクトを含むMultipleObjects
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeQueryWaitForRows
```
public java.sql.ResultSet executeQueryWaitForRows(Monitor.MultipleObjects waiters,
                                                  NamedParameterStatement statement)
                                           throws java.sql.SQLException,
                                                  java.util.concurrent.TimeoutException,
                                                  java.lang.InterruptedException,
                                                  java.io.IOException
```
    1行以上の結果が得られるか、あらかじめ指定されている量の実時間が経過するまで、指定されたSQLを繰り返し実行します。
    SQL文を実行して返された結果行数が 0 である場合、指定された Monitor.MultipleObjects waitersを使ってこのスレッドを待機させます。ほかのスレッドがwaitersに含まれるオブジェクトのいずれかを指定して、データソースが保持する Monitor のnotifyAll(Object)メソッドを呼び出すと、スレッドが再開され、再び、SQL文が実行されます。
    
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    返されるResultSetオブジェクトはメモリーにキャッシュされた非接続の行セットです。
    
    パラメータ:
    
    waiters - 待機中のスレッドを再開させるためのオブジェクトを含むMultipleObjects
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    指定されたクエリーによって作成されたデータを含むResultSetオブジェクト。nullにはなりません。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.util.concurrent.TimeoutException - 指定された待機時間が経過した場合
    
    java.lang.InterruptedException - 現在のスレッドが通知を待機する前または待機中に、いずれかのスレッドが現在のスレッドに割り込んだ場合。この例外がスローされると、現在のスレッドの「割り込みステータス」はクリアされます。
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
    
    関連項目:
    
    NamedParameterStatement
  - executeScalar
```
public <T> T executeScalar(java.lang.String sql)
                    throws java.sql.SQLException,
                           java.io.IOException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
    
    型パラメータ:
    
    T - 返される列の値をキャストする型。列の値はResultSetのgetObject(int)によって取得されて<T>にキャストされます。
    
    パラメータ:
    
    sql - データベースに送られるSQL文。通常は静的なSELECT文です。
    
    戻り値:
    
    指定されたクエリーが返す結果セットの最初の行にある最初の列。行がない場合は null。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeScalar
```
public <T> T executeScalar(java.lang.String sql,
                           java.lang.Object... parameters)
                    throws java.sql.SQLException,
                           java.io.IOException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    型パラメータ:
    
    T - 返される列の値をキャストする型。列の値はResultSetのgetObject(int)によって取得されて<T>にキャストされます。
    
    パラメータ:
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーが返す結果セットの最初の行にある最初の列。行がない場合は null。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeScalar
```
public <T> T executeScalar(java.lang.String sql,
                           java.util.Collection<?> parameters)
                    throws java.sql.SQLException,
                           java.io.IOException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
    このメソッドに指定するSQL文はパラメータのプレースホルダーを使うことができます。パラメーターのプレースホルダーは ? で指定します。パラメーターのプレースホルダーには第3引数で指定したparametersが順番に割り当てられます。パラメーターが必要ない場合は第3引数を省略してこのメソッドを呼び出します。
    
    型パラメータ:
    
    T - 返される列の値をキャストする型。列の値はResultSetのgetObject(int)によって取得されて<T>にキャストされます。
    
    パラメータ:
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    指定されたクエリーが返す結果セットの最初の行にある最初の列。行がない場合は null。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
  - executeScalar
```
public <T> T executeScalar(NamedParameterStatement statement)
                    throws java.sql.SQLException,
                           java.io.IOException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行にある最初の列を返します。
    このメソッドには名前付きパラメーター機能を提供するNamedParameterStatementを指定します。
    
    型パラメータ:
    
    T - 返される列の値をキャストする型。列の値はResultSetのgetObject(int)によって取得されて<T>にキャストされます。
    
    パラメータ:
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    指定されたクエリーが返す結果セットの最初の行にある最初の列。行がない場合は null。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.io.IOException - 暗黙的トランザクションで自動クローズ例外が発生した場合
    
    関連項目:
    
    NamedParameterStatement
  - select
```
public <T> T select(java.lang.String columnName,
                    java.lang.Object obj)
             throws java.sql.SQLException,
                    java.lang.IllegalArgumentException,
                    java.lang.IllegalAccessException
```
    指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行から指定された列名の値を返します。
    SELECT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはWHERE句に指定されます。
    
    id列とname列を持つPersonテーブルに対してSELECT文を実行するには以下の方法があります。
```
 String name = DataSource.select("name", new Person() {
     int id = 1;
 });
 
```
    または
```
 String name = DataSource.select("name", new Table("Person") {
     int id = 1;
 });
 
```
    ただし、以下のようにPersonクラスのインスタンスを初期化した場合は上記と同じ結果になりません。
```
 Person person = new Person();
 person.id = 1;
 String name = DataSource.select("name", person);
 
```
    上記のケースではPersonクラスが持つ他のフィールドnameがWHERE句に追加されてしまうためです。
    型パラメータ:
    
    T - 返される列の値をキャストする型。列の値はResultSet#getObject(int)によって取得されて<T>にキャストされます。
    
    パラメータ:
    
    columnName - 列名
    
    obj - SELECT文を構築するオブジェクト
    
    戻り値:
    
    クエリーが返す結果セットの最初の行にある指定された列名の値。行がない場合は null。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalArgumentException - 指定されたオブジェクトが null の場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - select
```
public <T> T select(java.lang.Object obj)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行をオブジェクトとして返します。
    SELECT文を構築するために指定するオブジェクトはPOJOオブジェクトです。オブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはWHERE句に指定されます。
    
    id列とname列を持つPersonテーブルに対してSELECT文を実行するには以下のようにします。
```
 Person person = DataSource.select(new Person() {
     int id = 1;
 });
 
```
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    obj - SELECT文を構築するオブジェクト
    
    戻り値:
    
    クエリーが返す結果セットの最初の行をオブジェクトのクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定したクラスでSELECT文を構築し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    このメソッドはレコードが1行しかないテーブルのデータを取得するのに適しています。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass,
                    java.lang.Object obj)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    SELECT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはWHERE句に指定されます。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    obj - SELECT文を構築するオブジェクト
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass,
                    java.lang.String sql)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    返されるオブジェクトの型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、単一の列のみを保持している結果セットが必要です。結果セットの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    sql - データベースに送られるSQL文。通常は静的なSELECT文です。
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass,
                    java.lang.String sql,
                    java.lang.Object... parameters)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    返されるオブジェクトの型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、単一の列のみを保持している結果セットが必要です。結果セットの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass,
                    java.lang.String sql,
                    java.util.Collection<?> parameters)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    返されるオブジェクトの型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、単一の列のみを保持している結果セットが必要です。結果セットの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - select
```
public <T> T select(java.lang.Class<T> returnClass,
                    NamedParameterStatement statement)
             throws java.sql.SQLException,
                    java.text.ParseException,
                    java.lang.ReflectiveOperationException
```
    指定された名前付きパラメーターステートメントを実行し、そのクエリーが返す結果セットの最初の行を指定されたクラスのオブジェクトとして返します。
    返されるオブジェクトの型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、単一の列のみを保持している結果セットが必要です。結果セットの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるオブジェクトの型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    クエリーが返す結果セットの最初の行を指定されたクラス型にマッピングしたオブジェクト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたクラスでSELECT文を構築し、そのクエリーが返す結果セットをクラスのリストとして返します。
    SELECT文を構築するために指定するクラスのクラス名をテーブル名とします。このメソッドに匿名クラスを渡すことはできません。このメソッドはテーブルのすべての行を返します。
    
    Personテーブルのすべての行をList<Person>として取得するには以下のようにします。
```
 List<Person> persons = DataSource.selectAsList(Person.class);
 
```
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - クエリーが返す結果セットをマッピングするクラス。クラス名がテーブル名と一致している必要があります。
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Object obj)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットをオブジェクトのクラスのリストとして返します。
    SELECT文を構築するために指定するオブジェクトはPOJOオブジェクトです。オブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはWHERE句に指定されます。
    
    Personテーブルのdeleted列の値が1の行をList<Person>として取得するには以下のようにします。
```
 List<Person> persons = DataSource.selectAsList(new Person() {
     int deleted = 1;
 });
 
```
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    obj - SELECT文を構築するオブジェクト。このオブジェクトのクラス名がテーブル名と一致している必要があります。
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたオブジェクトのクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass,
                                          java.lang.Object obj)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたオブジェクトでSELECT文を構築し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
    SELECT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはWHERE句に指定されます。
    
    Personテーブルのdeleted列の値が1の行をList<Person>として取得するには以下のようにします。
```
 List<Person> persons = DataSource.selectAsList(Person.class, new Table("Person") {
     int deleted = 1;
 });
 
```
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - 返されるリストの要素の型
    
    obj - SELECT文を構築するオブジェクト。
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass,
                                          java.lang.String sql)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたSQL文を実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
    要素の型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、ResultSetは単一の列のみを保持している必要があります。ResultSetの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - 返されるリストの要素の型
    
    sql - データベースに送られるSQL文。通常は静的なSELECT文です。
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass,
                                          java.lang.String sql,
                                          java.lang.Object... parameters)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたSQL文にパラメーターを設定して実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
    要素の型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、ResultSetは単一の列のみを保持している必要があります。ResultSetの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - 返されるリストの要素の型
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass,
                                          java.lang.String sql,
                                          java.util.Collection<?> parameters)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定されたSQL文にパラメーターを設定して実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
    要素の型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、ResultSetは単一の列のみを保持している必要があります。ResultSetの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - 返されるリストの要素の型
    
    sql - プレースホルダー ? を含むSQL文
    
    parameters - プレースホルダーに設定されるパラメーター
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - selectAsList
```
public <T> java.util.List<T> selectAsList(java.lang.Class<T> returnClass,
                                          NamedParameterStatement statement)
                                   throws java.sql.SQLException,
                                          java.text.ParseException,
                                          java.lang.ReflectiveOperationException
```
    指定された名前付きパラメーターステートメントを実行し、そのクエリーが返す結果セットを指定されたクラスのリストとして返します。
    要素の型としてInteger.class、String.class、LocalDateTime.classなどのスカラー値の型を指定することもできます。スカラー値の型を指定する場合、ResultSetは単一の列のみを保持している必要があります。ResultSetの列数が2以上の場合、IllegalArgumentExceptionがスローされます。
    
    型パラメータ:
    
    T - 返されるリストの要素の型。
    
    パラメータ:
    
    returnClass - 返されるリストの要素の型
    
    statement - 名前付きパラメーターステートメント
    
    戻り値:
    
    クエリーが返す結果セットの各行を指定されたクラス型にマッピングしたリスト
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.text.ParseException - 列の値をフィールドの型に変換できない場合
    
    java.lang.ReflectiveOperationException - リフレクション操作例外。<T>には引数を持たないコンストラクタが必要です。
  - insert
```
public int insert(java.lang.Object obj)
           throws java.sql.SQLException,
                  java.lang.IllegalAccessException
```
    指定されたオブジェクトでINSERT文を構築し、データソースへ行の追加を試みます。
    INSERT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはVALUES句に指定されます。
    
    列 id, name, age を持つPersonテーブルに行を追加するには以下のようにします。
```
 DataSource.insert(new Person() {
     int    id   = 4;
     String name = "四郎";
     int    age  = 19; 
 });
 
```
    または
```
 DataSource.insert(new Table("Person") {
     int    id   = 4;
     String name = "四郎";
     int    age  = 19; 
 });
 
```
    または
```
 Person person = new Person();
 person.id   = 4;
 person.name = "四郎";
 person.age  = 19;
 DataSource.insert(person);
 
```
    3つ目のコード例ではPersonクラスが列名と一致する他のフィールドを持っている場合に、列名に 0 や null が指定されることに注意してください。
    パラメータ:
    
    obj - INSERT文を構築するオブジェクト
    
    戻り値:
    
    INSERT文の実行により影響を受けた行数。つまり行の追加が成功した場合は 1 です。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - insert
```
public int[] insert(java.lang.Object... objects)
             throws java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してINSERT文を構築し、データソースへ行の追加を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけINSERT文が実行されますが、これらのINSERT文は1つのトランザクションとして実行されます。
    
    INSERT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはVALUES句に指定されます。
    
    パラメータ:
    
    objects - INSERT文を構築するオブジェクト(複数)
    
    戻り値:
    
    INSERT文の実行により影響を受けた行数。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - insert
```
public int[] insert(java.util.Collection<?> objects)
             throws java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してINSERT文を構築し、データソースへ行の追加を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけINSERT文が実行されますが、これらのINSERT文は1つのトランザクションとして実行されます。
    
    INSERT文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはVALUES句に指定されます。
    
    パラメータ:
    
    objects - INSERT文を構築するオブジェクト(複数)
    
    戻り値:
    
    INSERT文の実行により影響を受けた行数。
    
    例外:
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - update
```
public int update(java.lang.Object obj)
           throws OptimisticConcurrencyException,
                  java.sql.SQLException,
                  java.lang.IllegalAccessException
```
    指定されたオブジェクトでUPDATE文を構築し、データソースへ行の更新を試みます。
    UPDATE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはSET句に指定されます。このメソッドは単一行を更新することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    主キー列 id と通常の列 name を持つPersonテーブルを更新するには以下のようにします。
```
 DataSource.update(new Person() {
     int    id   = 4;
     String name = "史郎";
 });
 
```
    上記コード例では主キー列 id の値が 4 となっている行の name 列が "史郎" に更新されます。
    
    構築されたUPDATE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、UPDATE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    パラメータ:
    
    obj - UPDATE文を構築するオブジェクト
    
    戻り値:
    
    UPDATE文の実行により影響を受けた行数。つまり行の更新が成功した場合は 1 です。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - update
```
public int[] update(java.lang.Object... objects)
             throws OptimisticConcurrencyException,
                    java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してUPDATE文を構築し、データソースへ行の更新を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけUPDATE文が実行されますが、これらのUPDATE文は1つのトランザクションとして実行されます。
    
    UPDATE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはSET句に指定されます。このメソッドは単一行を更新することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたUPDATE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、UPDATE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - UPDATE文を構築するオブジェクト(複数)
    
    戻り値:
    
    UPDATE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - update
```
public int[] update(java.util.Collection<?> objects)
             throws OptimisticConcurrencyException,
                    java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してUPDATE文を構築し、データソースへ行の更新を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけUPDATE文が実行されますが、これらのUPDATE文は1つのトランザクションとして実行されます。
    
    UPDATE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。テーブルの列名と一致するオブジェクトのフィールドはSET句に指定されます。このメソッドは単一行を更新することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたUPDATE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、UPDATE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - UPDATE文を構築するオブジェクト(複数)
    
    戻り値:
    
    UPDATE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - delete
```
public int delete(java.lang.Object obj)
           throws OptimisticConcurrencyException,
                  java.sql.SQLException,
                  java.lang.IllegalAccessException
```
    指定されたオブジェクトでDELETE文を構築し、データソースから行の削除を試みます。
    DELETE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を削除することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたDELETE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、DELETE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    obj - DELETE文を構築するオブジェクト
    
    戻り値:
    
    DELETE文の実行により影響を受けた行数。つまり行の削除が成功した場合は 1 です。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - delete
```
public int[] delete(java.lang.Object... objects)
             throws OptimisticConcurrencyException,
                    java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してDELETE文を構築し、データソースから行の削除を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけDELETE文が実行されますが、これらのDELETE文は1つのトランザクションとして実行されます。
    
    DELETE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を削除することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたDELETE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、DELETE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - DELETE文を構築するオブジェクト(複数)
    
    戻り値:
    
    DELETE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - delete
```
public int[] delete(java.util.Collection<?> objects)
             throws OptimisticConcurrencyException,
                    java.sql.SQLException,
                    java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してDELETE文を構築し、データソースから行の削除を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけDELETE文が実行されますが、これらのDELETE文は1つのトランザクションとして実行されます。
    
    DELETE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を削除することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。 WHERE句を構成する(行を一意に特定するための)列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたDELETE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、DELETE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - DELETE文を構築するオブジェクト(複数)
    
    戻り値:
    
    DELETE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - merge
```
public int merge(java.lang.Object obj)
          throws OptimisticConcurrencyException,
                 java.sql.SQLException,
                 java.lang.IllegalAccessException
```
    指定されたオブジェクトでMERGE文を構築し、データソースへ行の追加または更新を試みます。
    MERGE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を更新または追加することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。行を一意に特定するための列はテーブルのスキーマに基づいて自動的に決定されます。
    
    主キー列 id と通常の列 name を持つPersonテーブルを追加または更新するには以下のようにします。
```
 DataSource.merge(new Person() {
     int    id   = 5;
     String name = "五郎";
 });
 
```
    構築されたMERGE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、MERGE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    パラメータ:
    
    obj - MERGE文を構築するオブジェクト
    
    戻り値:
    
    MERGE文の実行により影響を受けた行数。つまり行の追加または更新が成功した場合は 1 です。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - merge
```
public int[] merge(java.lang.Object... objects)
            throws OptimisticConcurrencyException,
                   java.sql.SQLException,
                   java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してMERGE文を構築し、データソースへ行の追加または更新を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけMERGE文が実行されますが、これらのMERGE文は1つのトランザクションとして実行されます。
    
    MERGE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を更新または追加することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。行を一意に特定するための列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたMERGE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、MERGE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - MERGE文を構築するオブジェクト(複数)
    
    戻り値:
    
    MERGE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合
  - merge
```
public int[] merge(java.util.Collection<?> objects)
            throws OptimisticConcurrencyException,
                   java.sql.SQLException,
                   java.lang.IllegalAccessException
```
    指定された複数のオブジェクトそれぞれに対してMERGE文を構築し、データソースへ行の追加または更新を試みます。
    それぞれのオブジェクトのクラスが異なっていても構いません。
    
    指定されたオブジェクトの数だけMERGE文が実行されますが、これらのMERGE文は1つのトランザクションとして実行されます。
    
    MERGE文を構築するために指定するオブジェクトはPOJOまたはTableオブジェクトです。オブジェクトがTableである場合、Tableのコンストラクタで指定された文字列をテーブル名とします。オブジェクトがTable以外のPOJOである場合はオブジェクトのクラス名をテーブル名とします。オブジェクトのクラスが匿名クラスである場合は、スーパークラスのクラス名をテーブル名とします。このメソッドは単一行を更新または追加することを目的としています。行を一意に特定するためのフィールドが指定されている必要があります。行を一意に特定するための列はテーブルのスキーマに基づいて自動的に決定されます。
    
    構築されたMERGE文が行バージョン列を含む場合、楽観的同時実行制御をおこないます。オブジェクトの取得以降に行バージョン列の値が更新されていた場合、MERGE文によって影響を受ける行数は0になります。これを検出した場合、楽観的同時実行制御違反としてOptimisticConcurrencyExceptionをスローします。
    
    パラメータ:
    
    objects - MERGE文を構築するオブジェクト(複数)
    
    戻り値:
    
    MERGE文の実行により影響を受けた行数。
    
    例外:
    
    OptimisticConcurrencyException - 楽観的同時実行制御例外が発生した場合
    
    java.sql.SQLException - データベースアクセスエラーが発生した場合
    
    java.lang.IllegalAccessException - オブジェクトのフィールドにアクセスできない場合

クラス DataSource.Instance

コンストラクタのサマリー

メソッドのサマリー

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

コンストラクタの詳細

Instance

Instance

Instance

Instance

Instance

Instance

Instance

メソッドの詳細

setSqlExecutionHandler

getSqlExecutionHandler

beginTransaction

beginTransaction

getConnection

getConnection

close

populate

executeQuery

executeQuery

executeQuery

executeQuery

executeUpdate

executeUpdate

executeUpdate

executeUpdate

executeUpdate

executeUpdate

executeUpdate

executeQueryWaitForRows

executeQueryWaitForRows

executeQueryWaitForRows

executeQueryWaitForRows

executeQueryWaitForRows

executeQueryWaitForRows

executeScalar

executeScalar

executeScalar

executeScalar

select

select

select

select

select

select

select

select

selectAsList

selectAsList

selectAsList

selectAsList

selectAsList

selectAsList

selectAsList

insert

insert

insert

update

update

update

delete

delete

delete

merge

merge

merge