怎么选择

一般情况下，如果始终只会使用到一种数据库，jdbc 就是最好的选择了，使用这种方式，就是直接使用最底层的东西，定位问题等都非常方便。
数据库中间件就是节省开发人力，用很少的代码就可以快速开发。但是也会引入一些复杂度，特别是如果对中间件不熟悉或者中间件存在 bug，会导致更高复杂度。
如果使用数据库中间件，各种中间件都有各自的优劣势，对于相关的东西需要了解清楚，否则会导致不恰当的选择。

jdbi

jdbi 是我比较喜欢的一个数据库中间件，它是非 ORM 的，特别适合于数据库固定不变的场景，即不会对应多种数据库，以后也不会更换数据库的场景。如果不是这种场景，那么使用 jdbc 或者最好选择 hibernate 等对多种数据库兼容较好的中间件。基于上述使用场景，jdbi 的优点有：

和 jdbci 比较接近，使用和掌握非常简单。
与时俱进，例如说现在最新的 jdbi3，增加了流式编程函数式等编程风格。
源代码的实现思路非常清晰，有一种美感。使用 jdbi 封装出的数据库代码也非常清晰。

jdbi 的两种风格

Fluent Api

handle.createUpdate ("INSERT INTO user (id, name) VALUES (:id, :name)")
  .bind ("id", 2)
  .bind ("name", "Clarice")
  .execute ();
复制代码

这里就是 java8 的流式风格，用连贯式表达式将一个 sql 实现串在一起

Declarative Api

// Define your own declarative interface
public interface UserDao {
    @SqlUpdate ("CREATE TABLE user (id INTEGER PRIMARY KEY, name VARCHAR)")
    void createTable ();

    @SqlUpdate ("INSERT INTO user (id, name) VALUES (?, ?)")
    void insertPositional (int id, String name);

    @SqlUpdate ("INSERT INTO user (id, name) VALUES (:id, :name)")
    void insertNamed (@Bind ("id") int id, @Bind ("name") String name);

    @SqlUpdate ("INSERT INTO user (id, name) VALUES (:id, :name)")
    void insertBean (@BindBean User user);

    @SqlQuery ("SELECT * FROM user ORDER BY name")
    @RegisterBeanMapper (User.class)
    List<User> listUsers ();
}
复制代码

声明式的主要是使用注解来实现，在实际的面向对象风格的代码中，我个人觉得声明式的比较简洁，容易阅读和维护。所以下面都按照 Declarative Api 的方式。

一些关键性的问题

对于 jdbi 的实现，需要自己去看 jdbi 的主页，jdbi.org/，这里讲一些实际使用中…

返回自动递增的主键

jdbc 方式怎么做的呢？

try {
  Connection conn = DBUtil2.getConnection ();
  //PreparedStatement ps = 
  //      conn.prepareStatement (SAVE_SQL, new String [] { "id" });
  // 应该返回生成的主键，上下两种方式都可
  PreparedStatement ps = conn.prepareStatement (SAVE_SQL,PreparedStatement.RETURN_GENERATED_KEYS);
  ps.setString (1, user.getName ());
  ps.setFloat (2, user.getSalary ());
  ps.setInt (3, user.getAge ());
  if (ps.executeUpdate () > 0) {
    // 获取主键
    ResultSet rs = ps.getGeneratedKeys ();
    rs.next ();
    int i = rs.getInt (1);
    user.setId (i);
    ps.close ();
    return true;
  }
  ps.close ();
} catch (SQLException e) {
  e.printStackTrace ();
} finally {
  DBUtil2.closeConnection ();
}
复制代码

jdbi 提供的机制：

public interface UserDao {
    @SqlBatch ("INSERT INTO users (name) VALUES (?)")
    @GetGeneratedKeys
    List<User> createUsers (String... names);
}
复制代码

非常直观简洁

查询

jdbc 方式，我们在查询大数据量时，一般使用数据库游标，逐条查询。 jdbi 的查询是什么样的呢？如下：

public interface UserDao {
  @SqlQuery ("select name from users")
  List<String> listNames ();  
}
复制代码

但是这个时候，如果遇到大数据量怎么办，jdbi 提供的解决方案：

public interface UserDao {
  @SqlQuery ("select name from users")
  ResultIterator<String> getNamesAsIterator ();
}
复制代码

这里使用了迭代器，依次去查询，和 jdbi 游标的作用是一样的。

批量插入

jdbi 的插入，当一个列表插入，如果要提升效率，就是拆分插入，拆分插入 jdbi 提供了机制 SqlBatch

public interface UserDao {
  @SqlBatch ("insert into users (tenant_id, id, name)" + "values (:tenantId, :user.id, :user.name)")
  void bulkInsert (@Bind ("tenantId") long tenantId, 
                  @BindBean ("user") User... users);
}
复制代码

小结

jdbi 是非常简洁优美的数据库中间件组件，当在数据库唯一特别是 pg 数据库，个人认为是首选方式，有效的把 jdbc 封装了一下，更加适合于开发。

资源后花园：gitee.com/alterem/pic…

数据库中间件-jdbi