Spring Boot와 RabbitMQ 초간단 설명서

안영진·2019년 8월 10일
6

이번 포스트에서는 Spring boot 프로젝트에서 RabbitMQ를 사용하는 간단한 방법을 알아보겠습니다. Consumer 코드Producer 코드GitHub에 있습니다.

먼저 RabbitMQ 서버를 실행해야 하는데 Docker를 사용하면 쉽게 서버를 구성할 수 있습니다. 프로젝트 루트 폴더에 docker-compose.yml 파일을 생성하고 다음 내용을 추가합니다.

rabbitmq:
  image: rabbitmq:management
  ports:
    - "5672:5672"
    - "15672:15672"

yml 파일을 작성한 뒤 터미널에서 docker-compose up 명령을 실행하면 로컬에 RabbitMQ 서버가 다운로드, 실행이 되고 localhost:15672로 접속하면 RabbitMQ 관리 페이지에 접근할 수 있습니다.

로컬이나 외부 서버와 연동할 경우 application.properties 혹은 .yml에 다음 설정을 추가합니다.

spring:
  rabbitmq:
    host: 접속할 서버 IP 주소
    port: 접속할 포트 (default: 5672)
    username: RabbitMQ 유저 아이디
    password: RabbitMQ 유저 비밀번호
    virtual-host: virtual host를 사용하는 경우 virtual host 이름

의존성 추가

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-amqp'
    implementation 'com.fasterxml.jackson.core:jackson-databind'
}

Message Consumer

Configuration

먼저 메시지를 받는 쪽에서 어떤 설정을 해주어야 하는지 알아보겠습니다.

import org.springframework.amqp.core.Binding;
import org.springframework.amqp.core.BindingBuilder;
import org.springframework.amqp.core.Queue;
import org.springframework.amqp.core.TopicExchange;
import org.springframework.amqp.rabbit.connection.ConnectionFactory;
import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.amqp.support.converter.Jackson2JsonMessageConverter;
import org.springframework.amqp.support.converter.MessageConverter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class RabbitConfiguration {

    private static final String queueName = "spring-boot";

    private static final String topicExchangeName = "spring-boot-exchange";

    @Bean
    Queue queue() {
        return new Queue(queueName, false);
    }

    @Bean
    TopicExchange exchange() {
        return new TopicExchange(topicExchangeName);
    }

    @Bean
    Binding binding(Queue queue, TopicExchange exchange) {
        return BindingBuilder.bind(queue).to(exchange).with("foo.bar.#");
    }

    @Bean
    RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory,
                                  MessageConverter messageConverter) {
        RabbitTemplate rabbitTemplate = new RabbitTemplate(connectionFactory);
        rabbitTemplate.setMessageConverter(messageConverter);
        return rabbitTemplate;
    }

    @Bean
    MessageConverter messageConverter() {
        return new Jackson2JsonMessageConverter();
    }

}
  • Queue

지정된 이름으로 Queue를 등록합니다. 서로 다른 이름으로 여러개의 Queue를 등록할 수도 있습니다.

  • Exchange

Exchange를 설정합니다. 위 코드에서는 TopicExchange를 사용해 주어진 패턴과 일치하는 Queue에 메시지를 전달합니다. 설정할 수 있는 Exchange에는 Direct, Fanout, Topic, Headers가 있습니다.

  • Binding

Exchange가 Queue에게 메시지를 전달하기 위한 룰입니다. 빈으로 등록한 Queue와 Exchange를 바인딩하면서 Exchange에서 사용될 패턴을 설정해 주었습니다.

  • RabbitTemplate

RabbitTemplate는 Spring boot에서 자동으로 빈 등록을 해주지만 받은 메시지 처리를 위한 messageConverter를 설정하기 위해 오버라이딩합니다. (빈 등록에도 오버라이딩이라는 용어가 맞는지는 잘 모르겠네요.)

Message Listener

간단하게 Queue name을 기반으로 메시지를 받는 Listener를 작성합니다.

import org.springframework.amqp.core.Message;
import org.springframework.amqp.rabbit.annotation.RabbitListener;
import org.springframework.stereotype.Service;

@Service
public class CustomMessageListener {

    @RabbitListener(queues = "spring-boot")
    public void receiveMessage(final Message message) {
        System.out.println(message);
    }

}

