Add default converters for java.util.Date parameter type

Resolves #4297
Resolves #4270

Author: fmbenhassine

spring-batch-core/src/main/java/org/springframework/batch/core/configuration/support/DefaultBatchConfiguration.java

@@ -26,6 +26,8 @@
 
 import org.springframework.batch.core.configuration.BatchConfigurationException;
 import org.springframework.batch.core.configuration.JobRegistry;
+import org.springframework.batch.core.converter.DateToStringConverter;
+import org.springframework.batch.core.converter.StringToDateConverter;
 import org.springframework.batch.core.explore.JobExplorer;
 import org.springframework.batch.core.explore.support.JobExplorerFactoryBean;
 import org.springframework.batch.core.launch.JobLauncher;
@@ -375,7 +377,10 @@ protected TaskExecutor getTaskExecutor() {
 	 * @return the {@link ConfigurableConversionService} to use.
 	 */
 	protected ConfigurableConversionService getConversionService() {
-		return new DefaultConversionService();
+		DefaultConversionService conversionService = new DefaultConversionService();
+		conversionService.addConverter(new DateToStringConverter());
+		conversionService.addConverter(new StringToDateConverter());
+		return conversionService;
 	}
 
 }

spring-batch-core/src/main/java/org/springframework/batch/core/converter/AbstractDateConverter.java

@@ -0,0 +1,30 @@
+/*
+ * Copyright 2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.batch.core.converter;
+
+import java.time.format.DateTimeFormatter;
+
+/**
+ * Base class for {@link java.util.Date} converters.
+ *
+ * @author Mahmoud Ben Hassine
+ * @since 5.0.1
+ */
+public class AbstractDateConverter {
+
+	protected DateTimeFormatter dateTimeFormatter = DateTimeFormatter.ISO_INSTANT;
+
+}

spring-batch-core/src/main/java/org/springframework/batch/core/converter/DateToStringConverter.java

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.batch.core.converter;
+
+import java.util.Date;
+
+import org.springframework.core.convert.converter.Converter;
+
+/**
+ * {@link Converter} implementation from {@link java.util.Date} to {@link String}.
+ *
+ * This converter formats dates according to the
+ * {@link java.time.format.DateTimeFormatter#ISO_INSTANT} format.
+ *
+ * @author Mahmoud Ben Hassine
+ * @since 5.0.1
+ */
+public class DateToStringConverter extends AbstractDateConverter implements Converter<Date, String> {
+
+	@Override
+	public String convert(Date source) {
+		return super.dateTimeFormatter.format(source.toInstant());
+	}
+
+}

spring-batch-core/src/main/java/org/springframework/batch/core/converter/DefaultJobParametersConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2006-2022 the original author or authors.
+ * Copyright 2006-2023 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -53,14 +53,29 @@
  * service should be configured with a converter to and from string literals to job
  * parameter types.
  *
