ＲｅｓｕｌｔＳｅｔ インタフェース

[内容]

　　SQL 文の実行結果から得られる結果の集まりです

[主なメソッド]

• public boolean absolute(int row) throws SQLException
  カーソルをこの ResultSet オブジェクト内の指定された行に移動する

• public void afterLast() throws SQLException
  カーソルをこの ResultSet オブジェクトの終端，つまり最終行の直後に移動する

• public void beforeFirst() throws SQLException
  カーソルをこの ResultSet オブジェクトの先端，つまり先頭行の直前に移動する

• public void cancelRowUpdates() throws SQLException
  この ResultSet オブジェクトの現在の行に対して行った更新を取り消す

• public void deleteRow() throws SQLException
  この ResultSet オブジェクトおよび基になるデータベースから，現在の行を削除する

• public boolean first() throws SQLException
  カーソルを ResultSet オブジェクト内の先頭行に移動する

• public Date getDate(int columnIndex) throws SQLException
• public Date getDate(int columnIndex, Calendar cal) throws SQLException
• public Date getDate(String columnName) throws SQLException
• public Date getDate(String columnName, Calendar cal) throws SQLException
  この ResultSet オブジェクトの現在行にある指定された列の値を，Java プログラミング言語の java.sql.Date オブジェクトとして取得する．Calender 引数を指定すると，基になるデータベースがタイムゾーン情報を格納していない場合，このメソッドは指定されたカレンダを使って日付に適切なミリ秒値を作成する．

• public double getDouble(int columnIndex) throws SQLException
• public double getDouble(String columnName) throws SQLException
  現在行にある指定された列の値を，double として取得する．columnIndex において，最初の列は 1 となる．

• public int getInt(int columnIndex) throws SQLException
• public int getInt(String columnName) throws SQLException
  現在行にある指定された列の値を，int として取得する．columnIndex において，最初の列は 1 となる．

• public long getLong(int columnIndex) throws SQLException
• public long getLong(String columnName) throws SQLException
  現在行にある指定された列の値を，long として取得する．columnIndex において，最初の列は 1 となる．

• public ResultSetMetaData getMetaData() throws SQLException
  ResultSet オブジェクトの列の数，型，およびプロパティを取得

• public int getRow() throws SQLException
  現在の行の番号を取得する．最初の行が 1，2 番目は 2，などとなる．

• public String getString(int columnIndex) throws SQLException
• public String getString(String columnName) throws SQLException
  現在行にある指定された列の値を，String として取得する．columnIndex において，最初の列は 1 となる．

• public Time getTime(int columnIndex) throws SQLException
• public Time getTime(int columnIndex, Calendar cal) throws SQLException
• public Time getTime(String columnName) throws SQLException
• public Time getTime(String columnName, Calendar cal) throws SQLException
  この ResultSet オブジェクトの現在行にある指定された列の値を，Java プログラミング言語の java.sql.Time オブジェクトとして取得する．Calender 引数を指定すると，基になるデータベースがタイムゾーン情報を格納していない場合，このメソッドは指定されたカレンダを使って日付に適切なミリ秒値を作成する．

• public void insertRow() throws SQLException
  挿入行の内容を，この ResultSet オブジェクトおよびデータベースに挿入する．具体的には，以下のような方法で，行を挿入できる．

  Statement stmt = con.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE);
  ResultSet rs = stmt.executeQuery("SELECT * FROM TABLE2");
  rs.moveToInsertRow(); // moves cursor to the insert row
  rs.updateString(1, "AINSWORTH"); // updates the first column of the insert row to be AINSWORTH
  rs.updateInt(2,35); // updates the second column to be 35
  rs.updateBoolean(3, true); // updates the third row to true
  rs.insertRow();
  rs.moveToCurrentRow();
  			

• public boolean last() throws SQLException
  カーソルをこの ResultSet オブジェクト内の最終行に移動する

• public void moveToCurrentRow() throws SQLException
  カーソルを，記憶されているカーソル位置 (通常は現在の行) に移動する．このメソッドは，カーソルが挿入行にある場合以外は無効となる．

• public void moveToInsertRow() throws SQLException
  カーソルを挿入行に移動する．カーソルが挿入行に位置決めされている間，現在のカーソル位置は記憶されている．挿入行は更新可能な結果セットに関連した特殊な行である．実質的には，行を結果セットに挿入する前に updater メソッドを呼び出すことによって新しい行が作成されるバッファである．カーソルが挿入行にあるときに呼び出すことができるのは，updater，getter，および insertRow の各メソッドだけである．insertRow を呼び出す前にこのメソッドを呼び出すと，そのたびに結果セット内のすべての列に値を設定する必要がある．列値で getter メソッドを呼び出すには，その前に updater メソッドを呼び出す必要がある．

• public boolean next() throws SQLException
  結果セットの現在行を 1 行進める

• public boolean previous() throws SQLException
  カーソルをこの ResultSet オブジェクト内の前の行に移動する

• public void updateDate(int columnIndex, Date x) throws SQLException
• public void updateDate(String columnName, Date x) throws SQLException
  指定された列を java.sql.Date 値で更新する

• public void updateDouble(int columnIndex, double x) throws SQLException
• public void updateDouble(String columnName, double x) throws SQLException
  指定された列を double 値で更新する

• public void updateInt(int columnIndex, int x) throws SQLException
• public void updateInt(String columnName, int x) throws SQLException
  指定された列を int 値で更新する

• public void updateLong(int columnIndex, long x) throws SQLException
• public void updateLong(String columnName, long x) throws SQLException
  指定された列を long 値で更新する

