서론

깨끗한 집에 씻지 않은 사람이 들어오면 집은 금방 더러워질 것이다.
하지만 현관에 자동 샤워기가 있다면, 들어오는 사람은 깨끗해지고 집은 청결을 유지할 수 있다.

ACL(안티 커럽션 레이어: 다른말로 반부패 계층) 는 이런 자동 샤워기와 같다.

ACL은 계층 또는 시스템 간의 “오염”을 방지한다. 내부 도메인 모델의 순수성을 유지하기 위해 그 역할은 매우 중요하다.

이 문서에서는 ACL의 정의와 실제 구현 방법을 설명하여, ACL을 정확히 이해하고 적용할 수 있도록 한다.

ACL 구현 방법

ACL 구현 방식은 다양하지만, 핵심적인 3가지 구성 요소는 Translator, Adapter, Facade이다.

Translator / Mapper

외부 모델을 내부 모델로 변환한다.
외부 모델은 내부 모델과 비교해 용어, 규칙, 구조가 다를 수 있으므로 이를 번역한다.

예시:

public class LegacyUserTranslator {
    public User toDomain(LegacyUserDto dto) {
        return new User(dto.fullName, dto.emailAddress, dto.statusCode == 0);
    }
}

Adapter / Gateway

시스템 간 인터페이스 불일치를 해결한다. 예를 들어, 외부 시스템이 fetchUser(String id) 형태를 요구하지만, 내부 도메인은 User getById(UserId id) 형태를 필요로 할 수 있다.

예시:

public interface ExternalUserPort {
    User getUserById(String id); // 내부에서 기대하는 형태
}

public class LegacyUserApiAdapter implements ExternalUserPort {
    private final LegacyApiClient client;

    public User getUserById(String id) {
        LegacyUserDto dto = client.fetchUser(id); // 외부 시스템 호출
        return new LegacyUserTranslator().toDomain(dto); // 변환
    }
}

Facade

여러 외부 호출이나 복잡한 처리를 도메인 친화적인 형태로 묶어 제공한다. 복잡한 상호작용을 단일 메서드로 캡슐화하여 순수성, 가독성, 유지보수성을 높인다.

예시:

public class ExternalUserFacade {
    private final ExternalUserPort userPort;
    private final ExternalPermissionPort permissionPort;

    public DomainUserProfile getUserProfile(String userId) {
        User user = userPort.getUserById(userId);
        List<String> permissions = permissionPort.getPermissions(userId);
        return new DomainUserProfile(user, permissions);
    }
}