트랜잭션 AOP 주의 사항 - 프록시 내부 호출1
참고
여기서 설명하는 내용은
스프링 핵심원리 고급편 [13. 실무 주의사항 - 프록시와 내부 호출 문제]에서 다루는 내용과 같은 문제를 다룬다.
이렇게 한번 더 언급하는 이유는 그 만큼 실무에서 많이 만나는 주제이고,
많은 개발자들이 이 문제를 이해하지 못해서 고통받기 때문이다.
여기서는 트랜잭션 AOP에 관점에서 설명한다
@Transactional 을 사용하면 스프링의 트랜잭션 AOP가 적용된다.
트랜잭션 AOP는 기본적으로 프록시 방식의 AOP를 사용한다.
앞서 배운 것 처럼
@Transactional 을 적용하면 프록시 객체가 요청을 먼저 받아서 트랜잭션을 처리하고,
실제 객체를 호출해준다.
따라서 트랜잭션을 적용하려면 항상 프록시를 통해서 대상 객체(Target)을 호출해야 한다.
이렇게 해야 프록시에서 먼저 트랜잭션을 적용하고, 이후에 대상 객체를 호출하게 된다.
만약 프록시를 거치지 않고 대상 객체를 직접 호출하게 되면 AOP가 적용되지 않고, 트랜잭션도 적용되지 않는다.
AOP를 적용하면 스프링은 대상 객체 대신에 프록시를 스프링 빈으로 등록한다.
따라서 스프링은 의존관계 주입시에 항상 실제 객체 대신에 프록시 객체를 주입한다.
프록시 객체가 주입되기 때문에 대상 객체를 직접 호출하는 문제는 일반적으로 발생하지 않는다
하지만 대상 객체의 내부에서 메서드 호출이 발생하면 프록시를 거치지 않고
대상 객체를 직접 호출하는 문제가 발생한다.
이렇게 되면 @Transactional 이 있어도 트랜잭션이 적용되지 않는다.
실무에서 반드시 한번은 만나서 고생하는 문제이기 때문에 꼭 이해하고 넘어가자.
예제를 통해서 내부 호출이 발생할 때 어떤 문제가 발생하는지 알아보자.
먼저 내부 호출이 발생하는 예제를 만들어보자.
InternalCallV1Test
@Slf4j
@SpringBootTest
public class InternalCallV1Test {
@Autowired
CallService callService;
@Test
void printProxy() {
log.info("callService class={}", callService.getClass());
}
@Test
void internalCall() {
callService.internal();
}
@Test
void externalCall() {
callService.external();
}
@TestConfiguration
static class InternalCallV1TestConfig{
@Bean
CallService callService() {
return new CallService();
}
}
static class CallService{
public void external() { // 해당 메소드 자체에는 트랜잭션이 붙어있지않음
log.info("call external");
printTxInfo();
internal(); // 이 메소드는 트랜잭션이 붙어있으므로 , 트랜잭션이 되길 예상하고 사용
}
@Transactional
public void internal() {
log.info("call internal");
printTxInfo();
}
private void printTxInfo() {
boolean txActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("tx active ={}", txActive);
// boolean readOnly = TransactionSynchronizationManager.isCurrentTransactionReadOnly();
// log.info("tx readOnly ={}", readOnly);
}
}
}
external() 은 트랜잭션이 없다.
internal() 은 @Transactional 을 통해 트랜잭션을 적용한다.
@Transactional 이 하나라도 있으면 트랜잭션 프록시 객체가 만들어진다.
그리고 callService 빈을 주입 받으면 트랜잭션 프록시 객체가 대신 주입된다.
internalCall() 실행
@Transactional
public void internal() {
log.info("call internal");
printTxInfo();
}
1. 클라이언트인 테스트 코드는 callService.internal() 을 호출한다. 여기서 callService 는 트랜잭션 프록시이다.
2. callService 의 트랜잭션 프록시가 호출된다.
3. internal() 메서드에 @Transactional 이 붙어 있으므로 트랜잭션 프록시는 트랜잭션을 적용한다.
4. 트랜잭션 적용 후 실제 callService 객체 인스턴스의 internal() 을 호출한다.
실제 callService 가 처리를 완료하면 응답이 트랜잭션 프록시로 돌아오고, 트랜잭션 프록시는 트랜잭션을 완료한다.
TransactionInterceptor 가 남긴 로그를 통해 트랜잭션 프록시가 트랜잭션을 적용한 것을 확인할 수 있다.
CallService 가 남긴 tx active=true 로그를 통해 트랜잭션이 적용되어 있음을 확인할 수 있다
externalCall() 실행
public void external() { // 해당 메소드 자체에는 트랜잭션이 붙어있지않음
log.info("call external");
printTxInfo();
internal(); // 이 메소드는 트랜잭션이 붙어있으므로 , 트랜잭션이 되길 예상하고 사용
}
external() 은 @Transactional 애노테이션이 없다.
따라서 트랜잭션 없이 시작한다.
그런데 내부에서 @Transactional 이 있는 internal() 을 호출하는 것을 확인할 수 있다.
이 경우 external() 은 트랜잭션이 없지만, internal() 에서는 트랜잭션이 적용되는 것 처럼 보인다.
실행 로그를 보면 트랜잭션 관련 코드가 전혀 보이지 않는다.
프록시가 아닌 실제 callService 에서 남긴 로그만 확인된다.
추가로 internal() 내부에서 호출한 tx active=false 로그를 통해 확실히 트랜잭션이 수행되지 않은 것을 확인할 수 있다.
우리의 기대와 다르게 internal() 에서 트랜잭션이 전혀 적용되지 않았다.
왜 이런 문제가 발생하는 것일까?
프록시와 내부 호출
실제 호출되는 흐름을 천천히 분석해보자.
1. 클라이언트인 테스트 코드는 callService.external() 을 호출한다. 여기서 callService 는 트랜잭션 프록시이다.
2. callService 의 트랜잭션 프록시가 호출된다.
3. external() 메서드에는 @Transactional 이 없다.
따라서
트랜잭션 프록시는 트랜잭션을 적용하지 않는다.
4. 트랜잭션 적용하지 않고, 실제 callService 객체 인스턴스의 external() 을 호출한다.
5. external() 은 내부에서 internal() 메서드를 호출한다. 그런데 여기서 문제가 발생한다
[실제 service내부에서 호출되므로 트랜잭션이 적용 될 수가 없다.]
문제 원인
자바 언어에서 메서드 앞에 별도의 참조가 없으면 this 라는 뜻으로 자기 자신의 인스턴스를 가리킨다.
this.internal();
internal();
결과적으로 자기 자신의 내부 메서드를 호출하는 this.internal() 이 되는데,
여기서 this 는 자기 자신을 가리키므로, 실제 대상 객체( target )의 인스턴스를 뜻한다.
[위 그림의 5번 상황을 보면, 실제 service의 메소드를 호출 후 다른 메소드를 호출하려니까 실제 service의 메소드가 호출되는것이다.]
결과적으로 이러한 내부 호출은 프록시를 거치지 않는다.
따라서 트랜잭션을 적용할 수 없다.
결과적으로 target 에 있는 internal() 을 직접 호출하게 된 것이다.
프록시 방식의 AOP 한계
@Transactional를 사용하는 트랜잭션 AOP는 프록시를 사용한다.
프록시를 사용하면 메서드 내부 호출에 프록시를 적용할 수 없다.
그렇다면 이 문제를 어떻게 해결할 수 있을까?
가장 단순한 방법은 [ 보통 실무에서 하는 방법]
내부 호출을 피하기 위해 internal() 메서드를 별도의 클래스로 분리하는 것이다
[같은 클래스에 있으면 this로 인해 트랜잭션이 적용되지않으므로
다른 클래스로 분리하고 프록시객체를 주입받아서 호출하는 방식으로 트랜잭션을 적용되게끔 하려나 보다. ]
트랜잭션 AOP 주의 사항 - 프록시 내부 호출2
메서드 내부 호출 때문에 트랜잭션 프록시가 적용되지 않는 문제를 해결하기 위해
internal() 메서드를 별도의 클래스로 분리하자.
InternalCallV2Test
@Slf4j
@SpringBootTest
public class InternalCallV2Test {
@Autowired
CallService callService;
@Test
void printProxy() {
log.info("callService class={}", callService.getClass());
}
@Test
void externalCallV2() {
callService.external();
}
@TestConfiguration
static class InternalCallV1TestConfig{
@Bean
InternalService internalService() {
return new InternalService();
}
@Bean
CallService callService() {
return new CallService(internalService());
}
}
@RequiredArgsConstructor
static class CallService{
private final InternalService internalService;
public void external() { // 해당 메소드 자체에는 트랜잭션이 붙어있지않음
log.info("call external");
printTxInfo();
internalService.internal(); // 이 메소드는 트랜잭션이 붙어있으므로 , 트랜잭션이 되길 예상하고 사용
}
private void printTxInfo() {
boolean txActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("tx active ={}", txActive);
}
}
static class InternalService {
@Transactional
public void internal() {
log.info("call internal");
printTxInfo();
}
private void printTxInfo() {
boolean txActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("tx active ={}", txActive);
}
}
}
InternalService 클래스를 만들고 internal() 메서드를 여기로 옮겼다.
이렇게 메서드 내부 호출을 외부 호출로 변경했다.
CallService 에는 트랜잭션 관련 코드가 전혀 없으므로 트랜잭션 프록시가 적용되지 않는다.
InternalService 에는 트랜잭션 관련 코드가 있으므로 트랜잭션 프록시가 적용된다.
실제 호출되는 흐름을 분석해보자.
1. 클라이언트인 테스트 코드는 callService.external() 을 호출한다.
2. callService 는 실제 callService 객체 인스턴스이다.
3. callService 는 주입 받은 internalService.internal() 을 호출한다.
4. internalService 는 트랜잭션 프록시이다.
internal() 메서드에 @Transactional 이 붙어 있으므로 트랜잭션 프록시는 트랜잭션을 적용한다.
5. 트랜잭션 적용 후 실제 internalService 객체 인스턴스의 internal() 을 호출한다.
TransactionInterceptor 를 통해 트랜잭션이 적용되는 것을 확인할 수 있다.
boolean txActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("tx active ={}", txActive);InternalService 의 tx active=true 로그를 통해 internal() 호출에서 트랜잭션이 적용된 것을 확인할 수 있다.
여러가지 다른 해결방안도 있지만,
실무에서는 이렇게 별도의 클래스로 분리하는 방법을 주로 사용한다.
참고
스프링 핵심원리 고급편
13. 실무 주의사항 - 프록시와 내부 호출 문제에서 더 다양한 해결 방안을 소개한다.
public 메서드만 트랜잭션 적용
스프링의 트랜잭션 AOP 기능은 public 메서드에만 트랜잭션을 적용하도록 기본 설정이 되어있다.
그래서 protected , private , package-visible(==default) 에는 트랜잭션이 적용되지 않는다.
생각해보면 protected , package-visible 도 외부에서 호출이 가능하다.
따라서 이 부분은 앞서 설명한 프록시의 내부 호출과는 무관하고, 스프링이 막아둔 것이다.
스프링이 public에만 트랜잭션을 적용하는 이유는 다음과 같다
@Transactional
public class Hello {
public method1(); // 트랜잭션 O
method2(); // 트랜잭션 X
protected method3(); // 트랜잭션 X
private method4(); // 트랜잭션 X
}
이렇게 클래스 레벨에 트랜잭션을 적용하면 모든 메서드에 트랜잭션이 걸릴 수 있다.
그러면 트랜잭션을 의도하지 않는 곳 까지 트랜잭션이 과도하게 적용된다.
트랜잭션은 주로 비즈니스 로직의 시작점에 걸기 때문에 대부분 외부에 열어준 곳을 시작점으로 사용한다.
이런 이유로 public 메서드에만 트랜잭션을 적용하도록 설정되어 있다.
스프링 변경사항으로 protected , package-visible(==default)에서도 트랜잭션 적용이 된다.
https://www.inflearn.com/questions/754189
default와 protected 접근 제한자 @Transactional 적용 - 인프런
안녕하세요! 항상 좋은 강의 감사드립니다.선생님의 강의를 보며 코드를 따라치는데, protected와 default 접근제한자가 붙어있는 경우에도 @Transactional이 적용되어 조금 찾아보았습니다.ProxyTransaction
www.inflearn.com
트랜잭션 AOP 주의 사항 - 초기화 시점
스프링 초기화 시점에는 트랜잭션 AOP가 적용되지 않을 수 있다.
@Slf4j
static class Hello{
@PostConstruct
@Transactional
public void initV1() {
boolean isActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("Hello init @PostConstruct tx Active ={}", isActive);
}@Test
void go() {
//초기화 코드는 스프링이 초기화 시점에 호출한다. -> 스프링 빈 등록 후
//@PostConstruct 를 붙여놓은 메소드를 테스트할 거이기 때문에 막상 테스트 메소드에는 아무것도 필요없다.
// 스프링이 초기화 된후 알아서 @PostConstruct 가 붙은 메소드를 실행할것이기 때문.
// 직접 호출하면 트랜잭션이 적용된다.
}
초기화 코드 ( 예를들어 @PostConstruct 같은) 와
@Transactional 을 함께 사용하면 트랜잭션이 적용되지 않는다.
왜냐하면 초기화 코드가 먼저 호출되고, 그 다음에 트랜잭션 AOP가 적용되기 때문이다.
따라서 초기화 시점에는 해당 메서드에서 트랜잭션을 획득할 수 없다
가장 확실한 대안은 ApplicationReadyEvent 이벤트를 사용하는 것이다.
@EventListener(ApplicationReadyEvent.class)
@Transactional
public void initV2() {
boolean isActive = TransactionSynchronizationManager.isActualTransactionActive();
log.info("Hello init ApplicationReadyEvent tx Active ={}", isActive);
}ApplicationReadyEvent
이 이벤트는 트랜잭션 AOP를 포함한 스프링이 컨테이너가 완전히 생성되고 난 다음에
이벤트가 붙은 메서드를 호출해준다.
따라서 init2() 는 트랜잭션이 적용된 것을 확인할 수 있다.
간단하게 초기화할때는 -> @Postconstruct
트랜잭션과 같은걸 사용해야할때는 -> @EventListener(ApplicationReadyEvent.class)
트랜잭션 옵션 소개
스프링 트랜잭션은 다양한 옵션을 제공한다.
이번 시간에는 각각의 옵션들을 간략하게 소개하겠다.
그리고 주요한 옵션들은 이후 장에서 하나씩 자세히 설명하겠다.
@Transactional 내부 코드
public @interface Transactional {
String value() default "";
String transactionManager() default "";
Class<? extends Throwable>[] rollbackFor() default {};
Class<? extends Throwable>[] noRollbackFor() default {};
Propagation propagation() default Propagation.REQUIRED;
Isolation isolation() default Isolation.DEFAULT;
int timeout() default TransactionDefinition.TIMEOUT_DEFAULT;
boolean readOnly() default false;
String[] label() default {};
value, transactionManager
String value() default "";
String transactionManager() default "";트랜잭션을 사용하려면 먼저 스프링 빈에 등록된 어떤 트랜잭션 매니저를 사용할지 알아야 한다.
생각해보면 코드로 직접 트랜잭션을 사용할 때 분명 트랜잭션 매니저를 주입 받아서 사용했다.
@Transactional 에서도 트랜잭션 프록시가 사용할 트랜잭션 매니저를 지정해주어야 한다.
사용할 트랜잭션 매니저를 지정할 때는
value , transactionManager 둘 중 하나에 트랜잭션 매니저의 스프링 빈 의 이름을 적어주면 된다.
이 값을 생략하면 기본으로 등록된 트랜잭션 매니저를 사용하기 때문에 대부분 생략한다.
그런데 사용하는 트랜잭션 매니저가 둘 이상이라면
다음과 같이 트랜잭션 매니저의 이름을 지정해서 구분하면 된다.
public class TxService {
@Transactional("memberTxManager")
public void member() {...}
@Transactional("orderTxManager")
public void order() {...}
}참고로 애노테이션에서 속성이 하나인 경우 위 예처럼 value 는 생략하고 값을 바로 넣을 수 있다.
rollbackFor
Class<? extends Throwable>[] rollbackFor() default {};
예외 발생시 스프링 트랜잭션의 기본 정책은 다음과 같다.
언체크 예외인 RuntimeException , Error(Error도 언체크) 와 그 하위 예외가 발생하면 롤백한다.
체크 예외인 Exception 과 그 하위 예외들은 커밋한다
옵션을 사용하면 기본 정책에 추가로 어떤 예외가 발생할 때 롤백할 지 지정할 수 있다.
@Transactional(rollbackFor = Exception.class)예를 들어서 이렇게 지정하면 체크 예외인 Exception 이 발생해도 롤백하게 된다. (하위 예외들도 대상에 포함된다.)
rollbackForClassName 도 있는데, rollbackFor 는 예외 클래스를 직접 지정하고,
rollbackForClassName 는 예외 이름을 문자로 넣으면 된다.
[ rollbackForClassName는 잘안쓴다고함.]
noRollbackFor
Class<? extends Throwable>[] noRollbackFor() default {};
앞서 설명한 rollbackFor 와 반대이다.
기본 정책에 추가로 어떤 예외가 발생했을 때 롤백하면 안되는지 지정할 수 있다.
예외 이름을 문자로 넣을 수 있는 noRollbackForClassName 도 있다.
롤백 관련 옵션에 대한 더 자세한 내용은 뒤에서 더 자세히 설명한다
propagation
트랜잭션 전파에 대한 옵션이다.
자세한 내용은 뒤에서 설명한다.
isolation
트랜잭션 격리 수준을 지정할 수 있다.
기본 값은 데이터베이스에서 설정한 트랜잭션 격리 수준을 사용하는 DEFAULT 이다.
대부분 데이터베이스에서 설정한 기준을 따른다.
애플리케이션 개발자가 트랜잭션 격리 수준을 직접 지정하는 경 우는 드물다
강의에서는 일반적으로 많이 사용하는 READ COMMITTED(커밋된 읽기) 트랜잭션 격리 수준을 기준으로 설명한다.
timeout
트랜잭션 수행 시간에 대한 타임아웃을 초 단위로 지정한다.
기본 값은 트랜잭션 시스템의 타임아웃을 사용한다.
운영 환경에 따라 동작하는 경우도 있고 그렇지 않은 경우도 있기 때문에 꼭 확인하고 사용해야 한다.
timeoutString 도 있는데, 숫자 대신 문자 값으로 지정할 수 있다.
label
트랜잭션 애노테이션에 있는 값을 직접 읽어서 어떤 동작을 하고 싶을 때 사용할 수 있다.
일반적으로 사용하지 않는다.
readOnly
트랜잭션은 기본적으로 읽기 쓰기가 모두 가능한 트랜잭션이 생성된다.
@Transactional(readOnly = true)readOnly=true 옵션을 사용하면 읽기 전용 트랜잭션이 생성된다.
이 경우 등록, 수정, 삭제가 안되고 읽기 기능만 작동한다.
(드라이버나 데이터베이스에 따라 정상 동작하지 않는 경우도 있다.)
그리고 readOnly 옵션을 사용하면 읽기에서 다양한 성능 최적화가 발생할 수 있다
readOnly 옵션은 크게 3곳에서 적용된다.
1. 프레임워크
- JdbcTemplate은 읽기 전용 트랜잭션 안에서 변경 기능을 실행하면 예외를 던진다.
- JPA(하이버네이트)는 읽기 전용 트랜잭션의 경우 커밋 시점에 플러시를 호출하지 않는다.
읽기 전용이니 변경에 사용되는 플러시를 호출할 필요가 없다.
추가로 변경이 필요 없으니 변경 감지를 위한 스냅샷 객체도 생성하지 않는다.
이렇게 JPA에서는 다양한 최적화가 발생한다.
JPA 관련 내용은 JPA를 더 학습해야 이해할 수 있으므로 지금은 이런 것이 있다 정도만 알아두자.
2. JDBC 드라이버
참고로 여기서 설명하는 내용들은 DB와 드라이버 버전에 따라서 다르게 동작하기 때문에 사전에 확인이 필요하다.
읽기 전용 트랜잭션에서 변경 쿼리가 발생하면 예외를 던진다.
읽기, 쓰기(마스터, 슬레이브) 데이터베이스를 구분해서 요청한다.
읽기 전용 트랜잭션의 경우 읽기(슬레이브) 데이터베이스의 커넥션을 획득해서 사용한다.
3. 데이터베이스
데이터베이스에 따라 읽기 전용 트랜잭션의 경우 읽기만 하면 되므로, 내부에서 성능 최적화가 발생한다.
어떤 행동에 대한 제약을 주면 최적화가 일어날 여지가 있다.
[ "읽기만한다"와 같은 행동 제약]
일반적으로는 read-only를 사용하면 최적화가 되지만
상황에 따라 다르므로 성능테스트를 해봐야안다.
'인프런 > 스프링 DB 2편' 카테고리의 다른 글
| 12) 스프링 트랜잭션 전파 기본 (1) [미완] (1) | 2024.03.29 |
|---|---|
| 11) 스프링 트랜잭션 이해 (3) (0) | 2024.03.21 |
| 10) 스프링 트랜잭션 이해 (0) | 2024.02.15 |
| 9) 데이터 접근 기술 - 활용 방안 (0) | 2024.02.15 |
| 7) 데이터 접근 기술 - 스프링 데이터 JPA (0) | 2024.02.15 |
댓글