如何从 JDBI3 中的 SQL-Object 映射 SQLException

问题描述

假设我将表定义为:

CREATE TABLE ITEMS(
  ID BIGINT PRIMARY KEY,NAME VARCHAR2,CONSTRAINT NAME_IS_UNIQUE UNIQUE (NAME)
);

重要的部分是 NAME_IS_UNIQUE 约束。

对应的POJO项为:

class Item{
  private Long id;
  private String name;
  /** getters and setters */
}

sql-Object 接口,方法定义为:

@sqlUpdate("insert into items(id,name) values(:id,:name)")
int insert(@BindBean Item itemToInsert);

如果我尝试使用已经存在的 NAME 插入到 ITEMS 中,那么我将收到有关违反约束 NAME_IS_UNIQUE 的数据库供应商特定的 sqlException。

有没有办法在 sqlException 和特定于应用程序的异常(例如 ItemNameUniqueConstraintException)之间提供映射,所以 insert 方法本质上将其签名更改为如下所示的内容

@sqlUpdate("insert into items(id,:name)")
int insert(@BindBean Item itemToInsert) throws ItemNameUniqueConstraintException;

问题不是关于特定的 UNIQUE 约束,而是更多关于一般情况,其中 sqlException 可以是任何事情:比如违反参照完整性或违反检查约束等。

解决方法

目前不支持处理 SQLException -> ApplicationException 映射的方式,您可以阅读 issue 中的讨论和推理。

但是您可以使用 default 方法的解决方法并手动处理异常,例如:

    class ItemNameUniqueConstraintException extends Exception {
        public ItemNameUniqueConstraintException(String message,Throwable cause) {
            super(message,cause);
        }
    }

    interface Repository {
        default void insert(String name) throws ItemNameUniqueConstraintException {
            try {
                _insert(name);
            } catch (JdbiException e) {
                if (e.getCause() instanceof SQLException) {
                    var cause = (SQLException) e.getCause();
                    if (cause.getSQLState().equals("11111")) {
                        throw new ItemNameUniqueConstraintException("Name not unique.",cause);
                    }
                }
                // ...
            }
        }
        @SqlUpdate("INSERT INTO test (name) VALUES (:name)")
        void _insert(@Bind("name") String name);
    }

它不是很漂亮,但可以通过单独的存储库契约和 JDBI 实现接口来改进,这可以允许不向调用者公开 _insert 和类似方法。