📌 [Java] FrontController 기반 웹 애플리케이션 구조 정리

📅 날짜

2025년 3월 27일

📝 학습 내용

---

1️⃣ 프로젝트 전체 구조 개요

✅ 개요

본 프로젝트는 Java로 작성된 웹 백엔드 시스템 구조로,

FrontController 패턴을 기반으로 모든 요청을 하나의 진입점에서 받아 처리하고,

기능별 SubController로 분기하여 처리하는 구조이다.

---

✅ 전체 처리 흐름

[View 또는 테스트 코드]
     ↓
[FrontController]
     ↓ (endPoint 기준 분기)
[SubController.execute()]
     ↓
[Service (비즈니스 로직)]
     ↓
[Dao (DB 접근)]
     ↓
[MySQL - bookDB]

---

✅ 요청 방식 예시 (Map 기반)

Map<String, Object> params = new HashMap<>();
params.put("endPoint", "/user");       // 또는 "/book"
params.put("serviceNo", 1);            // 서비스 번호
params.put("userid", "user01");
params.put("username", "홍길동");
params.put("password", "1234");

---

2️⃣ Controller 계층 구조

✅ FrontController.java

public class FrontController {
    // 각 요청 endPoint에 따라 SubController를 저장하는 Map
    private Map<String, SubController> map = new HashMap<>();
    private static FrontController instance; // 싱글톤 인스턴스

    private FrontController() {
        init(); // 컨트롤러 초기화
    }

    // 싱글톤 객체 생성 및 반환
    public static FrontController getInstance() {
        if (instance == null) instance = new FrontController();
        return instance;
    }

    // endPoint 별 SubController 등록
    private void init() {
        map.put("/user", new UserController());
        map.put("/book", new BookController());
    }

    // 실행 메서드: 요청에 따라 적절한 SubController 실행
    public Map<String, Object> execute(Map<String, Object> params) {
        String endPoint = (String) params.get("endPoint"); // "/user" or "/book"
        SubController controller = map.get(endPoint); // 해당 컨트롤러 찾기
        return controller.execute(params); // 실행
    }
}

---

✅ SubController.java

// 공통 인터페이스
public interface SubController {
    // 모든 하위 컨트롤러는 이 메서드를 구현해야 함
    Map<String, Object> execute(Map<String, Object> params);
}

---

✅ UserController.java (유효성 검사 포함)

// 사용자 데이터의 유효성 검사를 담당
private boolean isValid(UserDto userDto) {
    // userid가 최소 5자 이상인지 확인
    if (userDto.getUserid() == null || userDto.getUserid().length() <= 4) {
        response.put("error", "userid의 길이는 최소 5자 이상이어야 합니다.");
        return false;
    }
    // userid가 숫자로 시작하는지 확인
    if (userDto.getUserid().matches("^[0-9].*")) {
        response.put("error", "userid의 첫 문자로 숫자가 들어올 수 없습니다.");
        return false;
    }
    return true; // 통과 시 true 반환
}

---

✅ BookController.java (유효성 검사 포함)

// 도서 코드 유효성 검사
private boolean isValid(BookDto bookDto) {
    // bookCode 최소 길이 8자
    if (bookDto.getBookCode() == null || bookDto.getBookCode().length() < 8) {
        response.put("error", "BookCode는 최소 8자 이상이어야 합니다.");
        return false;
    }
    // 최대 길이 255자 제한
    if (bookDto.getBookCode().length() > 255) {
        response.put("error", "BookCode는 255자를 초과할 수 없습니다.");
        return false;
    }
    return true;
}

---

3️⃣ DAO 계층 구조

✅ 공통 사항

• DB: MySQL - bookDB
• 연결 정보:
  • URL: jdbc:mysql://localhost:3306/bookDB
  • ID: root
  • PW: 1234
• 싱글톤 패턴으로 관리됨

---

✅ UserDaoImpl.java (insert 기능)

// 사용자 등록
public int insert(UserDto userDto) throws SQLException {
    try {
        // SQL 준비
        pstmt = conn.prepareStatement("insert into tbl_user values(?,?,?,?)");
        // 파라미터 바인딩
        pstmt.setString(1, userDto.getUserid());
        pstmt.setString(2, userDto.getUsername());
        pstmt.setString(3, userDto.getPassword());
        pstmt.setString(4, "ROLE_USER"); // 기본 사용자 권한
        // 실행 및 결과 반환
        return pstmt.executeUpdate();
    } catch (SQLException e) {
        // 예외 발생 시 메시지와 함께 throw
        throw new SQLException("USERDAO's INSERT SQL EXCEPTION!!");
    } finally {
        // 리소스 정리
        try { pstmt.close(); } catch (Exception e2) {}
    }
}

---

✅ BookDaoImpl.java (insert 기능)

// 도서 등록
public int insert(BookDto bookDto) throws SQLException {
    try {
        // SQL 준비
        pstmt = conn.prepareStatement("insert into tbl_book values(?,?,?,?)");
        // 파라미터 설정
        pstmt.setString(1, bookDto.getBookCode());
        pstmt.setString(2, bookDto.getBookName());
        pstmt.setString(3, bookDto.getPublisher());
        pstmt.setString(4, bookDto.getIsbn());
        // 실행
        return pstmt.executeUpdate();
    } catch (SQLException e) {
        // 예외 처리
        throw new SQLException("BOOKDAO's INSERT SQL EXCEPTION!!");
    } finally {
        // 리소스 정리
        try { pstmt.close(); } catch (Exception e2) {}
    }
}

---

🔥 정리

• FrontController 패턴으로 모든 요청을 통합 처리
• Controller는 endPoint와 serviceNo로 기능 분기
• Dao에서는 DB에 직접 접근하며 insert 구현 완료
• 유효성 검사도 포함되어 있어 실무 흐름과 유사하게 구성됨

---

🔗 참고 자료

• Java MVC 아키텍처 설계
• 싱글톤 패턴 (Singleton Design Pattern)
• DAO 패턴과 JDBC 사용법
• JUnit 5 테스트 구조