10.3.1　应对失控的 JDBC 代码

如果使用 JDBC 所提供的直接操作数据库的 API，你需要负责处理与数据库访问相关的所有事情，其中包含管理数据库资源和处理异常。如果你曾经使用 JDBC 往数据库中插入数据，那如下代码对你应该并不陌生：

程序清单 10.4　使用 JDBC 在数据库里插入一行数据

private static final String SQL_INSERT_SPITTBR =
  "insert into spitter (username, password, fullname) values (?, ?, ?)";
private DataSource dataSource; 
public void addSpitter(Spitter spitter) {
  Connection conn = null;
  PreparedStatement stmt = null; 
  try {
    conn = dataSource.getConnection();
    stmt = conn.prepareStatement(SQL_INSERT_SPITTER);
    stmc.setstring(1, spicter.getUsername());
    stmt.setstring(2, spitter.getPassword());
    stmt.setstring(3, spitter .getFullName());
    stmt.execute();
  } catch (SQLException e) {
    // do something...not sure what, though
  } finally {
    try {
      if (stmt != null) {
        stmt.close();
      }
      
      if (conn != null) {
        conn.close();
      }
    } catch (SQLException e) {
      // I'm even less sure about what to do here
    }
  }
}

看看这些失控的代码！这个超过 20 行的代码仅仅是为了向数据库中插入一个简单的对象。对于 JDBC 操作来讲，这应该是最简单的了。但是为什么要用这么多行代码才能做如此简单的事情呢？实际上，并非如此，只有几行代码是真正用于进行插入数据的。但是 JDBC 要求你必须正确地管理连接和语句，并以某种方式处理可能抛出的 SQLException 异常。

再提一句这个 SQLException 异常：你不但不清楚如何处理它（因为并不知道哪里出错了），而且你还要捕捉它两次！你需要在插入记录出错时捕捉它，同时你还需要在关闭语句和连接出错的时候捕捉它。看起来我们要做很多的工作来处理可能出现的问题，而这些问题 通常是难以通过编码来处理的。

再来看一下如下程序清单中的代码，我们使用传统的 JDBC 来更新数据库中 Spitter 表的一行。

程序清单 10.5 使用 JDBC 更新数据库中的一行

private static final String SQL_UPDATE_SPITTER =
  "update spitter set username = ?, password = ?, fullname= ?" +
  "where id = ?";
public void saveSpitter(Spitter spitter) {
  Connection conn = null;
  PreparedStatement stmt = null;
  try {
    conn = dataSource.getConnection();
    stmt = conn.prepareStatement(SQL_UPDATE_SPITTER);
    stmt.setString(1, spitter .getUsername());
    stmt.setString(2, spitter.getPassword());
    stmt.setString(3, spitter.getFullName());
    stmt.setLong(4, spitter.getld());
    stmt.execute();
  } catch (SQLException e) {
    // Still not sure what I
  } finally {
    try {
      if (stmt != null) {
        stmt.close();
      }
      
      if (conn != null) {
        conn.close();
      }
    } catch (SQLException e) {
      // or here
    }
  }
}

乍看上去，程序清单 10.5 和 10.4 是相同的。实际上，除了 SQL 字符串和创建语句的那一行，它们是完全相同的。同样，这里也使用大量代码来完成一件简单的事情，而且有很多重复的代码。在理想情况下，我们只需要编写与特定任务相关的代码。毕竟，这才是程序清单10.5 和 10.4 的不同之处，剩下的都是样板代码。

为了完成对 JDBC 的完整介绍，让我们看一下如何从数据库中获取数据。如下所示，它也不简单。

程序清单 10.6　使用 JDBC 从数据库中查询一行数据

private static final String SQL_SELECT_SPITTER =
  "select id, username, fullname from spitter where id = ?";
public void findOne(long id) {
  Connection conn = null;
  PreparedStatement stmt = null;
  ResultSet rs = null;
  try {
    conn = dataSource.getConnection();
    stmt = conn.prepareStatement(SQL_SELECT_SPITTER);
    stmt.setLong(1, id);
    rs = stmt.executeQuery();
    Spitter spitter = null;
    if (rs.next()) {
      spitter = new Spitter();
      spitter.setId(rs.getLong("id"));
      spitter.setUsername(rs.getString("username"));
      spitter.setFullName(rs.getString("fullname"));
    }
    return spitter;
  } catch (SQLException e) {
    // Still not sure what I
  } finally {
    if (rs != null) {
      try {
        rs.close();
      } catch (SQLException e) {
      }
    }
    
    if (stmt != null) {
      try {
        stmt.close();
      } catch (SQLException e) {
      }
    }
    
    if (conn ! = null) {
      try {
        conn.close();
      } catch (SQLException e) {
      }
    }
  }
}

这段代码与插入和更新的样例一样冗长，甚至更为复杂。这就好像 Pareto 法则被倒了过来：只有 20% 的代码是真正用于查询数据的，而 80% 代码都是样板代码。

现在你可以看出，大量的 JDBC 代码都是用于创建连接和语句以及异常处理的样板代码。既然已经得出了这个观点，我们将不再接受它的折磨，以后你再也不会看到这样令人厌恶的代码了。

但实际上，这些样板代码是非常重要的。清理资源和处理错误确保了数据访问的健壮性。如果没有它们的话，就不会发现错误而且资源也会处于打开的状态，这将会导致意外的代码和资源泄露。我们不仅需要这些代码，而且还要保证它是正确的。基于这样的原因，我们才需要框架来保证这些代码只写一次而且是正确的。