ロー操作の管理

次の一般的なタスクを実行して、ロー操作を管理します。

文字列変数に SQL 文を作成します。
文字列変数を Connection.prepareStatement メソッドに渡して PreparedStatement オブジェクトを作成します。
ホスト変数を設定します (? 文字で表し、PreparedStatement.set メソッドを使用します)。

各ホスト変数は文内の位置を表す序数で参照できます。たとえば、最初の ? は 1 として、2 番目は 2 として参照されます。下記の例に示されている set メソッドでは、変数の位置を表す序数を参照し、新しい値を指定できます。
PreparedStatement.execute メソッドを呼び出してデータベースの操作を実行します。
Connection.commit メソッドを呼び出してデータベースへの変更をコミットし、永続的な変更にするか、または Connection.rollback メソッドを呼び出します。

トランザクションは、Connection インタフェースでサポートされているメソッドを使用して明示的にコミットまたはロールバックする必要があります。
PreparedStatement オブジェクトを閉じてリソースを解放します。

例

この例に示したコードは、Ultra Light J API を使用してスキーマやデータを管理する基本操作を実行する方法を紹介している完全なコードサンプルの一部です。例：Android スマートフォンに対するデータベース操作の管理を参照してください。

グローバルの PreparedStatement オブジェクトが定義され、InitStatements メソッドの呼び出しによってインスタンス化されます。データの挿入、更新、削除の操作はそれぞれ、AddDepartment、UpdateDepartment、DeleteDepartment のカスタムメソッドで実行されます。Commit メソッドはロー操作を永続的なものにします。FiniStatements メソッドは、グローバルの PreparedStatement オブジェクトを閉じて、リソースを解放します。

Connection _conn = null;
ResultSet _departments = null;
PreparedStatement _inserter = null;
PreparedStatement _updater = null;
PreparedStatement _deleter = null;
PreparedStatement _preparer = null;

public void InitStatements() {
    String stmt;
    try {
        stmt = "INSERT INTO Department(dept_no, name) VALUES (?,?)";
        _inserter = _conn.prepareStatement(stmt);
        stmt = "UPDATE Department SET dept_no = ? WHERE dept_no = ?";
        _updater = _conn.prepareStatement(stmt);
        stmt = "DELETE FROM Department WHERE dept_no = ?";
        _deleter = _conn.prepareStatement(stmt);
    } catch (ULjException e) {
        HandleError(e);
    }
}

public void FiniStatements() {
    try {
        _departments.close();
        _inserter.close();
        _updater.close();
        _deleter.close();
        _preparer.close();
    } catch (ULjException e) {
        HandleError(e);
    }
}

public void AddDepartment(int deptID, String deptName) {
    try {
        _inserter.set(1, deptID);
        _inserter.set(2, deptName);
        _inserter.execute();
        PrintText("Successfully executed:"
                + " INSERT INTO Department(dept_no, name)" 
                + " VALUES (" + deptID + "," + deptName + ")");
    } catch (ULjException e) {
        HandleError(e);
    }
}

public void UpdateDepartment(int deptIDold, int deptIDnew) {
    try {
        _updater.set(1, deptIDnew);
        _updater.set(2, deptIDold);
        _updater.execute();
        PrintText("Successfully executed:"
                + " UPDATE Department SET dept_no = " + deptIDnew 
                + " WHERE dept_no = " + deptIDold);
    } catch (ULjException e) {
        HandleError(e);
    }
}

public void DeleteDepartment(int deptID) {
    try {
        _deleter.set(1, deptID);
        _deleter.execute();
        PrintText("Successfully executed:"
                + " DELETE FROM Department WHERE dept_no = " + deptID);
    } catch (ULjException e) {
        HandleError(e);
    }
}

public void Commit() {
    try {
        _conn.commit();
    } catch (ULjException e1) {
        HandleError(e1);
    }
}

注意

1 回しか実行する必要のない SQL 文を作成する場合は、ホスト変数に文字列連結を利用することをおすすめします。

たとえば、次のコードは、DeleteDepartment メソッドの置換に使用できるコードですが、文字列連結で SQL 文が作成されています。

public void DeleteDepartment(int deptID) {
    String stmt = "DELETE FROM Department WHERE dept_no = " + deptID;
    PreparedStatement deleter;
    try {
        deleter = _conn.prepareStatement(stmt);
        deleter.execute();
        deleter.close();
        PrintText("Successfully executed: " + stmt);
    } catch (ULjException e) {
        HandleError(e);
    }
}

参照

DocCommentXchange で意見交換できます