@Transient 어노테이션에 대한 이해

📌 들어가며

이번 포스팅에서는 @Transient 어노테이션이 무엇인지, 그리고 그 쓰임에 대하여 정리하고자 합니다. 새롭게 합류한 도메인팀의 스프링부트 로직에서 @Transient 가 다수 발견되어 정리하게 되었습니다.

 

 

📌 @Transient 란

@Transient는 엔티티 객체의 데이터와 테이블의 컬럼(column)과 매핑하고 있는 관계를 제외하기 위해 사용합니다. 주로 보안정보나 굳이 테이블에 저장할 필요는 없지만 도메인 로직 또는 비즈니스 로직상 계산을 위해 필요한 경우 해당 어노테이션을 활용합니다.

 

더 정확히 표현하면 JPA의 가장 큰 특징 중 하나인 영속성 컨텍스트 대상에서 제외시키기 위하여 사용됩니다.

또한 JPA 의 컬럼 매핑 레퍼런스 어노테이션은 Field, Property 방식을 지원하기 떄문에 필드와 메서드에 선언할 수 있습니다.

 

@Transient 어노테이션을 설명하기 위해 가장 많이 사용하는 예시는 회원(Member) 엔티티의 confirmPassword 필드 입니다.

 

@Entity
public class Member{
    @Id
    private Long id; // PK
    private String userId; // 사용자 아이디
    private String password; // 비밀번호
    private String confirmPassword; // 비밀번호 재입력
}

 

위의 엔티티 객체에서 confirmPassword는 굳이 저장할 필요가 없는 필드값입니다. password 와의 일치여부만 확인하면 되므로 이와 같은 데이터 필드를 @Transient 어노테이션을 사용해 관리할 필요가 없는 데이터임을 선언해주면 됩니다.

 

@Entity
public class Member{
    @Id
    private Long id;
    private String userId;
    private String password;

    // [1] @Transient 선언
    javax.persistence.@Transient 
    private String confirmPassword; // 비밀번호 재입력 매핑 제외
}

 

 

📌 사용시 주의해야할 점

JPA의 엔티티 객체에 대한 접근방식이 어떻게 되어있느냐에 따라 @Transient 어노테이션의 위치를 이에 맞게 선언해주어야 합니다.

JPA의 엔티티 접근방식은 @Id 어노테이션의 위치에 따라 결정되며 엔티티의 모든 필드 또는 상속된 엔티티의 계층에 대해서도 일관성 있게 적용되어야 @Transient 어노테이션이 정상적으로 작동하게 됩니다.

 

// [1] 필드 방식
@Entity
public class Member{
    @Id
    private Long id;
    private String name;
    ...
}

// [2] 메서드 방식
@Entity
public class Member{
    private Long id;
    private String name;
    
    @Id
    public Long getId(){return this.id;}
    public void setId(Long id){this.id = id;}
    
    public String getName(){return this.name;}
    public void setName(String name){this.name = name;}
}

 

 

@Entity
public class Member{
    @Id // 필드 방식
    private Long id;
    private String userId;
    private String password;
    private String confirmPassword;
    
    @Transient // JPA에서 인식 불가 → 동작 안함 필드에 @Transient 어노테이션 선언 필요
    public String getComfirmPassword(){ return this.confirmPassword; }
}

 

 

 

 

참고:

• 자바 ORM 표준 JPA 프로그래밍
• https://gmoon92.github.io/jpa/2019/09/29/what-is-the-transient-annotation-used-for-in-jpa.html