[java] Java Querydsl을 사용하여 데이터베이스 테이블의 데이터 필드 제약 조건 유효성 검사하기

15 Nov 2023

java

Java에서 Querydsl을 사용하면 데이터베이스 테이블의 데이터 필드 제약 조건을 유효성 검사하는 것이 간편해집니다. 이 기능을 사용하면 데이터 입력 시 필드 값의 제약 조건을 확인하고 예외를 발생시킴으로써 데이터의 일관성과 정확성을 유지할 수 있습니다.

이 예제에서는 간단한 사용자 테이블을 가정하고, 사용자 이름 필드의 제약 조건을 확인하는 방법을 알아보겠습니다.

1. Querydsl 의존성 추가하기

먼저, 프로젝트의 pom.xml 파일에 Querydsl 의존성을 추가해야 합니다. 아래의 코드를 <dependencies> 태그 안에 추가해주세요.

<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-core</artifactId>
    <version>4.4.0</version>
</dependency>

<dependency>
    <groupId>com.querydsl</groupId>
    <artifactId>querydsl-apt</artifactId>
    <version>4.4.0</version>
    <scope>provided</scope>
</dependency>

2. 필드 제약 조건 검사하기

다음으로, Querydsl을 사용하여 필드 제약 조건을 검사하는 코드를 작성해보겠습니다. 아래의 예제 코드는 사용자 테이블의 이름 필드에 대한 검사를 수행하는 예제입니다.

import com.querydsl.core.types.dsl.Expressions;
import com.querydsl.core.types.dsl.StringExpression;
import com.querydsl.jpa.impl.JPAQueryFactory;

public class UserService {

    private JPAQueryFactory queryFactory; // Querydsl을 사용하기 위한 JPAQueryFactory

    // ...

    public void saveUser(User user) {
        if (isNameValid(user.getName())) {
            // 유효한 이름인 경우에만 데이터베이스에 저장
            userRepository.save(user);
        } else {
            throw new IllegalArgumentException("이름은 영문 대소문자로만 이루어져야 합니다.");
        }
    }

    private boolean isNameValid(String name) {
        StringExpression pattern = Expressions.constant("^[a-zA-Z]*$"); // 영문 대소문자 패턴 정의
        return queryFactory.selectOne()
                .from(QUser.user)
                .where(QUser.user.name.matches(pattern))
                .fetchFirst() == null;
    }
}

위의 코드에서 isNameValid 메소드는 주어진 이름이 영어 알파벳 대소문자로만 이루어져 있는지를 확인하는 메소드입니다. Querydsl을 사용하여 이름 필드에 대한 검사를 수행하고, 일치하는 레코드가 없으면 null을 반환합니다.

saveUser 메소드는 이름이 유효한 경우에만 데이터베이스에 사용자를 저장하고, 그렇지 않으면 IllegalArgumentException을 발생시킵니다.

3. 사용자 정보 입력하기

이제 위에서 작성한 UserService 클래스를 사용하여 사용자 정보를 입력하는 코드를 작성해보겠습니다.

public class Main {

    public static void main(String[] args) {
        User user = new User();
        user.setName("John"); // 유효한 이름 입력

        UserService userService = new UserService();
        userService.saveUser(user);
        
        System.out.println("사용자 정보가 저장되었습니다.");
    }
}

이 예제에서는 유효한 이름인 “John”을 입력하므로, UserService 클래스의 saveUser 메소드에서는 사용자 정보를 저장합니다.

만약 유효한 이름이 아니라면, IllegalArgumentException이 발생하고 “이름은 영문 대소문자로만 이루어져야 합니다.”라는 메시지가 출력됩니다.

마무리

Java Querydsl을 사용하여 데이터베이스 테이블의 데이터 필드 제약 조건을 유효성 검사하는 방법에 대해 알아보았습니다. Querydsl을 사용하면 데이터의 일관성과 정확성을 유지할 수 있으며, 예외를 발생시킴으로써 사용자에게 적절한 메시지를 전달할 수 있습니다.

더 자세한 내용은 Querydsl 공식 문서를 참고하시기 바랍니다.