+ * By default, the Spring conversion service is augmented to support the conversion of the
+ * following types:
+ *
+ * <ul>
+ * <li>{@link java.util.Date}: in the
+ * {@link java.time.format.DateTimeFormatter#ISO_INSTANT} format</li>
+ * </ul>
+ *
  * @author Dave Syer
  * @author Michael Minella
  * @author Mahmoud Ben Hassine
  *
  */
 public class DefaultJobParametersConverter implements JobParametersConverter {
 
-	protected ConfigurableConversionService conversionService = new DefaultConversionService();
+	protected ConfigurableConversionService conversionService;
+
+	public DefaultJobParametersConverter() {
+		DefaultConversionService conversionService = new DefaultConversionService();
+		conversionService.addConverter(new DateToStringConverter());
+		conversionService.addConverter(new StringToDateConverter());
+		this.conversionService = conversionService;
+	}
 
 	/**
 	 * @see org.springframework.batch.core.converter.JobParametersConverter#getJobParameters(java.util.Properties)

spring-batch-core/src/main/java/org/springframework/batch/core/converter/JsonJobParametersConverter.java

@@ -47,6 +47,14 @@
  * service should be configured with a converter to and from string literals to job
  * parameter types.
  *
+ * By default, the Spring conversion service is augmented to support the conversion of the
+ * following types:
+ *
+ * <ul>
+ * <li>{@link java.util.Date}: in the
+ * {@link java.time.format.DateTimeFormatter#ISO_INSTANT} format</li>
+ * </ul>
+ *
  * @author Mahmoud Ben Hassine
  * @since 5.0
  *

spring-batch-core/src/main/java/org/springframework/batch/core/converter/StringToDateConverter.java

@@ -0,0 +1,39 @@
+/*
+ * Copyright 2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.batch.core.converter;
+
+import java.time.Instant;
+import java.util.Date;
+
+import org.springframework.core.convert.converter.Converter;
+
+/**
+ * {@link Converter} implementation from {@link String} to {@link java.util.Date}.
+ *
+ * This converter expects strings in the
+ * {@link java.time.format.DateTimeFormatter#ISO_INSTANT} format.
+ *
+ * @author Mahmoud Ben Hassine
+ * @since 5.0.1
+ */
+public class StringToDateConverter extends AbstractDateConverter implements Converter<String, Date> {
+
+	@Override
+	public Date convert(String source) {
+		return Date.from(super.dateTimeFormatter.parse(source, Instant::from));
+	}
+
+}

spring-batch-core/src/main/java/org/springframework/batch/core/explore/support/JobExplorerFactoryBean.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2022 the original author or authors.
+ * Copyright 2002-2023 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -21,7 +21,8 @@
 
 import javax.sql.DataSource;
 
-import org.springframework.batch.core.explore.JobExplorer;
+import org.springframework.batch.core.converter.DateToStringConverter;
+import org.springframework.batch.core.converter.StringToDateConverter;
 import org.springframework.batch.core.repository.ExecutionContextSerializer;
 import org.springframework.batch.core.repository.dao.AbstractJdbcBatchMetadataDao;
 import org.springframework.batch.core.repository.dao.DefaultExecutionContextSerializer;
@@ -164,7 +165,10 @@ public void afterPropertiesSet() throws Exception {
 		}
 
 		if (this.conversionService == null) {
-			this.conversionService = new DefaultConversionService();
+			DefaultConversionService conversionService = new DefaultConversionService();
+			conversionService.addConverter(new DateToStringConverter());
+			conversionService.addConverter(new StringToDateConverter());
+			this.conversionService = conversionService;
 		}
 
 		super.afterPropertiesSet();

spring-batch-core/src/main/java/org/springframework/batch/core/repository/dao/JdbcJobExecutionDao.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2006-2022 the original author or authors.
+ * Copyright 2006-2023 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,7 +20,6 @@
 import java.sql.SQLException;
 import java.sql.Timestamp;
 import java.sql.Types;
-import java.time.LocalDateTime;
 import java.util.HashMap;
 import java.util.HashSet;
 import java.util.List;
@@ -37,6 +36,8 @@
 import org.springframework.batch.core.JobInstance;
 import org.springframework.batch.core.JobParameter;
 import org.springframework.batch.core.JobParameters;
+import org.springframework.batch.core.converter.DateToStringConverter;
+import org.springframework.batch.core.converter.StringToDateConverter;
 import org.springframework.beans.factory.InitializingBean;
 import org.springframework.core.convert.support.ConfigurableConversionService;
 import org.springframework.core.convert.support.DefaultConversionService;
@@ -106,7 +107,14 @@ public class JdbcJobExecutionDao extends AbstractJdbcBatchMetadataDao implements
 
 	private DataFieldMaxValueIncrementer jobExecutionIncrementer;
 
-	private ConfigurableConversionService conversionService = new DefaultConversionService();
+	private ConfigurableConversionService conversionService;
+
+	public JdbcJobExecutionDao() {
+		DefaultConversionService conversionService = new DefaultConversionService();
+		conversionService.addConverter(new DateToStringConverter());
+		conversionService.addConverter(new StringToDateConverter());
+		this.conversionService = conversionService;
+	}
 
 	/**
 	 * Public setter for the exit message length in database. Do not set this if you
@@ -127,7 +135,7 @@ public void setJobExecutionIncrementer(DataFieldMaxValueIncrementer jobExecution
 	}
 
 	/**
-	 * Set the conversion service to use to convert job parameters from String literal to
+	 * Set the conversion service to use to convert job parameters from String literals to
 	 * typed values and vice versa.
 	 */
 	public void setConversionService(@NonNull ConfigurableConversionService conversionService) {

spring-batch-core/src/main/java/org/springframework/batch/core/repository/support/JobRepositoryFactoryBean.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2022 the original author or authors.
+ * Copyright 2002-2023 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,11 +20,14 @@
 import java.nio.charset.Charset;
 import java.nio.charset.StandardCharsets;
 import java.sql.Types;
+
 import javax.sql.DataSource;
 
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
 
+import org.springframework.batch.core.converter.DateToStringConverter;
+import org.springframework.batch.core.converter.StringToDateConverter;
 import org.springframework.batch.core.repository.ExecutionContextSerializer;
 import org.springframework.batch.core.repository.dao.AbstractJdbcBatchMetadataDao;
 import org.springframework.batch.core.repository.dao.DefaultExecutionContextSerializer;
@@ -235,7 +238,10 @@ public void afterPropertiesSet() throws Exception {
 		}
 
 		if (this.conversionService == null) {
-			this.conversionService = new DefaultConversionService();
+			DefaultConversionService conversionService = new DefaultConversionService();
+			conversionService.addConverter(new DateToStringConverter());
+			conversionService.addConverter(new StringToDateConverter());
+			this.conversionService = conversionService;
 		}
 
 		super.afterPropertiesSet();

spring-batch-core/src/test/java/org/springframework/batch/core/converter/DateToStringConverterTest.java

@@ -0,0 +1,45 @@
+/*
+ * Copyright 2023 the original author or authors.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *      https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.springframework.batch.core.converter;
+
+import java.time.Instant;
+import java.util.Date;
+
+import org.junit.jupiter.api.Assertions;
+import org.junit.jupiter.api.Test;
+
+/**
+ * Test class for {@link DateToStringConverter}.
+ *
+ * @author Mahmoud Ben Hassine
+ */
+class DateToStringConverterTest {
+
+	private final DateToStringConverter converter = new DateToStringConverter();
+
+	@Test
+	void testConvert() {
+		// given
+		Date date = Date.from(Instant.EPOCH);
+
+		// when
+		String converted = this.converter.convert(date);
+
+		// then
+		Assertions.assertEquals("1970-01-01T00:00:00Z", converted);
+	}
+
+}