データベース コントロール メソッドから単一の値を返す
このトピックでは、データベース コントロールに追加でき、データベースから単一の値を返す INSERT、UPDATE、および 単一値の SELECT 文などのメソッドについて説明します。
データベース コントロールの詳細については、データベース コントロール : Web サービスからデータベースを使用するを参照してください。
データベース コントロールの作成方法については、新しいデータベース コントロールを作成するを参照してください。
単一の値を返すデータベース処理の例としては、影響する行の数を返す INSERT および UPDATE 処理や、単一の行の単一のカラムのみを要求する SELECT 文があります。これらのケースでは、メソッドの戻り値は適切な型のオブジェクトまたはプリミティブとなります。
次の例では、UPDATE 処理が実行され、影響を受ける行の数が返されます。
/**
* @jws:sql statement="UPDATE customer SET address={customerAddr} WHERE custid={customerID}"
*/
public int setCustomerAddress(int customerID, String customerAddr);
この例は customer テーブルを更新します。custid フィールドが customerID パラメータの値と一致するテーブル内の各レコードに関して、address フィールドが customerAddr パラメータの値に設定されます。
次の例では、単一行の単一カラムが返されます。ただし、custid が customer テーブルの主キーであるものとします。フィールドの型は VARCHAR なので、戻り値は String です。
/**
* @jws:sql statement="SELECT name FROM customer WHERE custid={customerID}"
*/
public String getCustomerName(int customerID);
データベースの型と Java の型との関係については、データベース コントロールでデータベース フィールドの型を Java の型にマップするを参照してください。