9.5. 오류 처리 및 롤백

다음 방법 중 하나를 사용하여 트랜잭션을 롤백할 수 있습니다.

9.5.1.1. 런타임 예외를 사용하여 롤백 트리거

Spring 트랜잭션을 롤백하는 가장 일반적인 방법은 런타임(확인되지 않음) 예외를 throw하는 것입니다. 즉, 예외는 java.lang.RuntimeException 의 인스턴스 또는 하위 클래스입니다. java.lang.Error 유형의 Java 오류도 트랜잭션 롤백을 트리거합니다. 반면 검사된 예외는 롤백을 트리거하지 않습니다.

다음 그림은 Java 오류 및 예외가 트랜잭션에 미치는 영향을 요약한 것으로, 롤백을 트리거하는 클래스는 회색으로 표시됩니다.

참고

Spring 프레임워크는 롤백을 트리거하거나 트리거하지 않아야 하는 예외를 지정할 수 있는 XML 주석 시스템도 제공합니다. 자세한 내용은 Spring Reference Guide의 "Rolling back"를 참조하십시오.

주의

트랜잭션 내에서 런타임 예외가 처리되는 경우, 즉 예외가 트랜잭션 분리를 수행하는 코드로 대체될 가능성이 있기 전에 트랜잭션이 롤백되지 않습니다. 자세한 내용은 9.5.2절. “dead letter queue를 정의하는 방법”의 내용을 참조하십시오.

from("file:src/data?noop=true")
    .transacted()
    .bean("accountService","credit")
    .choice().when(xpath("/transaction/transfer[amount > 100]"))
        .rollback()
    .otherwise()
        .to("direct:txsmall");

from("direct:txsmall")
    .bean("accountService","debit")
    .bean("accountService","dumpTable")
    .to("file:target/messages/small");

from("file:src/data?noop=true")
    .transacted()
    .bean("accountService","credit")
    .choice().when(xpath("/transaction/transfer[amount > 100]"))
        .markRollbackOnly()
    .otherwise()
        .to("direct:txsmall");
...

실패한 트랜잭션을 추적하기 위해 관련 교환 개체를 dead-letter queue로 전환할 수 있는 onException() 절을 정의할 수 있습니다. 그러나 트랜잭션 컨텍스트에서 사용하는 경우 예외 처리와 트랜잭션 처리 간의 잠재적인 상호 작용으로 인해 onException() 절을 정의하는 방법에 대해 주의해야 합니다. 다음 예제에서는 rethrown 예외를 억제해야 한다고 가정하면 onException() 절을 정의하는 올바른 방법을 보여줍니다.

// Java
import org.apache.camel.builder.RouteBuilder;

public class MyRouteBuilder extends RouteBuilder {
    ...
    public void configure() {
        onException(IllegalArgumentException.class)
            .maximumRedeliveries(1)
            .handled(true)
            .to("file:target/messages?fileName=deadLetters.xml&fileExist=Append")
            .markRollbackOnly();  // NB: Must come *after* the dead letter endpoint.

        from("file:src/data?noop=true")
            .transacted()
            .bean("accountService","credit")
            .bean("accountService","debit")
            .bean("accountService","dumpTable")
            .to("file:target/messages");
    }
}

이전 예에서 onException() 은 IllegalArgumentException 예외를 catch하고 잘못된 교환을 dead letter file dead letter file, deadLet Cryostat.xml 로 전송하도록 구성되어 있습니다. 물론 이 정의를 변경하여 애플리케이션에서 발생하는 모든 종류의 예외를 파악할 수 있습니다. 예외 다시 화살표 동작 및 트랜잭션 롤백 동작은 onException() 절의 다음과 같은 특수 설정으로 제어됩니다.

onException() 을 사용하는 대신 트랜잭션 경로에서 예외를 처리하는 간단한 방법은 경로 주위에 doTry() 및 doCatch() 절을 사용하는 것입니다. 예를 들어 다음 코드는 무한 루프에 갇혀 있을 위험 없이 트랜잭션 경로에서 IllegalArgumentException 을 catch하고 처리하는 방법을 보여줍니다.

// Java
import org.apache.camel.builder.RouteBuilder;

public class MyRouteBuilder extends RouteBuilder {
    ...
    public void configure() {
        from("file:src/data?noop=true")
            .doTry()
                .to("direct:split")
            .doCatch(IllegalArgumentException.class)
                .to("file:target/messages?fileName=deadLetters.xml&fileExist=Append")
            .end();

        from("direct:split")
            .transacted()
            .bean("accountService","credit")
            .bean("accountService","debit")
            .bean("accountService","dumpTable")
            .to("file:target/messages");
    }
}

이 예에서 경로는 두 세그먼트로 나뉩니다. 첫 번째 세그먼트( 파일:src/data 끝점)는 들어오는 교환을 수신하고 doTry() 및 doCatch() 를 사용하여 예외 처리를 수행합니다. 두 번째 세그먼트( 직접:split 끝점)는 모든 트랜잭션 작업을 수행합니다. 이 트랜잭션 세그먼트 내에서 예외가 발생하면 먼저 transacted() 명령으로 전파되므로 현재 트랜잭션이 롤백되고 첫 번째 경로 세그먼트의 doCatch() 절에 의해 catch됩니다. doCatch() 절은 예외를 다시 가져오지 않으므로 파일 끝점에서 재시도를 수행하지 않고 무한 루프를 방지할 수 있습니다.