Skip to content

perf: JDBC 배치 쓰기 핫패스의 행별 reflection 할당·청크별 타입 산출 제거#265

Open
z3rotig4r wants to merge 1 commit into
eGovFramework:mainfrom
z3rotig4r:perf/jdbc-batch-write-reflection
Open

perf: JDBC 배치 쓰기 핫패스의 행별 reflection 할당·청크별 타입 산출 제거#265
z3rotig4r wants to merge 1 commit into
eGovFramework:mainfrom
z3rotig4r:perf/jdbc-batch-write-reflection

Conversation

@z3rotig4r

Copy link
Copy Markdown
Contributor

변경 이유

EgovJdbcBatchItemWriter(DefaultItemWriter가 jdbcDb 쓰기를 위임하는 대상)의 배치 쓰기 핫패스에 반복 reflection 비용이 두 군데 있습니다.

  • 행별 reflector 할당: EgovMethodMapItemPreparedStatementSetter.setValues()가 행마다 new EgovReflectionSupport를 생성합니다. 이 호출은 인자만 사용하는 무상태 메서드인데도 행 수만큼 인스턴스를 할당하므로, 대용량 잡에서 불필요한 GC 부담이 됩니다.
  • 청크별 sqlTypes 재산출: write()가 청크마다 getSqlTypeArray(params, items.get(0))를 다시 계산합니다. 컬럼마다 getDeclaredField reflection lookup이 발생하는데, params는 고정이고 item은 동질이라 매 청크의 결과가 같습니다.

변경 내용

  • setter: EgovReflectionSupport를 인스턴스 필드로 1회 생성해 재사용하도록 변경했습니다. 행별 할당이 N에서 1로 줄어듭니다. 해당 호출이 무상태이므로 인스턴스 공유가 안전합니다.
  • writer: sqlTypes를 최초 1회 산출한 뒤 캐시합니다. 청크별 reflection lookup이 N에서 1로 줄어듭니다. item 클래스가 달라지면 재산출하여 이질 item에 대한 정확성을 보존합니다.

동시성 안전

멀티스레드 Step에서 이질 클래스 청크가 동시에 처리될 때, itemClasssqlTypes가 어긋나는 torn-read가 생길 수 있습니다. 이를 막기 위해 클래스와 타입 배열을 불변 holder(SqlTypeCache)로 묶어 단일 volatile 참조로 원자 발행하고, 소비 시점에는 지역 변수로 한 번만 읽습니다. setParams()가 호출되면 캐시를 무효화합니다. 원본이 보장하던 청크 지역 변수 수준의 스레드 안전성을 유지하면서 캐시 이득을 얻습니다.

동작 보존

같은 입력에 대해 PreparedStatement 세팅 순서, 인자, SQL 타입 배열이 기존과 동일합니다. 단일 스레드 동작은 바뀌지 않습니다.

테스트 방법

외부 DB 없이 Proxy 기반 PreparedStatement로 결정적 검증 4건을 추가했습니다.

  • 행별 reflector가 단일 인스턴스로 재사용되는지 확인
  • 청크별 sqlTypes가 1회만 산출되고, item 클래스가 바뀌면 재산출되는지 확인
  • setParams 호출 시 캐시가 무효화되는지 확인
  • 두 스레드가 이질 클래스를 인터리빙(CyclicBarrier)하는 상황에서 torn-read가 없는지 확인(수정 전 재현, 수정 후 통과)

org.egovframe.rte.bat.core 모듈 전체 테스트 18건 green입니다.

영향 범위

  • 변경 파일은 writer와 setter 2개, 그리고 신규 테스트 1개입니다.
  • EgovReflectionSupport는 변경하지 않았습니다(별도 진행 중인 작업과 분리).
  • 같은 핫라인의 methodMap 경로 동시성은 upstream 선재 사항으로 본 PR 범위 밖이며, 차기 후보로 둡니다.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant