JPA - 프록시

2024. 1. 19. 16:14spring/JPA

엔티티를 조회할 때 연관된 엔티티들이 사용되지 않을 때도 있다.

@Entity
public class Member extends BaseEntity {
    @Id @GeneratedValue
    @Column(name = "MEMBER_ID")
    private Long id;
    @Column(name = "USERNAME")
    private String username;

    @ManyToOne
    @JoinColumn(name = "TEAM_ID")
    private Team team;
    
    //Getter, Setter
}


@Entity
public class Team {

    @Id @GeneratedValue
    @Column(name = "TEAM_ID")
    private Long id;
    private String name;

    @OneToMany(mappedBy = "team")
    private List<Member> members = new ArrayList<>();
    
    //Getter, Setter
}

 

 

public static void main(String[] args) {
    EntityManagerFactory emf = Persistence.createEntityManagerFactory("hello");
    EntityManager entityManager = emf.createEntityManager();

    EntityTransaction tx = entityManager.getTransaction();
    tx.begin();

    try {

        Member findMember = entityManager.find(Member.class, 1L);
        printMember(findMember);

        tx.commit();
    } catch (Exception e){
        e.printStackTrace();
        tx.rollback();
    } finally {
        entityManager.close();
    }

    emf.close();
}

private static void printMember(Member member) {
    String username = member.getUsername();
    System.out.println("username = " + username);
}

=>
Hibernate: 
    select
        member0_.MEMBER_ID as member_i1_3_0_,
        member0_.createdBy as createdb2_3_0_,
        member0_.createdDate as createdd3_3_0_,
        member0_.modifiedBy as modified4_3_0_,
        member0_.modifiedDate as modified5_3_0_,
        member0_.TEAM_ID as team_id7_3_0_,
        member0_.USERNAME as username6_3_0_,
        team1_.TEAM_ID as team_id1_7_1_,
        team1_.name as name2_7_1_ 
    from
        Member member0_ 
    left outer join
        Team team1_ 
            on member0_.TEAM_ID=team1_.TEAM_ID 
    where
        member0_.MEMBER_ID=?
username = uwer1

 

위 printMember 메소드는 회원 엔티티만 출력하는 데 사용하고 회원과 연관된 팀 엔티티는 전혀 사용하지 않는다.

 

printMember 메소드는 회원 엔티티만 사용하므로 em.find()로 회원 엔티티를 조회할 때 회원과 팀 엔티티를 함께 조회하는 것은 효율적이지 않다.

 

JPA는 이런 문제를 해결하려고 엔티티가 실제 사용될 때까지 데이터베이스 조회를 지연하는 방법을 제공하는데 이것을 지연 로딩이라고 한다. 실제로 팀 엔티티를 조회하는 시점에서 필요한 데이터를 조회하는 것이다.

 

그런데 지연 로딩 기능을 사용하려면 실제 엔티티 객체 대신에 데이터베이스 조회를 지연할 수 있는 가짜 객체가 필요한데 이것을 프록시 객체라 한다.

 

 

프록시 기초

JPA에서 식별자로 엔티티 하나를 조회할 때는 Entitymanager.find()를 사용한다. 이 메소드는 영속성 컨텍스트에 엔티티가 없으면 데이터베이스를 조회한다.

 

Member member1 = em.find(Member.class, 3L);

 

이렇게 엔티티를 직접 조회하면 조회한 엔티티를 실제 사용하든 사용하지 않든 데이버테이스를 조회하게 된다. 엔티티를 실제 사용하는 시점까지 데이터베이스 조회를 미루고 싶으면 EntityManager.getReference() 메소드를 사용하면 된다.

 

Member member1 = em.getReference(Member.class, 3L);

 

 이 메소드를 호출할 때 JPA는 데이터베이스를 조회하지 않고 실제 엔티티 객체도 생성하지 않는다. 대신에 데이터베이스 접근을 위임한 프록시 객체를 반환한다.

Member member1 = em.getReference(Member.class, 3L);
System.out.println(member1.getClass());

=>
class domain.member.Member$HibernateProxy$E0usjrwU

 

-프록시의 특징

프록시 클래스는 실제 클래스를 상속 받아서 만들어지므로 실제 클래스와 겉 모양이 같다. 따라서 사용하는 입장에서는 이것이 진짜 객체인지 프록시 객체인지 구분하지 않고 사용하면 된다.

프록시 구조

 

-프록시의 객체의 초기화

프록시 객체는 member.getName() 처럼 실제 사용될 때 데이터베이스를 조회해서 실제 엔티티 객체를 생성하는데 이것을 프록시 객체의 초기화라 한다. ( 이것도 가능하다 => Hibernate.initialize(member))

Member member1 = em.getReference(Member.class, 3L);

//Hibernate.initialize(member1); //강제 초기화
System.out.println("username = " + member1.getUsername());

 

프록시 초기화

 

(프록시 초기화 과정)

1. 프록시 객체에 member.getName()을 호출해서 실제 데이터를 조회한다.

2. 프록시 객체는 실제 엔티티가 생성되어 있지 않으면 영속성 컨텍스트에 실제 엔티티 생성을 요청하는데 이것을 초기화라고 한다.

3. 영속성 컨텍스트는 데이터베이스를 조회해서 실제 엔티티 객체를 생성한다.

4. 프록식 객체는 생성된 실제 엔티티 객체의 참조를 Member target 멤버변수에 보관한다.

5. 프록시 객체는 실제 엔티티 객체의 getName()을 호출해서 결과를 반환한다.

 

-프록시의 특징(중요)

- 프록시 객체는 처음 사용할 때 한 번만 초기화 된다.

 

- 프록시 객체를 초기화한다고 프록시 객체가 실제 엔티티로 바뀌는 것은 아니다. 프록시 객체가 초기화되면 프록시 객체를 통해서 실제 엔티티에 접근할 수 있다.

 

- 프록시 객체는 원본 엔티티를 상속받은 객체이므로 타입 체크 시에 주의해서 사용해야 한다.

=> (getClass() == 비교 대신 instanceof)

 

-  영속성 컨텍스트에 찾는 엔티티가 이미 있으면 데이터를 조회할 필요가 없으므로 em.getReference()를 호출해도 실제 엔티티를 반환한다.

 

- 초기화는 영속성 컨텍스트의 도움을 받아야 가능하다. 준영속 상태의 프록시를 초기화하면 문제가 발생한다.