Jdbi3官方教程(一) 简介

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只运行你告诉它的命令。

    原文作者:程序员文集
    原文地址: https://www.jianshu.com/p/2d8e9550f650
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