http://www.egovframe.go.kr/wiki/ 2025-06-15T23:53:20+00:00 http://www.egovframe.go.kr/wiki/ http://www.egovframe.go.kr/wiki/lib/images/favicon.ico text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:batch_runner&rev=1703136093&do=diff 개요 JobRunner는 외부 실행 모듈과 JobLauncher를 연결해주는 모듈로, 용도에 맞게 구현이 필요하다. 전자정부 표준프레임워크에서는 작업실행 유형에 따라 미리 JobRunner를 미리 구현한 표준 Batch Runner를 제공한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:code_base_exception&rev=1703136093&do=diff 개요 배치 처리시 Code 기반으로 에러를 처리 할 수 있도록 EgovBatchException를 통해서 지원한다. 데이터베이스 에러코드관리 테이블을 등록과 에러코드 데이터를 등록이 선행 되야지만 해당 서비스를 사용가능하다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:egov_batch_runner&rev=1703136093&do=diff 개요 표준프레임워크의 배치작업 실행유형에 따른 편의 기능을 제공하는 서비스이다. 설명 배치작업 실행을 위해서는 실행의 주체가 되는 Job(작업)과 Job Parameter, 그리고 Job을 실행하는 Job Launcher가 필요하다. 일반적으로 개발자가 Job Launcher를 이용하여 응용 어플리케이션이나 운영환경등에서 사용할 기능을 직접 구현해야 했기 때문에 표준을 제시하기 힘들었다. 이를 해소하기 위해 전자정부 표준프레임워크에서는 작업실행 유형에 따라 미리 구현된 표준 Batch Runner를 제공한다.… text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:egov_commandline_runner_template&rev=1703136093&do=diff 개요 CommandLine 배치 템플릿 프로젝트를 이용하여 EgovCommandLineRunner의 사용법을 보여주는 예제이다. 설명 설정 CommandLine 배치 템플릿 프로젝트 생성 아래를 참고하여 File(SAM) / DB 타입의 CommandLine 배치 템플릿 프로젝트 를 생성한다. * File(SAM)타입 * DB타입 text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:egov_file_writer&rev=1703136093&do=diff 개요 Spring 배치에서 제공하는 ItemWriter 중 File 기반 관련 설정을 사용할 경우, 대용량 데이터 처리 시간이 상용 배치프레임워크과 비교하여 큰 차이가 발생해 실무에 적용하기에는 부족한 점이 있었다. 이 문제를 해결하기 위해서 File 기반 Item Writer의 요소 중 성능저하 요인인 FieldExtractor, FormatterLineAggregator 부분을 개선하였다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:egov_scheduler_runner_template&rev=1703136093&do=diff 개요 Scheduler 기반의 배치 템플릿 프로젝트를 이용하여 EgovSchedulerRunner의 사용법을 보여주는 예제이다. 설명 설정 Scheduler 배치 템플릿 프로젝트 생성 아래를 참고하여 File(SAM) / DB 타입의 Scheduler 배치 템플릿 프로젝트 를 생성한다. * File(SAM)타입 * DB타입 text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:event_notice_template_mgmt&rev=1703136093&do=diff 개요 전자정부 표준프레임워크의 배치 수행중 특정시점에 이벤트가 발생하는 경우 EventNoticeTrigger 인터페이스를 활용하여 SMS, Email 등을 통해 정보를 전달할 수 있는 추상화된 외부알림 access 관리기능이다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:flow_control&rev=1703136093&do=diff 개요 Job 내부에는 여러 Step 들이 존재할 수 있고, 각 Step 사이의 흐름을 관리할 필요가 있다. Step 내의 next 설정과 Desision 설정으로 Job을 수행하다 한 Step의 처리결과에 따라 다른 Step을 선택하여 수행할 수 있고, 특정 Step의 실패가 Job 전체의 실패로 이어지지 않도록 구성할 수 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:history_management&rev=1703136093&do=diff 개요 배치작업 처리 중의 정보는 JobRepository의 JobInstance, JobParams, JobExecution, StepExecution, key-value 쌍으로 값을 보관할 수 있는 공간인 ExecutionContext에 저장 및 갱신되어 history를 관리한다. 설명 JobInstance, JobParams, JobExecution, StepExecution, ExecutionContext 의 각각의 속성에 대해서 정리하였다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:item_reader&rev=1703136093&do=diff 개요 ItemReader는 읽기 대상의 타입에 관계없이 한번에 한 항목을 읽으며 읽을 항목이 모두 소진되면 Null을 반환하는 인터페이스이다. 설명 ItemReader는 여러 종류의 데이터 타입을 입력 받을 수 있다. 가장 일반적인 데이터 타입으로 플랫 파일, XML, 데이터베이스가 있다. text/html 2022-07-01T01:46:50+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:item_reader_v3.7&rev=1656640010&do=diff 개요 ItemReader는 읽기 대상의 타입에 관계없이 한번에 한 항목을 읽으며 읽을 항목이 모두 소진되면 Null을 반환하는 인터페이스이다. 설명 ItemReader는 여러 종류의 데이터 타입을 입력 받을 수 있다. 가장 일반적인 데이터 타입으로 플랫 파일, XML, 데이터베이스가 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:item_writer&rev=1703136093&do=diff 개요 ItemWriter는 대상 타입에 관계없이 한번에 항목의 묶음(Chunk)을 쓰는 동작의 인터페이스이다. 설명 ItemWriter의 기능은 ItemReader와 유사하지만 정반대의 동작을 한다. 기본적인 ItemWriter 인터페이스는 아래와 같다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:item_writer_v3.7&rev=1703136093&do=diff 개요 ItemWriter는 대상 타입에 관계없이 한번에 항목의 묶음(Chunk)을 쓰는 동작의 인터페이스이다. 설명 ItemWriter의 기능은 ItemReader와 유사하지만 정반대의 동작을 한다. 기본적인 ItemWriter 인터페이스는 아래와 같다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job&rev=1703136093&do=diff 개요 Job은 배치작업 전체의 중심 개념으로 배치작업 자체를 의미한다. Job은 실제 프로세스가 진행되는 Step들을 최상단에서 포함하고 있으며, Job의 실행은 배치작업 전체의 실행을 의미한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_explorer&rev=1703136093&do=diff 개요 JobExplorer는 실행 중인 Job 및 Step의 execution을 검색하기 위한 시작지점으로, Repository에 접근하여 배치작업에 대한 정보를 얻는다. 설명 JobExplorer에서는 Repository에 있는 Execution의 데이터를 사용하기 위해서 Repository에 접근한다.JobExplorer은 repository의 데이터를 오직 읽을 수만 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_launcher&rev=1703136093&do=diff 개요 JobLauncher는 배치작업을 실행시키는 역할을 한다. Job과 Job Parameters를 이용하여 요청된 배치 작업을 수행한 후 JobExecution을 반환한다. 설명 JobLauncher 인터페이스를 보면 Job과 Job Parameter를 이용하여 요청된 Job을 수행한 후 JobExecution을 반환되는 run메소드가 정의되어 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_operator&rev=1703136093&do=diff 개요 JobOperator는 JobRegistry, JobExplorer, JobLauncher, JobRepository 클래스를 통해 Job의 InstanceId, ExecutionId, JobName을 이용하여 job을 제어하여 일반적인 모니터링 작업을 위해 사용한다. 설명 JobOperator는 배치운영자가 의해 이루어지는 배치작업의 stopping, restarting, 또는 summarizing와 같은 모니터링 작업을 제공한다. Spring 배치는 JobOperator 인터페이스를 통해 아래의 작업의 유형을 제공한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_registry&rev=1703136093&do=diff 개요 JobRegistry는 생성된 Job을 자동으로 Map형태로 저장하여 관리(추가, 삭제 등)한다. 설명 JobRegistry는 필수는 아니지만 context에서 Job을 추적하거나 다른 곳에서 생성된 Job을 application context의 중앙에 모을 때 유용하다. 등록된 Job의 이름과 속성들을 조작할 수 있으며 job name과 job instance의 Map의 형태로 이루워져 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_repository&rev=1703136093&do=diff 개요 JobRepository는 배치 작업 중의 정보를 저장하는 역할을 한다. 어떠한 Job이 언제 수행되었고, 언제 끝났으며, 몇 번이 실행되었고 실행에 대한 결과가 어떤지 등의 배치 작업의 수행과 관련된 모든 meta data가 저장되어 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_v3.7&rev=1703136093&do=diff 개요 Job은 배치작업 전체의 중심 개념으로 배치작업 자체를 의미한다. Job은 실제 프로세스가 진행되는 Step들을 최상단에서 포함하고 있으며, Job의 실행은 배치작업 전체의 실행을 의미한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:job_variable&rev=1703136093&do=diff 개요 변수 선언 후 Job Listeners를 통해서 모든 Job에서 사용자 정의 변수를 사용할 수 있도록 EgovJobVariableListener를 통해서 지원한다. 사용자가 변수를 정의하여 여러 job에서 해당 변수를 공유하여 사용 가능한 기능으로 이루어져있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:listener&rev=1703136093&do=diff 개요 배치 수행시 Job을 구성하는 각 단계(Job, Step, Chunk, Read, Process, Write)에서 이벤트설정을 통해 다양한 추가구성을 할 수 있다. 이벤트는 Listener를 활용하여 설정하고, 배치 수행중 설정한 Listener를 접하게 되면 관련된 이벤트를 수행하게 된다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:logback_logging&rev=1703136093&do=diff 개요 배치 처리시 로깅 처리를 위해 log4j2를 지원하고 있지만 경량화된 로깅 처리를 위해 Logback 로깅 처리를 지원한다. 설명 Logback pom.xml 설정 log4j, commons-logging 관련 라이브러리를 exclusion 처리하고, Logback 라이브러리를 등록한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:multidata_process&rev=1703136093&do=diff 개요 배치 수행시 다수의 리소스를 처리하고자 할 경우에는 일반적인 Job설정으로 처리할 수 없다. 전자정부 배치프레임워크에서는 MultiData Processing을 통해 다수의 리소스를 읽어 다수의 결과로 처리하거나 다수의 리소스를 읽어 하나의 결과로 처리하는 기능을 제공한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:parallel_process&rev=1703136093&do=diff 개요 대용량 데이터를 처리하는 배치수행에서 병렬처리를 이용하면, Job의 구성요소들이 여러 쓰레드 분산수행되어 빠른 시간 내에 효율적으로 작업을 완료할 수 있다. 스프링 배치에서 병렬처리 방식은 실행 유형별로 멀티쓰레드 방식, Parallel 방식, 파티셔닝 방식 등이 있다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:resource_variable&rev=1703136093&do=diff Resource Variable 개요 사용자 정의 리소스 변수 선언 후 Setp에서 ItemReader, ItemWriter에서 사용자 정의 리소스를 사용할 수 있도록 EgovResourceVariable를 통해서 지원한다. 설명 EgovResourceVariable 설정 배치실행환경에서 제공하는 EgovResourceVariable 사용하여 사용자 정의 리소스를 설정한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:skip_repeat_retry&rev=1703136093&do=diff 개요 Skip, Retry, Repeat은 효율적인 배치수행을 위해 필요한 기능들이다. Repeat 정책에 따라 Step과 Chunk가 반복적으로 수행되면서 데이터 Read, Process, Write 과정이 일어나는데, 여기서 Skip과 Retry 이용해 배치작업을 효율적으로 수행할 수 있다. 각 기능이 쓰이는 위치는 다음 그림을 참고한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:sqllite&rev=1703136093&do=diff 개요 배치 처리시 경량화된 Repository를 사용을 위한 SQLite 처리를 지원한다. 설명 SQLite pom.xml 설정 sqlite 라이브러리 사용을 위해 dependency를 추가 한다. <dependency> <groupId>org.xerial</groupId> <artifactId>sqlite-jdbc</artifactId> <version>x.x.x</version> </dependency> text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:step&rev=1703136093&do=diff 개요 Step은 Job 내부에 구성되어 실제 배치작업 수행을 위해 작업을 정의하고 제어한다. 즉, Step에서는 입력 자원을 설정하고 어떤 방법으로 어떤 과정을 통해 처리할지 그리고 어떻게 출력 자원을 만들 것인지에 대한 모든 설정을 포함한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:step_v3.7&rev=1703136093&do=diff 개요 Step은 Job 내부에 구성되어 실제 배치작업 수행을 위해 작업을 정의하고 제어한다. 즉, Step에서는 입력 자원을 설정하고 어떤 방법으로 어떤 과정을 통해 처리할지 그리고 어떻게 출력 자원을 만들 것인지에 대한 모든 설정을 포함한다. text/html 2023-12-21T05:21:33+00:00 http://www.egovframe.go.kr/wiki/doku.php?id=egovframework:rte2:brte:batch_core:step_variable&rev=1703136093&do=diff 개요 변수 선언 후 Listeners를 통해서 모든 Setp에서 사용자 정의 변수를 사용할 수 있도록 EgovStepVariableListener를 통해서 지원한다. 사용자가 변수를 정의하여 여러 step에서 해당 변수를 공유하여 사용 가능한 기능으로 이루어져있다.