Jdbi提供了对Java中关系数据的方便的访问。Jdbi 3是第三个主要版本，它引入了对Java 8的增强支持，对设计和实现的无数改进，以及对模块化插件的增强支持。
Jdbi构建于JDBC之上。如果您的数据库有JDBC驱动程序，则可以使用Jdbi。Jdbi改进了JDBC的粗略接口，提供了更加自然的Java数据库接口，可以轻松绑定到您的域数据类型。与ORM不同，我们的目标不是提供完整的对象关系映射框架 – 而是将复杂性隐藏，我们提供构建块，允许您根据应用程序构建关系和对象之间的映射。
Jdbi的API有两种形式：
1.1 流畅风格的API
Core API提供了流畅的接口。使用Builder对象将SQL连接到丰富的Java数据类型。
Jdbi jdbi = Jdbi.create("jdbc:h2:mem:test"); // (H2 in-memory database)
List<User> users = jdbi.withHandle(handle -> {
handle.execute("CREATE TABLE user (id INTEGER PRIMARY KEY, name VARCHAR)");
// Inline positional parameters
handle.execute("INSERT INTO user(id, name) VALUES (?, ?)", 0, "Alice");
// Positional parameters
handle.createUpdate("INSERT INTO user(id, name) VALUES (?, ?)")
.bind(0, 1) // 0-based parameter indexes
.bind(1, "Bob")
.execute();
// Named parameters
handle.createUpdate("INSERT INTO user(id, name) VALUES (:id, :name)")
.bind("id", 2)
.bind("name", "Clarice")
.execute();
// Named parameters from bean properties
handle.createUpdate("INSERT INTO user(id, name) VALUES (:id, :name)")
.bindBean(new User(3, "David"))
.execute();
// Easy mapping to any type
return handle.createQuery("SELECT * FROM user ORDER BY name")
.mapToBean(User.class)
.list();
});
assertThat(users).containsExactly(
new User(0, "Alice"),
new User(1, "Bob"),
new User(2, "Clarice"),
new User(3, "David"));
- 核心是获取一个Jdbi对象，通过静态方法create创建
- handle的方法：执行，创建sql
- 输入的方式：序号，id，绑定对象
- 输出的方式：map到一个对象
1.2 声明式API
SQL Object基于Core上扩展，并提供声明性接口。通过声明带注释的Javainterface，告诉Jdbi执行哪些SQL以及您希望的结果的形状，它将提供该接口的实现。
// 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();
}
Jdbi jdbi = Jdbi.create("jdbc:h2:mem:test");
jdbi.installPlugin(new SqlObjectPlugin());
// Jdbi implements your interface based on annotations
List<User> userNames = jdbi.withExtension(UserDao.class, dao -> {
dao.createTable();
dao.insertPositional(0, "Alice");
dao.insertPositional(1, "Bob");
dao.insertNamed(2, "Clarice");
dao.insertBean(new User(3, "David"));
return dao.listUsers();
});
assertThat(userNames).containsExactly(
new User(0, "Alice"),
new User(1, "Bob"),
new User(2, "Clarice"),
new User(3, "David"));
Jdbi具有灵活的插件架构，可以轻松支持您喜欢的库（Guava，JodaTime，Spring，Vavr）或数据库供应商（H2，Oracle，Postgres）。
Jdbi不是ORM，没有会话缓存，更改跟踪，“在视图中打开会话”。相反，Jdbi提供了SQL和简单表格数据结构之间的直接映射。
你写好SQL，Jdbi只运行你告诉它的命令。
