brunch

매거진 스프링 스터디 시리즈

라이킷 12 댓글 4

You can make anything
by writing

C.S.Lewis

계정을 잊어버리셨나요?

by 에디의 기술블로그 Jun 07. 2020

Spring @EventListener

스프링부트 이벤트 구현

이 글은, 스프링부트에서 제공하는 @EventListener에 대해서 소개한다.

1. Overview : 글 소개

2. Spring Event(1) : 스프링 4.2 이전 버전에서의 이벤트

3. Spring Event(2) : 스프링 @EventListener

4. Spring ApplicationEvent : 스프링 부트에서 제공하는 이벤트

스프링 개발 경험이 많은 개발자는 지루한 이 글을 전부 읽지 말고,

@EventListener 에 대해서 소개하는 3장부터 읽는 것을 추천한다.

1.Overview

복잡한 도메인을 개발하다 보면, 도메인 사이에 강한 의존성으로 인해서 시스템이 복잡해지는 경우가 발생한다. 이 글에서는 복잡한 도메인 의존성을 줄이기 위한 방법 중 이벤트에 대해서 소개한다.

의존성

샘플코드는 상품 주문 도메인에 대한 사례이다. Order라는 이름의 주문 모델은, ChargeService 라는 응용 서비스를 사용해서 결제를 요청한다. (주문 도메인에서는 결제 처리 기능을 호출하게 된다.)

상품 상태에 대한 정의는 아래와 같다.

ChargeService 는 결제 로직을 수행하는 응용서비스이다.

Order 클래스의 pay 메서드에서 결제를 요청하는데, ChargeService 클래스의 charge() 메서드를 실행한다. startPay(), completedPay() 메서드에서는 상품 상태를 변경한다. Order 도메인에서 상품 상태에 대한 변경 역할을 담당한다.

상품 상태를 변경하는 역할은 Order 의 역할이 맞다. 하지만, 결제 로직은 Order 모델의 핵심 역할이 아니다. 결제는 ChargeService 에서 담당하며, 결제를 처리하는 응용서비스를 주입받아서 실행한다.

주문을 담당하는 Order에서 결제 로직을 실행하기 때문에, 주문 로직과 결제 로직이 섞여 있다.

어떻게 하면 의존성을 줄일 수 있을까?

이 글에서는, 도메인 모델 사이의 의존성을 줄일 수 있는 방법으로 이벤트를 소개한다.

참고로 이 글은 최범균님의 "DDD Start 도메인 주도 설계 구현과 핵심 개념 익히기"라는 책의 사례와 매우 유사하지만, 책의 내용을 그대로 인용하지 않았다. 해당 책은 DDD 입문자에게 괜찮은 책이지만 현재는 품절되었다. 회사 책장에 한 권씩은 굴러다니고 있을 테니, 찾아서 읽어보기를 바란다.

2. Spring Event(1)

이번 장에서는 스프링 4.2 이전 버전에서의 스프링 이벤트에 대해서 소개한다. 스프링 4.2 버전부터 @EventListener 어노테이션을 사용할 수 있으며, 해당 방법은 Spring Event(2)에서 확인하길 바란다.

Gradle Dependencies

생략

패키지

샘플 코드의 패키지 레이어는 아래와 같다.

이벤트, 이벤트 리스너

ApplicationEvent를 상속받아서 Event 객체를 정의하자.

이벤트 리스너는 ApplicationListener 인터페이스를 구현해야 한다.

이벤트가 발생했을 때 수신처리하는 구문은, onApplicationEvent 메서드에 작성한다. 리스너는 결제 서비스를 처리해야하기 때문에, ChargeService 응용서비스에 대한 의존성을 갖는다.

Order 도메인 모델에서는 이벤트를 발생시킨다. ApplicationEventPublisher를 사용해서 이벤트를 발생시킬 수 있는데, 위에서 정의했던 ChargeRequestEvent 객체를 생성해서 발행해야 한다.

정리해보면, Order 도메인에서는 ChargeService를 직접 실행하지 않는다. Order에서는 이벤트 객체를 전달하며, 이벤트를 핸들링하는 리스너에서 결제 로직을 실행하게 된다. 즉, Order와 ChargeService 두 클래스 사이에 의존성이 약하다.

