Hibernate 5迁移至6：LimitHelper等组件替代方案咨询

1. RowSelection 类替代方案 #

Hibernate 6 移除了RowSelection，改用org.hibernate.query.spi.Limit类处理分页参数。需要将processSql方法的参数替换为Limit，通过该类方法获取分页信息：

原代码：

public String processSql(String sql, RowSelection selection) {
    // 原有处理逻辑
}

替代后：

import org.hibernate.query.spi.Limit;

public String processSql(String sql, Limit limit) {
    boolean hasOffset = limit != null && limit.hasFirstRow();
    int maxRows = limit != null ? limit.getMaxRows() : -1;
    // 适配原有逻辑，使用Limit提供的参数完成SQL处理
    return modifiedSql;
}

2. LimitHelper.hasFirstRow(selection) 替代方案 #

LimitHelper已被移除，直接通过Limit对象自身的方法判断即可：

原代码：

boolean hasOffset = LimitHelper.hasFirstRow(selection);

替代后：

boolean hasOffset = limit != null && limit.hasFirstRow();
// 或者直接判断偏移量数值
boolean hasOffset = limit != null && limit.getFirstRow() > 0;

3. EmptyInterceptor 重写 onPrepareStatement 替代方案 #

EmptyInterceptor已废弃，SQL预处理拦截推荐使用org.hibernate.resource.jdbc.spi.StatementInspector接口，它专门用于处理SQL语句修改逻辑：

原代码：

public class CustomInterceptor extends EmptyInterceptor {
    @Override
    public String onPrepareStatement(String sql) {
        // 修改SQL的逻辑
        return modifiedSql;
    }
}

替代后：

import org.hibernate.resource.jdbc.spi.StatementInspector;

public class CustomStatementInspector implements StatementInspector {
    @Override
    public String inspect(String sql) {
        // 原onPrepareStatement中的逻辑直接迁移到这里
        return modifiedSql;
    }
}

通过配置注册该Inspector，比如在application.properties中：

hibernate.session_factory.statement_inspector=com.yourpackage.CustomStatementInspector

4. Dialect 类 supportsLimit 和 getLimitString 替代方案 #

Hibernate 6 重构了分页逻辑，原Dialect的分页方法被移除，改用LimitHandler接口处理。自定义DruidDialectExtended时，需要重写getLimitHandler()方法返回自定义实现：

原代码：

public class DruidDialectExtended extends Dialect {
    @Override
    public boolean supportsLimit() {
        return true;
    }

    @Override
    public String getLimitString(String sql, boolean hasOffset) {
        // 拼接分页SQL的逻辑
    }
}

替代后：

import org.hibernate.dialect.pagination.LimitHandler;
import org.hibernate.query.spi.Limit;

public class DruidDialectExtended extends Dialect {
    @Override
    public LimitHandler getLimitHandler() {
        return new LimitHandler() {
            @Override
            public boolean supportsLimit() {
                return true; // 原supportsLimit的返回逻辑
            }

            @Override
            public String processSql(String sql, Limit limit) {
                boolean hasOffset = limit != null && limit.hasFirstRow();
                int firstRow = limit != null ? limit.getFirstRow() : 0;
                int maxRows = limit != null ? limit.getMaxRows() : -1;
                // 原getLimitString中的SQL拼接逻辑，适配Limit参数
                return buildPagedSql(sql, firstRow, maxRows);
            }

            // 根据需要实现LimitHandler的其他方法，如bindLimitParameters等
        };
    }
}

内容的提问来源于stack exchange，提问作者Carl