배치 어플리케이션 명명규칙

1. 배치작업 처리 모델

다음은 기본적인 유형의 배치작업 처리 모델이다.

Figure 1. 배치작업 처리 모델

2. 배치 어플리케이션

BXCM은 배치를 위한 어플리케이션 단위는 관리 주체가 다르고, 어플리케이션 간 기능 호출을 최소화 할 수 있는 단위로 구분 한다. 어플리케이션은 Studio의 '새로운 BX 클라우드 프로젝트' 메뉴를 통해 생성한다.

배치 어플리케이션 명명 규칙
구분	설명
구성	L1코드 + '-' + L2코드 + '-' + batch
적용사례	bxcm-sample-batch
기본원칙	1. 어플리케이션 이름 작성은 다음과 같은 표기법을 따른다. L1코드,L2코드(영문명)의 소문자로 표기 단어와 단어 사이에 '-' 로 구분 2. 어플리케이션 이름은 중복되어서는 안되므로 전체 업무를 통틀어 유일한 이름을 갖도록 작성한다.

3. Job

배치 업무 처리 프로세스의 논리적 단위이며, 복수의 Step으로 구성되고, 배치 업무 실행 단위가 된다. Job의 이름은 다음과 같이 작성한다.

Job 명명 규칙
구분	설명
구성	L2코드(영문명) + "-" (표준단어)* 배치 Job을 식별 할 수 있는 단어의 조합으로 소문자로 구성한다.
길이	30자 이하로 구성
적용사례	sample-account-tax-sum sample-total-proc
기본원칙	배치 Job 명을 작성은 다음과 같은 표기법을 따른다. - 단어는 소문자와 '-' 로 조합한다. L2코드(영문명)과 표준단어들의 조합으로 구성한다.
작성 예	`<job id="sample-account-tax-sum"> ... </job>`

4. Step

Step은 배치의 최소 실행 업무 단위이다. 하나의 Job 에 1-N개의 Step 이 존재하며, Step 은 순차적으로 실행 된다. Step 을 순차적으로 실행하지 않고 병렬로 처리 할 경우 Step의 종류인 Split을 사용한다. Step과 Split의 이름은 다음과 같이 작성한다.

Step 명명 규칙
구분	설명
구성	JOB ID + '-' + Step일련번호 1자리 + Split일련번호2자리 Step만 있는 경우 100, 200 순으로 증가한다.
적용사례	sample-account-tax-sum-100 sample-account-tax-sum-101
기본원칙	Step 일련번호1자리: 배치작업의 Main Step 을 일련번호 순차부여(1,2,3…) Split일련번호2자리 - Main Step이 Split 되지 않으면 "00"으로 고정 - Split 되는 경우 일련번호 순차부여(01,02…)
작성 예	단일 Step `<job id="sample-account-tax-sum"> <step id="sample-account-tax-sum-100"> ... ... </step> </job>` 복수 Step `<job id="sample-account-tax-sum"> <step id="sample-account-tax-sum-100" next="sample-account-tax-sum-200"> ... ... </step> </job>` Split `<job id="sample-account-tax-sum" restartable="true"> <split id="sample-account-tax-sum-100" next="sample-account-tax-sum-200"> <flow> <step id="sample-account-tax-sum-101"> ... ... </step> </flow> <flow> <step id="sample-account-tax-sum-102"> ... ... </step> </flow> </split> <step id="sample-account-tax-sum-200"> ... ... </step> </job>`

5. Job Configuration File

Job의 Configuration을 설정하는 파일의 이름은 다음과 같이 작성한다.

Job Configuration File 규칙
구분	설명
구성	JOB ID + .xml
적용사례	sample-account-tax-sum.xml sample-total-proc.xml
기본원칙	프로젝트의 src/main/resources/jobs 폴더에 생성한다. 파일의 확장자는 xml를 사용한다. 하나의 Configuration 파일에 하나의 JOB이 존재한다.