OrderService(응용서비스)에서는 Order 도메인 모델의 pay() 메서드를 실행하면서 ApplicationEventPublisher를 전달하는 방식으로 구현하였다.

이 글을 보는 개발자분들 중에서, publisher를 Order 도메인 모델에 전달하는 방법이 부자연스럽다고 생각할 수 있다. 다른 방법으로는, OrderService에서 publisher를 직접 사용해서 이벤트를 직접 발생시키는 방법도 가능하다. 단, 이 경우에는 도메인 모델에 대한 상세 로직이 응용 서비스 레벨로 나오게 된다.

어떤 방식이 좋은지 허접한 개발자인 필자는 잘 모르겠다. 더 좋은 방법이 있다면 부족한 개발자인 필자에게 꼭 알려주길 바란다. 어쨌든, 이 글은 스프링 Event에 대한 주제이므로, 상세하게 설명하지는 않겠다.

중요한 사실은, publisher 객체의 publishEvent 메서드를 실행해서 이벤트를 발생시킬 수 있다는 점이다. 이때, 이벤트 객체인 ChargeRequestEvent를 생성해서 전달해야 한다.

검증

테스트 코드를 실행하였다.

샘플코드

https://github.com/sieunkr/spring-eventlistener/tree/master/spring-application-event

sieunkr/spring-eventlistener

Contribute to sieunkr/spring-eventlistener development by creating an account on GitHub.

github.com

스프링 4.2부터 사용 가능한 @EventListener를 사용해서 코드를 개선해보자.

3. Spring Event(2) - @EventListener

스프링 4.2부터 사용 가능한 @EventListener 어노테이션에 대해서 알아보자.

Gradle Dependencies

생략

Event, EventListener

위에서 소개했던 샘플 코드의 방법(ApplicationEvent, ApplicationListener를 상속, 구현)할 필요가 없다. Event를 정의할 때 ApplicationEvent를 상속받을 필요가 없다.

이벤트 리스너는 ApplicationListener를 구현할 필요가 없고, @EventListener 어노테이션을 메서드 상단에 선언해주면 이벤트 리스너로 등록이 된다. 매개변수에 Event 클래스를 정의하면 해당 클래스 이벤트가 발생했을 때 이벤트를 수신해서 처리할 수 있다.

아주 심플하다.

Order

같은 이벤트에 대한 수신을 2개 이상의 핸들러 메서드에 정의할 수 있다. ChargeRequestEvent 이벤트가 발생하면 선언된 모든 메서드가 실행된다. 이 경우에, Order 어노테이션을 사용해서 메서드 실행 순서를 정의할 수 있다.

Async

이벤트 리스닝을 비동기로 구현해보자. 비동기 메서드가 동작할 수 있도록 최상단 클래스에 @EnableAsync 어노테이션을 선언한다.

비동기로 실행하길 원하는, 메서드에 @Async 어노테이션을 선언한다.

비동기에 대해서는 필자의 예전 글을 꼭 읽어보길 바란다.

https://brunch.co.kr/@springboot/267

CompletableFuture

자바 비동기 프로그래밍을 위한 CompletableFuture 검토 | 필자는 최근에 CompletableFuture 를 사용해서 개발을 진행하였는데, CompletableFuture는 작년에 한번 사용한 이후로는 실무에서 사용할 일이 거의

brunch.co.kr/@springboot/267

https://brunch.co.kr/@springboot/401

Spring Boot @Async 어떻게 동작하는가?

스프링부트 환경에서, @Async 어노테이션 사용해서 비동기 메서드 구현 | 이 글에서는, 스프링 프레임워크에서 제공하는 @Aysnc 비동기 메서드 사용 방법에 대해서 설명한다. 이 글을 읽기 위해서�

brunch.co.kr/@springboot/401

느슨한 결합

이해를 돕기 위해서, 필자가 간단하게 그림을 그렸다.

이벤트 발행하는 주체는 Order 도메인이다. Order 도메인에서 publisher 객체의 publishEvent 메서드로 이벤트를 발생시킨다. 이때, ChargeRequestEvent 객체를 전달한다. 스프링의 ApplicationContext에서 이벤트 채널의 역할을 수행하며, @EventListener 어노테이션으로 선언한 메서드에서 ChargeRequestEvent 이벤트를 받아서 처리하게 된다.