Update Javadocs with "since" tag for 5.1

Author: fmbenhassine

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

@@ -209,6 +209,12 @@ public JobOperator jobOperator() throws BatchConfigurationException {
 		}
 	}
 
+	/**
+	 * Defines a {@link JobRegistryBeanPostProcessor} bean.
+	 * @return a {@link JobRegistryBeanPostProcessor} bean
+	 * @throws BatchConfigurationException if unable to register the bean
+	 * @since 5.1
+	 */
 	@Bean
 	public JobRegistryBeanPostProcessor jobRegistryBeanPostProcessor() throws BatchConfigurationException {
 		JobRegistryBeanPostProcessor jobRegistryBeanPostProcessor = new JobRegistryBeanPostProcessor();
@@ -372,6 +378,7 @@ protected DataFieldMaxValueIncrementerFactory getIncrementerFactory() {
 	 * injected, is the {@link DefaultJobKeyGenerator}.
 	 * @return the generator that creates the key used in identifying {@link JobInstance}
 	 * objects
+	 * @since 5.1
 	 */
 	protected JobKeyGenerator getJobKeyGenerator() {
 		return new DefaultJobKeyGenerator();

spring-batch-core/src/main/java/org/springframework/batch/core/job/builder/FlowJobBuilder.java

@@ -27,6 +27,7 @@
  * nested flow composed of steps and conditional transitions between steps.
  *
  * @author Dave Syer
+ * @author Mahmoud Ben Hassine
  * @since 2.2
  */
 public class FlowJobBuilder extends JobBuilderHelper<FlowJobBuilder> {
@@ -67,6 +68,7 @@ public JobFlowBuilder start(Step step) {
 	 * or steps.
 	 * @param decider the decider to start with
 	 * @return a builder to enable fluent chaining
+	 * @since 5.1
 	 */
 	public JobFlowBuilder start(JobExecutionDecider decider) {
 		return new JobFlowBuilder(this, decider);

spring-batch-core/src/main/java/org/springframework/batch/core/job/builder/JobBuilder.java

@@ -72,6 +72,7 @@ public JobFlowBuilder start(Flow flow) {
 	 * Create a new job builder that will start with a decider.
 	 * @param decider a decider to start with
 	 * @return a {@link JobFlowBuilder}
+	 * @since 5.1
 	 */
 	public JobFlowBuilder start(JobExecutionDecider decider) {
 		return new FlowJobBuilder(this).start(decider);

spring-batch-core/src/main/java/org/springframework/batch/core/job/builder/JobBuilderHelper.java

@@ -128,6 +128,7 @@ public B repository(JobRepository jobRepository) {
 	 * Sets the job observation convention.
 	 * @param observationConvention the job observation convention (optional)
 	 * @return this to enable fluent chaining
+	 * @since 5.1
 	 */
 	public B observationConvention(BatchJobObservationConvention observationConvention) {
 		properties.observationConvention = observationConvention;

spring-batch-core/src/main/java/org/springframework/batch/core/step/builder/StepBuilderHelper.java

@@ -97,6 +97,12 @@ public B repository(JobRepository jobRepository) {
 		return self();
 	}
 
+	/**
+	 * Sets the step observation convention.
+	 * @param observationConvention the step observation convention (optional)
+	 * @return this to enable fluent chaining
+	 * @since 5.1
+	 */
 	public B observationConvention(BatchStepObservationConvention observationConvention) {
 		properties.observationConvention = observationConvention;
 		return self();

spring-batch-core/src/main/java/org/springframework/batch/core/step/tasklet/CallableTaskletAdapter.java

@@ -28,6 +28,7 @@
  * Adapts a {@link Callable}<{@link RepeatStatus}> to the {@link Tasklet} interface.
  *
  * @author Dave Syer
+ * @author Mahmoud Ben Hassine
  *
  */
 public class CallableTaskletAdapter implements Tasklet, InitializingBean {
@@ -36,13 +37,15 @@ public class CallableTaskletAdapter implements Tasklet, InitializingBean {
 
 	/**
 	 * Create a new {@link CallableTaskletAdapter} instance.
+	 * @since 5.1
 	 */
 	public CallableTaskletAdapter() {
 	}
 
 	/**
 	 * Create a new {@link CallableTaskletAdapter} instance.
 	 * @param callable the {@link Callable} to use
+	 * @since 5.1
 	 */
 	public CallableTaskletAdapter(Callable<RepeatStatus> callable) {
 		setCallable(callable);

spring-batch-infrastructure/src/main/java/org/springframework/batch/item/ExecutionContext.java

@@ -264,6 +264,7 @@ public Object get(String key) {
 	 * @param <V> Type of returned value
 	 * @return The value of given type represented by the given key or {@code null} if the
 	 * key is not present
+	 * @since 5.1
 	 */
 	@Nullable
 	public <V> V get(String key, Class<V> type) {
@@ -283,6 +284,7 @@ public <V> V get(String key, Class<V> type) {
 	 * @param <V> Type of returned value
 	 * @return The value of given type represented by the given key or the default value
 	 * if the key is not present
+	 * @since 5.1
 	 */
 	@Nullable
 	public <V> V get(String key, Class<V> type, @Nullable V defaultValue) {
@@ -345,6 +347,7 @@ public Set<Entry<String, Object>> entrySet() {
 	 * Returns the internal map as read-only.
 	 * @return An unmodifiable map containing all contents.
 	 * @see java.util.Map
+	 * @since 5.1
 	 */
 	public Map<String, Object> toMap() {
 		return Collections.unmodifiableMap(this.map);

spring-batch-infrastructure/src/main/java/org/springframework/batch/item/adapter/AbstractMethodInvokingDelegator.java

@@ -218,13 +218,15 @@ protected Object[] getArguments() {
 
 	/**
 	 * @return the object on which the method will be invoked.
+	 * @since 5.1
 	 */
 	protected Object getTargetObject() {
 		return targetObject;
 	}
 
 	/**
 	 * @return the name of the method to be invoked.
+	 * @since 5.1
 	 */
 	protected String getTargetMethod() {
 		return targetMethod;

spring-batch-infrastructure/src/main/java/org/springframework/batch/item/database/JdbcBatchItemWriter.java

@@ -215,6 +215,7 @@ public void write(final Chunk<? extends T> chunk) throws Exception {
 	/**
 	 * Extension point to post process the update counts for each item.
 	 * @param updateCounts the array of update counts for each item
+	 * @since 5.1
 	 */
 	protected void processUpdateCounts(int[] updateCounts) {
 		// No Op

spring-batch-infrastructure/src/main/java/org/springframework/batch/item/database/JpaItemWriter.java

@@ -76,6 +76,7 @@ public void setUsePersist(boolean usePersist) {
 	 * Flag to indicate that the persistence context should be cleared and flushed at the
 	 * end of the write (default true).
 	 * @param clearPersistenceContext the flag value to set
+	 * @since 5.1
 	 */
 	public void setClearPersistenceContext(boolean clearPersistenceContext) {
 		this.clearPersistenceContext = clearPersistenceContext;