• SpringBoot와 SpringBatch
• Open source Java projects: Spring Batch : SpringBatch 2.x의 기본 적인 Tasklet, chunk, reader/writer/processor, retry 등의 개념 들을 예제와 함께 설명하고 있음.
• Spring Batch Tutorial – The ULTIMATE Guide
• Spring Batch Tutorial : 매우 상세한 튜토리얼
• Spring Batch Environment
• Spring Batch 2.2 JavaConfig
  • Spring Batch 2.2 - JavaConfig Part 1: A comparison to XML
  • Spring Batch 2.2 - JavaConfig Part 2: JobParameters, ExecutionContext and StepScope
  • Spring Batch 2.2 - JavaConfig Part 3: Profiles and environments
  • Spring Batch 2.2 - JavaConfig Part 4: Job inheritance
  • Spring Batch 2.2 - JavaConfig Part 5: Modular configurations
  • Spring Batch 2.2 - JavaConfig Part 6: Partitioning and Multi-threaded Step
• Spring Batch Transaction
  • Transactions in Spring Batch - Part 1: The Basics
  • Transactions in Spring Batch - Part 2: Restart, cursor based reading and listeners
  • Transactions in Spring Batch - Part 3: Skip and retry
• SpringOne2GX Replay: Spring Batch Performance Tuning
• Spring Batch Tasklet Example
• Spring Batch Job Example
• Spring Batch Scheduler Example
• Spring Batch JobRepository Example
• Spring Batch Partitioning Example
• Spring Batch Admin Tutorial
• petrikainulainen Spring Batch Tutorial - introduction
• Spring Batch using Partitioner
• Java Batch Tutorial | Java Code Geeks - 2018
• Java Batch Tutorial | Examples Java Code Geeks - 2018
• Spring Batch - 작업실행
• How to use Spring Batch Late Binding - Step Scope & Job Scope - grokonez
• Spring Batch - grokonez
• Spring Batch Example – MySQL Database To XML – Mkyong.com
• Spring Batch Exception Handling Example | Examples Java Code Geeks - 2018
• egovframework:rte2:brte:batch_core:parallel_process [eGovFrame]

• @EnableBatchProcessing을 통해 기본 배치 설정을 수행한다.

• 설정 중 일부를 Override하고자 한다면 DefaultBatchConfigurer 를 Configuration class에서 상속해서 메소드를 오버라이드 한다.
• dataSource 오버라이드 예

  // 다른 configuration class 에서 DataSource 생성 - embedded 예제
  @Bean
  public DataSource batchDataSource() {
      return new EmbeddedDatabaseBuilder().setType(EmbeddedDatabaseType.H2)
              .addScript("classpath:/org/springframework/batch/core/schema-h2.sql")
              .build();
  }
   
  @EnableBatchProcessing
  @Configuration
  public class BatchApplication extends DefaultBatchConfigurer {
      // dataSource 설정부분 override. transactionManager도 자동으로 생성함.
      @Autowired
      @Override
      public void setDataSource(@Qualifier("batchDataSource") DataSource batchDataSource) {
          super.setDataSource(batchDataSource);
      }
  }

• dataSource 자체를 null로 지정하면 MapJobRepository로 DB없이 작동하게 만들어진다.
• SpringBoot 에서 DefaultBatchConfigurer 사용시 TransactionManager 오작동 문제가 발생한다. SpringBoot와 SpringBatch 참고

• org.springframework.batch.core.repository.support.JobRepositoryFactoryBean로 SimpleJobRepository 생성
• MapJobRepositoryFactoryBean 로 in memory Job Repository 생성 가능.
• org.springframework.batch.core 패키지에 schema-*.sql 파일이 Batch Job Repository DB 스키마이다.
• schema-mysql.sql의 경우
  • text → longtext
  • datetime → datetime(6)로 변경해서 실행할 것.

• Spring batch upgrade from 2.1 to 2.2
  • DB 테이블 관련 정보가 바뀌었음.
  • MySQL의 경우 시퀀스 따른 방법이 바뀌었음.

TransactionManager를 지정하지 않으면 다음과 같은 오류가 발생한다.

