行操作管理

通过执行以下常规任务来管理行操作：

在字符串变量中构造一个 SQL 语句。
通过将字符串变量传递给 Connection.prepareStatement 方法，创建一个 PreparedStatement 对象。
使用 PreparedStatement.set 方法设置用 ? 字符表示的任意主机变量。

可根据各个主机变量在语句中的顺序位置对其进行引用。例如，第一个 ? 引用为 1，第二个引用为 2。通过 set 方法（在下面的示例中进行说明）可对变量的顺序位置进行引用，并指定一个新值。
调用 PreparedStatement.execute 方法以在数据库上执行操作。
要使更改成为永久更改，调用 Connection.commit 方法以提交对数据库的更改；否则，调用 Connection.rollback 方法。

必须使用 Connection 接口支持的方法显式地提交或回退事务。
关闭 PreparedStatement 对象以释放资源。

示例

本示例中所引用的代码属于一个完整示例的一部分，该完整示例说明了如何使用 UltraLiteJ 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);
    }
}

注意

在构造只需要执行一次的 SQL 语句时，建议对主机变量用法进行字符串连接。

例如，以下代码使用字符串连接构造 SQL 语句，可使用这些代码来替换 DeleteDepartment 方法：

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讨论此页。