쿼리 렌더링과 Visitor 패턴 학습 및 분석

[haeyoon1]

[전체 흐름]

jOOQ의 쿼리 생성 과정

DSLContext → QueryPart(AST) → Context(Visitor) → SQL 렌더링

1. DSLContext가 쿼리 객체를 생성한다
2. QueryPart들이 모여 쿼리 구조(AST)를 만든다
3. Context(Visitor)가 이 구조를 순회한다
4. SQL 문자열이 생성된다

---

1. 쿼리 렌더링이란?

jOOQ에서는 SQL을 처음부터 문자열로 만들지 않는다.

create.select(USER.ID, USER.NAME)
      .from(USER)
      .where(USER.ID.eq(1));

이 객체 구조를 SQL 문자열로 바꾸기 위해서는?

1. 자바 코드로 쿼리 구조 생성
2. QueryPart 객체 트리(AST)로 저장
3. 트리를 순회하면서
4. SQL 문자열로 변환

= 쿼리 렌더링(Query Rendering)

---

2. QueryPart 구조

QueryPart는 SQL을 구성하는 모든 요소의 공통 타입이다.

Field<?> field = BOOK.ID;
Table<?> table = BOOK;
Condition condition = BOOK.ID.eq(1);

• SQL은 문자열이 아니라 객체 구조로 표현됨
• 각 요소가 독립된 객체로 존재

즉 QueryPart는 SQL의 구조(AST)를 표현한다

SelectQuery
 ├── Field (BOOK.ID)
 ├── Table (BOOK)
 └── Condition (ID = 1)

---

2. Visitor 패턴 (Context)

Visitor 패턴이란?

객체 구조는 그대로 두고, 그 구조를 처리하는 로직을 바깥으로 분리하는 패턴

객체들이 이런 식으로 있다고 해보자.

• Field
• Table
• Condition

이 객체들 각각에 대해 할 수 있는 작업이 많다 → 객체 안에 다 넣으면 객체가 너무 많은 책임을 가짐

• SQL 문자열 만들기
• bind 값 모으기
• 디버깅 출력하기
• 통계 내기

그래서

• 객체는 “나는 Field다 / Table이다 / Condition이다” 같은 구조
• Visitor는 “그걸 어떻게 처리할지”라는 작업 처리

---

Context는 QueryPart를 순회하면서 처리하는 Visitor이다.

ctx.visit(queryPart);
/*
		ctx: Visitor 역할을 하는 객체
		visit(...): 방문 동작
		ctx.visit(queryPart): Visitor가 어떤 노드를 방문하기 시작하는 코드
*/

역할:

• QueryPart를 하나씩 방문
• 타입에 따라 다른 처리 수행

구조와 로직을 분리하기 위해 Visitor 패턴 사용

• QueryPart = 구조
• Context = 행위

---

5. 렌더링 과정

ctx.visit(query);

visitor가 query를 방문

실제 내부구현

    visit(field) { // 컨텍스트 레벨 공통 처리
        // 공통 처리 (before)
        visit0(field);
        // 공통 처리 (after)
    }
    
    visit0(internal) {  // 각 노드별 처리
        internal.accept(this);
    }

↓

DefaultRenderContext(SQL 문자열을 생성하는 Visitor 구현체) 내부

query.accept(ctx);  // 구조 만들기 

query에게 스스로 어떻게 렌더링할지 실행해보라고 명령

↓

query 내부

ctx.sql("select ");
ctx.visit(field);  // 내부적으로 field.accept(ctx); -> 실제 값 하나 출력

ctx.sql(" from ");
ctx.visit(table);  // 내부에서 accept

ctx.sql(" where ");
ctx.visit(condition);

↓

재귀 반복

visit → accept → visit → accept → ...

↓

최종 결과

select book.id
from book
where book.id = ?

---

결론: jOOQ의 쿼리 렌더링은

QueryPart 기반의 AST를 Context(Visitor)가 순회하면서 SQL 문자열로 변환하는 과정이다.