java.lang.IllegalStateException: To use the default BatchConfigurer the context must contain precisely one DataSource, found X

TransactionManager 를 ResourcelessTransactionManager 로 지정하면 된다.

혹은 아래와 같이 propagation=“NEVER”로 지정한다.

<batch:job id="jobid">
    <batch:step id="step1">
        <batch:tasklet ref="taskletId" transaction-manager="transactionManager">
            <batch:transaction-attributes propagation="NEVER"/>
        </batch:tasklet>
    </batch:step>
</batch:job>

• Step 등을 생성할 때 @Value(“#{jobParameter[paramName]}” String param 형태로 Job Parameter를 받을 수 있다.

@Bean
@JobScope
public Step myStep(@Value("#{jobParameters[date]}" String date, 
    @Value("#{jobParameters[count]}") long count) {
    // ...
}

• Job은 Job + Job Parameter 로 Job Key 가 결정되는데 동일한 Job Key 일 경우 실행이 안된다.
• 따라서 Job Parameter를 다는 값으로 주거나 RunIdIncrementer를 사용한다.
• Spring Batch error (A Job Instance Already Exists) and RunIdIncrementer generates only once
• SpringBoot Batch 는 RunIdIncrementer의 특정 파라미터(run.id) 값을 계속 증가시켜준다.

jobBuilderFactory.get("myJobName")
            .start(step())
            . .....
            .incrementer(new RunIdIncrementer())
            .build();

• RunIdIncrementer를 사용하게 되면 항상 기존 실행됐던 Job의 파라미터가 현재 파라미터를 덮어쓰는 현상이 발생한다.
• 이유는 RunIdIncrementer가 동일 파라미터로 Job을 실행하려고 사용하는 것이라서 인 듯 하다.
• 따라서 RunIdIncrementer를 사용하면서도 파라미터를 유지하려면 다른 방식을 써야 한다.
• optional/omitted jobParameters are reloaded from previous jobs · Issue #38 · codecentric/spring-boot-starter-batch-web

/**
 * 파라미터를 복사하지 않는 RunIdIncrementer
 */
public class ParamCleanRunIdIncrementer implements JobParametersIncrementer {
    private static String RUN_ID_KEY = "run.id";
    private String key = RUN_ID_KEY;
 
    public void setKey(String key) { this.key = key; }
 
    @Override
    public JobParameters getNext(JobParameters parameters) {
        JobParameters params = (parameters == null) ? new JobParameters() : parameters;
        long id = params.getLong(key, 0L) + 1;
        return new JobParametersBuilder().addLong(key, id).toJobParameters(); // 이부분이 RunIdIncrementer와 다르다.
    }
}

• @StepScope 등을 사용하는 등 할 경우 리턴 타입을 ItemReader<X>, ItemWriter<Y> 처럼 인터페이스로 할 경우 프록시 객체가 생성되고 그로 인해서 instanceOf 를 사용하는 일부 코드들이 작동하지 않거나, annotation 기반의 listener 등이 동작하지 않는 문제를 일으킨다.
• 따라서 Spring Batch 용 각 스텝별 Bean 을 생성해서 리턴할 때는 항상 구현 클래스를 리턴 타입으로 지정할 것.
• [batch] @StepScope 사용시 주의사항
• 다음과 같은 WARN 을 볼 수도 있다.

o.s.b.c.l.AbstractListenerFactoryBean : org.springframework.batch.item.ItemReader is an interface. The implementing class will not be queried for annotation based listener configurations. If using @StepScope on a @Bean method, be sure to return the implementing class so listner annotations can be used.

• JobLauncherTestUtils로 테스트 가능.
  • 이 클래스는 static utility 가 아니라 Bean 으로 생성해줘야 하는 것이다.
  • setJob()으로 특정 Job을 지정하거나, 그냥 @Autowired될 수도 있음.
  • 특정 Step만 테스트도 가능함.
• SpringBoot와 SpringBatch 시에는 @MockBean도 가능.
• Spring Batch unit test example – Mkyong.com
• JobLauncherTestUtils를 이용한 Spring Batch Test

• Run a Spring Batch Job With Quartz
• Spring Batch (Michael Minella) - YouTube