• public void updateNull(int columnIndex) throws SQLException
• public void updateNull(String columnName) throws SQLException
  null を許す列に null 値を設定する

• public void updateRow() throws SQLException
  基になるデータベースを，この ResultSet オブジェクトの現在の行の新しい内容に更新する．具体的には，以下のような方法で，行を更新できる．

  Statement stmt = con.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE, ResultSet.CONCUR_UPDATABLE);
  ResultSet rs = stmt.executeQuery("SELECT * FROM TABLE2");
  rs.absolute(5); // moves the cursor to the fifth row of rs
  rs.updateString("NAME", "AINSWORTH"); // updates the NAME column of row 5 to be AINSWORTH
  rs.updateRow(); // updates the row in the data source
  			

• public void updateString(int columnIndex, String x) throws SQLException
• public void updateString(String columnName, String x) throws SQLException
  指定された列を String 値で更新する

• public void updateTime(int columnIndex, Time x) throws SQLException
• public void updateTime(String columnName, Time x) throws SQLException
  指定された列を java.sql.Time 値で更新する

[使用例]

1. プログラム例は，サーバ cs-www にある MySQL のデータベースへ JDBC を使用して接続し，データベースを作成，選択，および，削除した例です．

2. プログラム例は，サーバ cs-www にある MySQL のデータベースへ JDBC を使用して接続し，テーブルを作成した例です．このプログラムを実行すると以下のような出力が得られます．

   Tables_in_base
        gakuseki
   Field, Type, Null, Key, Default, Extra
        No, int(9), , PRI, 0,
        name, varchar(50), , , ,
        math, int(3), YES, , null,
   			

3. プログラム例は，サーバ cs-www にある MySQL のデータベースへ JDBC を使用して接続し，作成したテーブルにデータを読み込ませた例です．テーブルへデータを読み込む方法として，二つの方法があります．一つは，ファイルから読み込む方法です．ファイルから読み込む場合は，1 行に 1 レコードの形式でタブで区切った値を記述したテキストファイルを作成します．このプログラムでは，次に示す２つのファイル「test1.txt」と「test2.txt」を使用しています．ファイル「test2.txt」には，ファイル「test1.txt」と同じキーのデータが含まれていますが，このデータは無視されます．

   test1.txt
   　　111111111	山田	10
   　　555555555	佐藤	50
   test2.txt
   　　222222222	鈴木	20
   　　333333333	山本	30
   　　111111111	山田	10
   			

   　　あと一つの方法は，INSERT コマンドを利用する方法です．INSERT コマンドの場合は，既にあるデータと同じキーのデータを入力するとエラーになってしまいます．このプログラムを実行すると以下のような出力が得られます．

   No, name, math
        111111111, 山田, 10
        555555555, 佐藤, 50
   No, name, math
        111111111, 山田, 10
        555555555, 佐藤, 50
        222222222, 鈴木, 20
        333333333, 山本, 30
   No, name, math
        111111111, 山田, 10
        555555555, 佐藤, 50
        222222222, 鈴木, 20
        333333333, 山本, 30
        444444444, 杉山, 40
   			

   プログラム例は，サーバ cs-www にある MySQL のデータベースへ JDBC を使用して接続し，テーブル内のレコードの削除，データの修正，および，レコードの挿入を行った例です．このような処置を行う場合，以下の点に注意してください．

   1. 「USE データベース名」の効果がないので，実際に使用するデータベースで接続する必要がある．
      Con = DriverManager.getConnection("jdbc:mysql://cs-www/base?" +
      "useUnicode=true&characterEncoding=sjis", "xxxxx", "*****");
   2. Statementオブジェクトの定義方法（コンストラクタの引数）
      Statement SQL = Con.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE,
      ResultSet.CONCUR_UPDATABLE);

   削除前：
   No, name, math
        111111111, 山田, 10
        555555555, 佐藤, 50
        222222222, 鈴木, 20
        333333333, 山本, 30
        444444444, 杉山, 40
   削除後：
   No, name, math
        111111111, 山田, 10
        555555555, 佐藤, 50
        444444444, 杉山, 40
   修正，挿入後：
   No, name, math
        111111111, 山田, 100
        555555555, 佐藤, 50
        999999999, 小川, 88
        444444444, 杉山, 90
   			

   プログラム例は，サーバ cs-www にある MySQL のデータベースへ JDBC を使用して接続し，テーブル内のカラムの追加，および，削除を行った例です．このような処置を行う場合，以下の点に注意してください．

   1. 「USE データベース名」の効果がないので，実際に使用するデータベースで接続する必要がある．
      Con = DriverManager.getConnection("jdbc:mysql://cs-www/base?" +
      "useUnicode=true&characterEncoding=sjis", "xxxxx", "*****");
   2. Statementオブジェクトの定義方法（コンストラクタの引数）
      Statement SQL = Con.createStatement(ResultSet.TYPE_SCROLL_INSENSITIVE,
      ResultSet.CONCUR_UPDATABLE);

   追加前：
   No, name, math
        222222222, 鈴木, 20
        333333333, 山本, 30
        111111111, 山田, 10
   カラムの追加後：
   No, name, math
        222222222, 鈴木, null, 20
        333333333, 山本, null, 30
        111111111, 山田, null, 10
   カラムの削除後：
   No, name, math
        222222222, 鈴木, 20
        333333333, 山本, 30
        111111111, 山田, 10
   			

[参照]

DriverManager,　Connection,　PreparedStatement,　Statement,　ResultSetMetaData