如何在JdbcCursorItemReader中读取非String类型的JobParameters

要在JdbcCursorItemReader中使用非String类型的JobParameters（如Long、Date），核心是绕过默认的字符串转换逻辑，直接从JobParameters中提取原始类型值并绑定到PreparedStatement。以下是两种可行方案：

方案一：自定义PreparedStatementSetter手动绑定参数 #

直接实现PreparedStatementSetter接口，在其中根据参数类型调用对应的JDBC设置方法，从JobParameters中获取原始类型值：

@Bean
public JdbcCursorItemReader<YourEntity> customJdbcReader(DataSource dataSource, JobParameters jobParameters) {
    return new JdbcCursorItemReaderBuilder<YourEntity>()
            .dataSource(dataSource)
            .sql("SELECT id, name, create_time FROM your_table WHERE id = ? AND create_time <= ?")
            .preparedStatementSetter(ps -> {
                // 提取Long类型参数并绑定
                Long targetId = jobParameters.getLong("targetId");
                ps.setLong(1, targetId);
                
                // 提取Date类型参数，转换为sql.Date后绑定
                Date cutoffDate = jobParameters.getDate("cutoffDate");
                ps.setDate(2, new java.sql.Date(cutoffDate.getTime()));
            })
            .rowMapper(new BeanPropertyRowMapper<>(YourEntity.class))
            .name("customJdbcReader")
            .build();
}

方案二：使用NamedParameterJdbcCursorItemReader（推荐） #

Spring Batch提供的NamedParameterJdbcCursorItemReader支持命名参数，结合MapSqlParameterSource可以更优雅地传递带类型的参数：

@Bean
public NamedParameterJdbcCursorItemReader<YourEntity> namedParamReader(DataSource dataSource, JobParameters jobParameters) {
    // 将JobParameters转为保留原始类型的Map
    Map<String, Object> paramMap = new HashMap<>();
    paramMap.put("targetId", jobParameters.getLong("targetId"));
    paramMap.put("cutoffDate", jobParameters.getDate("cutoffDate"));
    paramMap.put("status", jobParameters.getString("status"));

    return new NamedParameterJdbcCursorItemReaderBuilder<YourEntity>()
            .dataSource(dataSource)
            .sql("SELECT * FROM your_table WHERE id = :targetId AND create_time <= :cutoffDate AND status = :status")
            .parameterSource(new MapSqlParameterSource(paramMap))
            .rowMapper(new BeanPropertyRowMapper<>(YourEntity.class))
            .name("namedParamReader")
            .build();
}

关键注意事项 #

1. 确保JobParameters保留原始类型：构建JobParameters时必须使用JobParametersBuilder的类型专属方法，比如addLong("targetId", 100L)、addDate("cutoffDate", new Date())，而不是统一用addString，否则JobParameters中只会存储字符串值。
2. 避免默认参数转换干扰：Spring Batch默认的DefaultJobParametersConverter会将参数转为字符串存储，但只要你通过JobParametersBuilder的类型方法添加参数，JobParameters对象内部会保留原始类型，可直接通过getLong()、getDate()等方法提取。

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