Batch Job Test Wizard

개요

전자정부 표준프레임워크에서는 생성된 배치 파일들을 활용하여 간단한 테스트를 할 수 있는 테스트 마법사를 제공한다.

설명

배치 테스트시 필요한 항목들을 골라 테스트 파일을 생성해주고 JUnit을 통한 테스트를 진행한다.

배치 테스트 마법사 흐름

✔ 배치 테스트 마법사를 통해 생성된 테스트 파일은 별도로 JUnit Test를 진행할 경우에도 사용가능하다.

사용법

배치 테스트 마법사 시작하기
- 메뉴 표시줄에서 File > New > eGovFrame Batch Job Test를 선택한다. (단 eGovFrame Perspective내에서)
- 또는, 메뉴 표시줄에서 eGovFrame > Test > Batch Job Test을 선택한다. (단 eGovFrame Perspective내에서)
- 또는, Ctrl+N 단축키를 이용하여 새로작성 마법사를 실행한 후 eGovFrame > eGovFrame Batch Job Test를 선택하고 Next를 클릭한다.
배치 테스트 조건을 구성 혹은 선택하여 배치 테스트를 수행한다.
- 신규 배치 테스트 수행
  - (1) eGovFrame기반으로 생성한 배치 프로젝트 중 하나를 선택하고 Next를 클릭한다.
  - (2) 선택한 프로젝트 내에 존재하는 Job, Job Launcher 항목들 중 테스트를 진행하고자 하는 항목을 선택한다.
  - (3) 배치 테스트시 Parameters를 추가할 경우 Job Parameters 우측의 Add를 클릭한다. ✔ 기본 timestamp를 Parameter로 사용할 경우 Job Parameters에 항목을 추가하지 않아도 된다.
  - (4) 기 등록한 Job Parameters 중 사용할 Parameter를 선택하고 OK를 클릭한다.
  - (5) 선택한 항목들을 기반으로 테스트 파일을 만들어 주기 위해 Generate Batch Test File 버튼을 클릭한다. (Job, Job Launcher를 선택한 경우에만 테스트 파일을 생성할 수 있다.)
    ✔ 정상적인 테스트를 위해 테스트 파일은 프로젝트 하단의 src/main/java 혹은 src/test/java 하단에 생성해야 한다.
  - (6) 테스트 파일 생성이 성공적으로 완료 되면 Test 버튼을 클릭하여 구성한 배치에 대한 테스트를 수행한다.
  - (7) 배치 테스트 마법사 하단의 Result를 통해서 배치 테스트의 성공/실패 여부를 확인한다.
- 재사용 배치 테스트 수행
  - (1) eGovFrame기반으로 생성한 배치 프로젝트 중 하나를 선택하고 Next를 클릭한다.
  - (2) 선택한 프로젝트 내에 존재하는 배치 테스트 파일 선택을 위해 Reuse를 클릭한다.
  - (3) 전자정부 프레임워크 배치개발환경을 통해 생성한 배치 테스트 파일들에 대한 목록 중 재사용하려는 배치 테스트 파일을 선택한다.
  - (4) 선택한 테스트 파일을 사용하여 Test 버튼을 클릭하여 구성한 배치에 대한 테스트를 수행한다.
  - (5) 배치 테스트 마법사 하단의 Result를 통해서 배치 테스트의 성공/실패 여부를 확인한다.
배치 테스트 마법사를 통해 생성된 테스트 파일은 배치 테스트 마법사가 종료된 이후에도 JUnit을 이용하여 사용할 수 있다. (생성된 테스트 파일에 대한 자세한 설명은 하단의 참고사항 에서 확인할 수 있다.)
- (1) 배치 테스트 마법사를 통해 생성된 테스트 파일 중 사용하려는 파일을 찾아 선택한다.
- (2) 선택한 파일에서 우클릭 > Run As > JUnit Test를 선택하여 배치 테스트를 수행한다. (JUnit에 대한 상세 설명을 본 페이지 에서 확인할 수 있다.)
- (3) 테스트를 진행한 결과는 하단의 JUnit View에서 확인 가능하다.

참고사항

배치 테스트 마법사를 통해 생성된 파일의 구성 항목

@RunWith(SpringJUnit4ClassRunner.class)
 
@ContextConfiguration(locations = { "/newJobLauncher.xml", "/newJob.xml", "/egovframework/batch/context-batch-job-launcher.xml", "/egovframework/batch/context-batch-datasource.xml" })
public class testFile{
 
	@Autowired
	@Qualifier("newJobLauncher.egovBatchRunner")
	private EgovBatchRunner egovBatchRunner;
 
	@Test
	public void testJobRun() throws Exception {
 
		String jobName = "TestJob";
 
		JobParametersBuilder jobParametersBuilder = new JobParametersBuilder();
		jobParametersBuilder.addLong("timestamp", new Date().getTime());
		jobParametersBuilder.addString("name", "eGovframe");
 
 
		String jobParameters = egovBatchRunner.convertJobParametersToString(jobParametersBuilder.toJobParameters());
 
		long executionId = egovBatchRunner.start(jobName, jobParameters);
 
		// Launcher 파일 내 Aysnc 설정이 존재 할 경우 Thread.sleep(10000)
		// if(egovBatchRunner.getJobExecution(executionId).getExitStatus().toString().contains("UNKNOWN")){
		//	Thread.sleep(10000);
		// }
 
		assertEquals(BatchStatus.COMPLETED, egovBatchRunner.getJobExecution(executionId).getStatus());
 
	}
}

구분	항목	설명	입력값
동기/비동기	@RunWith	Spring의 JUnit을 통한 테스트를 위한 등록	SpringJUnit4ClassRunner.class
동기/비동기	@ContextConfiguration	배치 테스트를 위해 Job, JobLauncher 등의 구성 항목 위치 등록	{“JobLauncher 위치”, “Job 위치”, ”(JobRepository 위치)”, ”(Datasource 위치)”}
동기/비동기	@Qualifier	구성한 Job, JobLauncher 등의 항목을 묶어줌	선택한 JobLauncher 에 등록되어 있는 EgovBatchRunner클래서 등록 bean id
비동기	Thread.sleep(10000);	선택한 Job 항목 내에 비동기 설정이 있는 경우 정상 동작을 위한 등록	10000

✔ Thread.sleep(10000) : 일반적으로 Java Application으로 구동되기 때문에 Job이 수행된 직후 바로 종료된다. 따라서 안정적인 비동기식 Job을 성공시키기 위해 Thread.sleep을 추가시켰다. 10000이라는 시간은 Job이 수행되는 기본적인 시간을 감안해서 설정해 놓았고 그 이상의 시간이 소요되는 Job을 테스트 할 경우 시간을 늘려줄 필요가 있다.

Maven

Gradle

Docker

Batch Job Test Wizard

개요

설명

사용법

참고사항