spring jpa & egov & maria

AI 생성 이미지: spring jpa & egov & maria

대부분의 Spring 애플리케이션에서는 `@PersistenceContext`로 `EntityManager`를 주입받고, `@Transactional`으로 트랜잭션을 처리합니다. 하지만 일부 환경(예: 전통적 서블릿 컨테이너에서의 독립 실행이나 Spring MVC가 아닌 구성)에서는 Spring의 프록시 주입과 트랜잭션 어드바이스를 기대할 수 없어, `EntityManagerFactory`를 직접 주입받아 JPA의 생명주기와 트랜잭션을 수동으로 관리해야 할 때가 있습니다.

---

1. 📄 핵심 JPA 설정 (XML)

다음 XML은 JPA를 구성하기 위한 기본 요소들입니다. `dataSource`와 `LocalContainerEntityManagerFactoryBean`을 정의하며, 예제에서는 `hibernate.hbm2ddl.auto`가 create로 설정되어 있어 애플리케이션 시작 시마다 테이블을 재생성합니다. 운영 환경에서는 이 설정을 사용하면 데이터가 삭제되므로 절대로 권장되지 않습니다.

<!-- 데이터 소스 (DBCP 사용) -->
<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource" destroy-method="close">
    <property name="driverClassName" value="org.mariadb.jdbc.Driver"/>
    <property name="url" value="jdbc:mysql://127.0.0.1:3306/board?..." />
    <property name="username" value="root"/>
    <property name="password" value="1234"/>
</bean>

<!-- JPA 벤더 어댑터 (Hibernate) -->
<bean id="jpaVendorAdapter" class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter">
    <property name="showSql" value="true"/>
    <property name="generateDdl" value="true"/>
    <property name="databasePlatform" value="org.hibernate.dialect.MariaDB10Dialect"/>
</bean>

<!-- EntityManagerFactory (emf) 설정 -->
<bean class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean" id="emf">
    <property name="packagesToScan" value="egovframework" />
    <property name="dataSource" ref="dataSource" />
    <property name="jpaVendorAdapter" ref="jpaVendorAdapter"/>
    <property name="jpaProperties">
        <props>
            <prop key="hibernate.hbm2ddl.auto">create</prop> <!-- ★ 중요: 실행 시마다 테이블 재생성 -->
        </props>
    </property>
</bean>
            

주의: `hibernate.hbm2ddl.auto`를 `create`로 두면 매번 스키마가 초기화됩니다. 개발 또는 테스트 전용으로만 사용하고, 운영 환경에서는 `validate`나 빈 값으로 두어야 합니다. 또한, 운영 환경에서는 마이그레이션 도구(예: Flyway, Liquibase)를 적용하는 것이 안전합니다.

---

2. 👨‍💻 EntityManagerFactory를 통한 수동 JPA 관리

Spring이 `EntityManager` 프록시를 제공하지 않는 상황에서는, 컨테이너에 등록된 `EntityManagerFactory` 빈을 주입받아 직접 `EntityManager`를 생성하고 트랜잭션을 관리해야 합니다. 이 방식은 JPA 표준에 충실하지만, 수작업이 많고 예외 처리에 주의가 필요합니다.

2.1. EntityManagerFactory 주입

XML에서 선언한 `id="emf"` 빈을 `@Autowired`로 주입받아 사용합니다. 이 경우 `@PersistenceContext`나 Spring이 관리하는 `EntityManager`는 사용할 수 없다고 가정합니다.

@Autowired
private EntityManagerFactory emf;

// @PersistenceContext 및 EntityManager는 Spring의 관리를 받지 못해 사용 불가능한 상태를 가정합니다.
// @PersistenceContext 사용안됨
// EntityManager em; 사용안됨
        

2.2. 수동 트랜잭션 및 엔티티 처리

`EntityManagerFactory#createEntityManager()`로 획득한 `EntityManager`는 직접 열고 닫아야 합니다. 트랜잭션은 `EntityTransaction`으로 명시적으로 제어합니다. 아래 예시는 기본적인 트랜잭션 패턴으로, 예외 발생 시 롤백하고 항상 `em.close()`로 리소스를 해제합니다.

// 1. EntityManager 획득 (트랜잭션 단위)
EntityManager em = emf.createEntityManager();

// 2. 트랜잭션 시작
EntityTransaction tx = em.getTransaction();
tx.begin();

try {
    // 3. JPA 영속성 작업 수행
    em.persist(boardInfoVO);
    
    // 4. 트랜잭션 커밋
    tx.commit();
} catch (Exception e) {
    if (tx.isActive()) {
        tx.rollback(); // 오류 발생 시 롤백
    }
    throw e;
} finally {
    // 5. EntityManager 닫기 (필수)
    em.close();
}
        

---

🚀 이 주제, 우리 서비스에 어떻게 적용할까요?

spring jpa & egov & maria를 실제 서비스와 조직에 녹여보고 싶다면, 현재 아키텍처와 운영 방식을 한 번 점검해 보는 것부터 시작해 보세요. 팀 위키나 기술 블로그, 사내 스터디 주제로도 아주 좋습니다.

이 글이 도움이 됐다면, 비슷한 엔터프라이즈 사례 글들도 함께 살펴보면서 우리 조직에 맞는 운영 상용구를 정의해 보세요.

AI 생성 이미지: spring jpa & egov & maria

3. 🌟 결론 및 권장 사항

수동으로 `EntityManager`와 트랜잭션을 관리하는 방식은 표준 JPA의 전형적인 사용 방법이며, 특정 제약 환경에서는 유일한 선택일 수 있습니다. 다만 Spring 환경에서는 가능한 한 `@Transactional`과 `@PersistenceContext` 기반의 프록시 주입을 사용하여 트랜잭션 경계를 프레임워크에 위임하는 편이 유지보수와 안정성 측면에서 유리합니다.

만약 `@PersistenceContext`가 작동하지 않는다면, 우선 `JpaTransactionManager`가 제대로 설정되었는지와 대상 클래스가 Spring Bean으로 등록되어 AOP 대상이 되는지 확인하세요. 환경을 정비해 `@Transactional`을 적용할 수 있다면 운영상 이점이 큽니다.

© 2025 Spring 개발자 노트.

함께 보면 좋은 엔터프라이즈 사례

• 보안취약점 자동탐지와 랜섬웨어 대응 플레이북·테스트 자동화 전략
• 실무: 대시보드 SLO 기반 알림조정과 노이즈 감소전략 및 자동조정
• 제로트러스트 네트워크로 DevOps 보안경계 재설계 실전 가이드