如何在 JDBI3 中映射来自 SQL-Object 的 SQLException

How to map SQLException from SQL-Object in JDBI3

假设我将 table 定义为:

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

重要的部分是NAME_IS_UNIQUE约束。

对应的POJO Item为:

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

和SQL-对象接口的方法定义为:

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

如果我尝试使用现有的 NAME 插入 ITEMS,那么我将得到数据库供应商特定的 SQL关于约束 NAME_IS_UNIQUE 违规的异常。

有没有一种方法可以在 SQLException 和特定于应用程序的 Exception(例如 ItemNameUniqueConstraintException)之间提供映射,所以 insert 方法基本上将其签名更改为如下所示?

@SqlUpdate("insert into items(id, name) values(: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 和类似的方法。