이 Listener에서는 Queue name이 "spring-boot"인 Queue의 메시지를 처리합니다. Message 객체를 통해 받을 수도 있고 필요한 경우 CustomMessage를 구현해 처리할 수 도 있습니다.

Message Producer

메시지를 보내는 간단한 코드입니다.

import org.springframework.amqp.rabbit.core.RabbitTemplate;
import org.springframework.boot.CommandLineRunner;
import org.springframework.stereotype.Component;

@Component
public class Runner implements CommandLineRunner {

    private static final String topicExchange = "spring-boot-exchange";

    private final RabbitTemplate rabbitTemplate;

    public Runner(RabbitTemplate rabbitTemplate) {
        this.rabbitTemplate = rabbitTemplate;
    }

    @Override
    public void run(String... args) {
        System.out.println("Sending message...");
        rabbitTemplate.convertAndSend(topicExchange, "foo.bar.baz", "Hello Message!");
    }

}

Consumer에서 정의한 Exchange name인 "spring-boot-exchange""foo.bar.baz"라는 라우팅 키와 함께 "Hello Message!" 메시지를 보내고 있습니다.

정의된 Exchange는 Topic exchange이고 패턴은 "foo.bar.#"이기 때문에 위의 메시지는 정상적으로 Consumer가 처리할 수 있게 됩니다.

출력된 메시지

Body:'Hello Message!' 
MessageProperties [
    headers={}, 
    contentType=text/plain, 
    contentEncoding=UTF-8, 
    contentLength=0, 
    receivedDeliveryMode=PERSISTENT, 
    priority=0, 
    redelivered=false, 
    receivedExchange=spring-boot-exchange, 
    receivedRoutingKey=foo.bar.baz, 
    deliveryTag=1, 
    consumerTag=amq.ctag-84ObczudipDEgYl8VVQ3gg, 
    consumerQueue=spring-boot
]

Custom Message

Message 객체를 직접 만들어 사용하는 방법도 어렵지 않습니다. 먼저 사용할 CustomMessage 클래스를 만들어줍니다.

public class CustomMessage {

    private String text;

    private int priority;

    private boolean secret;

    protected CustomMessage() {
    }

    public CustomMessage(String text, int priority, boolean secret) {
        this.text = text;
        this.priority = priority;
        this.secret = secret;
    }

    public String getText() {
        return text;
    }

    public int getPriority() {
        return priority;
    }

    public boolean isSecret() {
        return secret;
    }

    @Override
    public String toString() {
        return "CustomMessage{" +
                "text='" + text + '\'' +
                ", priority=" + priority +
                ", secret=" + secret +
                '}';
    }

}

원하는 형식의 필드를 구성하고 Json converting을 위해 protected 기본 생성자를 추가합니다.

Message Producer에 Message converting을 위해 RabbitTemplate를 설정합니다.

@Configuration
public class RabbitConfiguration {

    @Bean
    RabbitTemplate rabbitTemplate(ConnectionFactory connectionFactory,
                                  MessageConverter messageConverter) {
        RabbitTemplate rabbitTemplate = new RabbitTemplate(connectionFactory);
        rabbitTemplate.setMessageConverter(messageConverter);
        return rabbitTemplate;
    }

    @Bean
    MessageConverter messageConverter() {
        return new Jackson2JsonMessageConverter();
    }

}

이제 사용자가 정의한 CustomMessage를 rabbitTemplate에서 사용할 수 있습니다.

public void run(String... args) {
    System.out.println("Sending message...");
    CustomMessage message = new CustomMessage("Hello Message!", 1, true);
    rabbitTemplate.convertAndSend(topicExchange, "foo.bar.baz", message);
}

MessageListener에 Message를 CustomMessage로 변경하면

@RabbitListener(queues = "spring-boot")
public void receiveMessage(final CustomMessage message) {
    System.out.println(message);
}

메시지가 다음과 같이 출력됩니다.

CustomMessage{text='Hello Message!', priority=1, secret=true}

Reference

4개의 댓글

comment-user-thumbnail
2019년 8월 14일

Spring boot 프로젝트에서 RabbitMQ를 사용하는 간단한 방법을 알아보았습니다 ( 이전글에는 안보이는데 혹시 어디있는지 알수있을까요?)

1개의 답글
comment-user-thumbnail
2021년 12월 23일

consumer 코드를 먼저 작성해야 하는 이유가 있나요?

1개의 답글