一个简单的JDBC包装器(2)
一个完整的示例
现在我们已经看过了所有的类,让我们来看一个完整的示例吧。在清单 4 中,我们将抽取出符合特定条件的一套记录,然后打印出它们的值。
清单 4. 一个读取数据的完整示例
// First, get all rows meeting the criterion
RowSet rs = table.getRows( "id<103" );
// Iterate through the set
for (int i=0; i<rs.length(); ++i) {
// Grab each row in turn
Row row = rs.get( i );
// Get and print the value of the "name" field
String name = row.get( "name" );
System.out.println( "Name: "+name );
}
如此轻易!在下一节中,我们将看看怎样向数据库写入数据。
修改数据
正如前面所提到的,使用我们的 API 读写数据是以整个行为单位的。为了向数据库写入数据,您必须创建(或修改)Row 对象,然后向数据库写入那个 Row 对象。
向数据库写入数据是通过使用 Table 中的 putRow 方法。这种方法有两种变体:
public void putRow( Row row )
public void putRow( Row row, String conditions )
这两种变体分别对应于 SQL 中的 INSERT 和 UPDATE 命令。
在第一个变体中,写一行意味着将一个全新的行插入表中。
在第二个变体中,写一行意味着修改一个现有的行。conditions 参数使您能够指定您想要修改的是哪一行(哪些行)。
让我们来看看每种方法的一个示例。
插入一个新行
插入一个新行很简单,因为您不必指定要修改的行(一行或多行)。您只是简单地把行插入:
table.putRow( row );
您可以重新创建一个 Row,如清单 5 所示。
清单 5. 重新创建一个 Row
// Create an empty row object
Row row = new Row();
// Fill it up with data
row.put( "id", "200" );
row.put( "name", "Joey Capellino" );
或者,您可以修改一个以前曾经从数据库中读取的一个现有的行,如清单 6 所示。
清单 6. 修改现有的 Row
// Grab a row from the database
Row row = table.getRow( someConditions );
// Change some or all of the fields
row.put( "name", "Joey Capellino" );
虽然通常是在插入时重新创建 Row,更新时使用现有的 Row,实际上您可以用任何方式来进行。
更新现有的行
正如前面的部分提到的,对于您如何创建用来更新的 Row 是没有限制的。 但是,通常您是使用一个刚从数据库中读出的 Row。
为了具体描述这一点,我们将使用一个示例(在该例子中我们读出一个员工的姓名),改变这个名字,然后将更改后的结果写回数据库,如清单 7 所示。
清单 7. 通过修改 Row 进行更新
Row row = table.getRow( "id=104" );
row.put( "name", newName );
table.putRow( row, "id=104" );
注重我们必须在调用 putRow() 中指定条件。这样才会使调用成为更新,而不是插入。
注重,这个调用将更新所有符合条件的行,而不是其中的一行。
结论
在本文中,我们初步熟悉了一种通过 JDBC 包提供一种简化的通往关系型数据库接口的 API。这种抽象保留了 JDBC 接口的很多基本关系型功能,但对其进行了简化,从而让使用非常地方便。这种简化是以效率为代价的,但当目标是简单性时,这并不是一个令人惊异的结果。
参考资料
参加本文的讨论论坛。
下载本文中讨论的类的全部资料:
Database.Java
Table.java
RowSet.java
Row.java
JDBC 学习中心包含许多教程的链接。
阅读 JDBC 文档页可以获得很多有用的文档的链接。
您可以在 Amazon 购买 《JDBC API 教程和参考大全》,第 2 版,或者只是阅读它。
免费数据库清单包含许多免费 RDBMS 软件包的链接,您可以在启用 JDBC 的程序的服务器端使用。