효율적인 자바 애플리케이션 설계를 위한 계층화 아키텍처와 개발 가이드라인

1. 애플리케이션 계층화 구조 (Layered Architecture)

대규모 엔터프라이즈 시스템의 복잡성을 관리하기 위해, 다음과 같은 논리적 계층 분리를 권장합니다. 각 계층은 하위 계층에 의존하며, 상위 계층으로 갈수록 구체적인 비즈니스 로직과 사용자 인터페이스를 담당합니다.

  • 외부 API 계층 (Open API Layer): 서비스 인터페이스를 외부에 노출하기 위한 계층입니다. HSF(RPC) 인터페이스, HTTP RESTful 인터페이스 또는 게이트웨이 제어 로직이 여기에 포함됩니다.
  • 표현 계층 (View Layer): 사용자에게 정보를 보여주는 단계입니다. 템플릿 엔진 렌더링(Thymeleaf, JS)이나 모바일 앱용 데이터 가공을 담당합니다.
  • 웹 계층 (Web/Controller Layer): 요청 제어, 파라미터 유효성 검증, 공통 처리를 수행하며 복잡하지 않은 비즈니스 로직을 직접 처리하기도 합니다.
  • 서비스 계층 (Service Layer): 구체적인 비즈니스 도메인 로직이 구현되는 핵심 계층입니다.
  • 매니저 계층 (Manager Layer): 서비스 계층 하단에서 공통적인 인프라나 복합 로직을 처리합니다. 주요 역할은 다음과 같습니다.
    • 제3자(외부) 플랫폼 API 연동 및 예외 변환 처리
    • 캐시 처리, 미들웨어 연동 등 서비스 계층의 공통 기능 모듈화
    • 여러 DAO를 조합하여 범용적인 데이터 접근 기능 제공
  • 데이터 접근 계층 (DAO Layer): MySQL, Oracle, NoSQL 등 데이터베이스와 직접 상호작용하는 계층입니다.

2. 영역별 데이터 모델 규약 (Domain Model)

계층 간 데이터 전달 시 명확한 목적을 가진 객체를 사용해야 합니다.

  • DO (Data Object): 데이터베이스 테이블 구조와 직접 매핑되는 객체입니다.
  • DTO (Data Transfer Object): 서비스나 매니저 계층에서 외부로 데이터를 전달할 때 사용하는 객체입니다.
  • BO (Business Object): 비즈니스 로직을 포함하는 객체로, 서비스 내부에서 주로 사용됩니다.
  • VO (View Object): 화면단에 데이터를 전달하기 위해 최적화된 객체입니다.
  • Query: 조회를 위한 파라미터를 담는 객체입니다. 파라미터가 2개 이상일 경우 Map 대신 전용 객체 사용을 권장합니다.

3. 예외 처리와 로깅 가이드라인

안정적인 시스템 운영을 위해 예외 처리와 로깅은 체계적이어야 합니다.

예외 처리 원칙

  • 흐름 제어 금지: 예외를 if-else와 같은 비즈니스 흐름 제어용으로 사용해서는 안 됩니다.
  • 상세 예외 포착: catch(Exception e)로 묶기보다 구체적인 예외 타입을 지정하여 대응해야 합니다.
  • DAO 계층: 모든 예외를 세밀하게 분리하기 어려우므로 DAOException으로 래핑하여 상위로 던지되, 별도의 로그 출력은 지양합니다(상위 계층에서 중복 로그 방지).
  • 웹 계층: 예외를 상위로 방치하지 말고, 반드시 적절한 에러 페이지나 상태 코드로 변환하여 사용자에게 친절한 응답을 제공해야 합니다.

로깅 규약

로그를 기록할 때는 시스템 성능과 추적성을 동시에 고려해야 합니다.

// 권장하는 SLF4J 로거 선언 방식
private static final Logger logger = LoggerFactory.getLogger(MemberService.class);

// 로그 기록 시 객체를 JSON으로 변환하지 말 것 (toString 사용 권장)
logger.info("사용자 정보 조회 성공: {}", memberAccount.toString());

4. 자바 프로그래밍 실무 가이드

코드의 가독성과 안전성을 높이기 위한 필수 규칙입니다.

  • POJO 설계: toString() 메서드를 반드시 구현하여 문제 발생 시 객체 상태 추적을 용이하게 합니다. 또한, 특정 필드 xxx에 대해 isXxx()와 getXxx() 메서드가 공존하면 직렬화 프레임워크에서 혼선이 발생할 수 있으므로 피해야 합니다.
  • 배열 처리: String.split() 사용 시 구분자 뒤에 빈 값이 있는 경우 IndexOutOfBoundsException이 발생할 수 있으므로 배열 크기 확인이 필수적입니다.
String data = "user,admin,,";
String[] tokens = data.split(",");
// 구분자가 연속되거나 끝에 위치할 경우 배열 길이가 예상과 다를 수 있음
if (tokens.length > 2) {
    String role = tokens[2];
}

5. 멀티스레드와 스레드 풀(Thread Pool) 관리

스레드 자원은 시스템의 핵심 자원이므로 명시적인 관리가 필요합니다.

  • ThreadPoolExecutor 사용 강제: Executors.newFixedThreadPool() 등은 내부 대기 큐가 Integer.MAX_VALUE로 설정되어 메모리 부족(OOM)을 유발할 수 있습니다. 반드시 생성자를 통해 제한적인 큐와 스레드 수를 설정해야 합니다.
// 명시적 스레드 풀 생성 예시
ThreadPoolExecutor customExecutor = new ThreadPoolExecutor(
    10,                     // corePoolSize
    50,                     // maximumPoolSize
    60L,                    // keepAliveTime
    TimeUnit.SECONDS,       // unit
    new LinkedBlockingQueue<Runnable>(500), // workQueue
    new CustomThreadFactory("Worker-"),     // threadFactory
    new ThreadPoolExecutor.AbortPolicy()    // handler
);

스레드 풀 작동 프로세스

  1. 현재 실행 중인 스레드가 corePoolSize보다 적으면 즉시 스레드를 생성하여 처리합니다.
  2. corePoolSize가 가득 차면 작업을 workQueue에 담습니다.
  3. 대기 큐마저 가득 차면 maximumPoolSize까지 스레드를 추가로 생성합니다.
  4. 모든 자원이 한계에 도달하면 RejectedExecutionHandler 전략에 따라 작업을 거부하거나 예외를 발생시킵니다.

6. 라이브러리 및 의존성 관리

중복 개발을 피하고 검증된 라이브러리를 사용합니다.

  • 표준 유틸리티 활용: JSON 처리는 Fastjson, MD5는 Commons-codec, 컬렉션 조작은 Guava나 Apache Commons Collections를 우선적으로 사용합니다.
  • 버전 관리: 프로젝트의 pom.xml에서 <dependencyManagement>를 사용하여 모든 하위 모듈의 라이브러리 버전을 중앙 제어함으로써 버전 충돌을 방지합니다.

태그: java SoftwareArchitecture ThreadPoolExecutor SLF4J DesignPatterns

11월 2일 21:30에 게시됨