📌 [Java] DTO / 테스트 코드 / 유효성 검사 정리

📅 날짜

2025년 3월 27일

📝 학습 내용

---

4️⃣ DTO (Data Transfer Object) 계층

✅ DTO란?

• DTO는 계층 간 데이터 전달 객체로, Controller ↔ Service ↔ Dao 간 데이터 이동에 사용
• 필드, 생성자, getter/setter, toString 메서드로 구성됨

---

✅ UserDto.java

public class UserDto {
    private String userid;
    private String username;
    private String password;
    private String role; // ex: ROLE_USER, ROLE_ADMIN

    // 기본 생성자
    public UserDto() {}

    // 전체 필드 초기화 생성자
    public UserDto(String userid, String username, String password, String role) {
        this.userid = userid;
        this.username = username;
        this.password = password;
        this.role = role;
    }

    // Getter/Setter
    public String getUserid() { return userid; }
    public void setUserid(String userid) { this.userid = userid; }

    public String getUsername() { return username; }
    public void setUsername(String username) { this.username = username; }

    public String getPassword() { return password; }
    public void setPassword(String password) { this.password = password; }

    public String getRole() { return role; }
    public void setRole(String role) { this.role = role; }

    // 디버깅/출력용
    @Override
    public String toString() {
        return "UserDto [userid=" + userid + ", username=" + username +
               ", password=" + password + ", role=" + role + "]";
    }
}

---

✅ BookDto.java

public class BookDto {
    private String bookCode;
    private String bookName;
    private String publisher;
    private String isbn;

    // 기본 생성자
    public BookDto() {}

    // 모든 필드를 받는 생성자
    public BookDto(String bookCode, String bookName, String publisher, String isbn) {
        this.bookCode = bookCode;
        this.bookName = bookName;
        this.publisher = publisher;
        this.isbn = isbn;
    }

    // Getter/Setter
    public String getBookCode() { return bookCode; }
    public void setBookCode(String bookCode) { this.bookCode = bookCode; }

    public String getBookName() { return bookName; }
    public void setBookName(String bookName) { this.bookName = bookName; }

    public String getPublisher() { return publisher; }
    public void setPublisher(String publisher) { this.publisher = publisher; }

    public String getIsbn() { return isbn; }
    public void setIsbn(String isbn) { this.isbn = isbn; }

    @Override
    public String toString() {
        return "BookDto [bookCode=" + bookCode + ", bookName=" + bookName +
               ", publisher=" + publisher + ", isbn=" + isbn + "]";
    }
}

---

5️⃣ 테스트 코드 구조 (JUnit5)

✅ 테스트 목적

• 컨트롤러 실행 테스트 (FrontController → SubController)
• DAO 직접 DB 연동 테스트
• 테스트 프레임워크: JUnit5

---

✅ ControllerTests.java

class ControllerTests {
    FrontController fc = FrontController.getInstance(); // 싱글톤 인스턴스

    @Test
    @Disabled
    void test1() {
        // 회원가입 요청 구성
        Map<String, Object> params = new HashMap<>();
        params.put("endPoint", "/user");
        params.put("serviceNo", 1);
        params.put("userid", "user01");
        params.put("username", "홍길동");
        params.put("password", "1234");

        Map<String, Object> response = fc.execute(params);

        // 응답 출력
        response.forEach((k, v) -> System.out.println(k + " : " + v));
    }

    @Test
    void test2() {
        // 도서 등록 요청 구성
        Map<String, Object> params = new HashMap<>();
        params.put("endPoint", "/book");
        params.put("serviceNo", 1);
        params.put("bookCode", "11111111");
        params.put("bookName", "자바의 정석");
        params.put("publisher", "한빛출판사");
        params.put("isbn", "978-1234567890");

        Map<String, Object> response = fc.execute(params);

        // 응답 출력
        response.forEach((k, v) -> System.out.println(k + " : " + v));
    }
}

---

✅ DaoTests.java

class DaoTests {

    @Test
    @Disabled
    void test1() throws Exception {
        // DB 연결 확인
        UserDaoImpl userDao = UserDaoImpl.getInstance();
    }

    @Test
    @Disabled
    void test2() throws Exception {
        // 사용자 등록 테스트
        UserDaoImpl userDao = UserDaoImpl.getInstance();
        userDao.insert(new UserDto("aaa", "홍길동", "1234", "ROLE_USER"));
    }

    @Test
    void test3() throws Exception {
        // 도서 등록 테스트
        BookDaoImpl bookDao = BookDaoImpl.getInstance();
        bookDao.insert(new BookDto("1111", "리눅스 완전정복", "OS출판", "111-111"));
    }
}

---

6️⃣ 유효성 검사 로직

✅ 목적

• 잘못된 데이터가 Controller → Service → DB로 넘어가지 않도록 차단
• 주로 Controller에서 먼저 수행됨

---

✅ UserController의 유효성 검사

private boolean isValid(UserDto userDto) {
    if (userDto.getUserid() == null || userDto.getUserid().length() <= 4) {
        response.put("error", "userid의 길이는 최소 5자 이상이어야 합니다.");
        return false;
    }
    if (userDto.getUserid().matches("^[0-9].*")) {
        response.put("error", "userid의 첫 문자로 숫자가 들어올 수 없습니다.");
        return false;
    }
    return true;
}

설명:

• userid는 5자 이상이어야 함
• 첫 문자가 숫자이면 안 됨
• 유효하지 않으면 Map<String, Object>에 status: false, message 포함하여 반환

---

✅ BookController의 유효성 검사

private boolean isValid(BookDto bookDto) {
    if (bookDto.getBookCode() == null || bookDto.getBookCode().length() < 8) {
        response.put("error", "BookCode는 최소 8자 이상이어야 합니다.");
        return false;
    }
    if (bookDto.getBookCode().length() > 255) {
        response.put("error", "BookCode는 255자를 초과할 수 없습니다.");
        return false;
    }
    return true;
}

설명:

• bookCode는 최소 8자 이상, 255자 이하
• 에러 발생 시 상세한 메시지를 response에 담아 반환

---

🔥 정리

항목	요약
DTO	계층 간 데이터 전달용, POJO 클래스 구성
테스트	Controller 및 Dao 테스트를 통한 흐름 검증
유효성 검사	Controller 단계에서 필수 필드 검증 및 예외 차단 처리

---

🔗 참고 자료

• DTO 개념 및 작성 방식
• JUnit5 어노테이션: @Test, @Disabled
• Java 정규표현식 예제
• 데이터 유효성 검사 원칙