### 歡迎訪問我的GitHub
> 這裡分類和彙總了欣宸的全部原創(含配套原始碼)：[https://github.com/zq2599/blog_demos](https://github.com/zq2599/blog_demos)

- 本文是《Docker下RabbitMQ四部曲》系列的第三篇，實戰兩個基於SpringBoot的工程，分別用來生產和消費RabbitMQ訊息；

### 前文連結
- 前兩章的內容是體驗RabbitMQ服務，以及製作RabbitMQ映象：
1. [《Docker下RabbitMQ四部曲之一：極速體驗(單機和叢集)》](http://blog.itpub.net/70017844/viewspace-2897069/)；
2. [《Docker下RabbitMQ四部曲之二：細說RabbitMQ映象製作》](http://blog.itpub.net/70017844/viewspace-2897380/)；

### 本文內容簡述
- 今天的實戰由以下幾部分組成：
1. 開發SpringBoot工程rabbitmqproducer，用來生產訊息；
2. 分析docker-compose.yml中對rabbitmqproducer映象的使用；
3. 開發SpringBoot工程rabbitmqconsumer，用來消費訊息；
4. 分析docker-compose.yml中對rabbitmqconsumer映象的使用；

### 原始碼下載
- 您可以在GitHub下載本文涉及到的檔案和原始碼，地址和連結資訊如下表所示：

| 名稱      |   連結 |   備註|
| :-------- | :----| :----|
| 專案主頁| https://github.com/zq2599/blog_demos | 該專案在GitHub上的主頁 |
| git倉庫地址(https)| https://github.com/zq2599/blog_demos.git | 該專案原始碼的倉庫地址，https協議 |
| git倉庫地址(ssh)| git@github.com:zq2599/blog_demos.git | 該專案原始碼的倉庫地址，ssh協議 |

- 這個git專案中有多個資料夾，本章建立的兩個工程分別在**rabbitmqproducer、rabbitmqconsumer**這兩個資料夾下，如下圖紅框所示：
![image.png](https://bbs-img.huaweicloud.com/blogs/img/20220527/1653666312675679171.png)

### 生產訊息的rabbitmqproducer
- rabbitmqproducer是個普通的SpringBoot工程，pom.xml內容如下：
```xml
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemalocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelversion>4.0.0</modelversion>

<groupid>com.bolingcavalry</groupid>
	<artifactid>rabbitmqproducer</artifactid>
	<version>0.0.1-SNAPSHOT</version>
	<packaging>jar</packaging>

<name>rabbitmqproducer</name>
	<description>Demo project for Spring Boot</description>

<parent>
		<groupid>org.springframework.boot</groupid>
		<artifactid>spring-boot-starter-parent</artifactid>
		<version>2.0.1.RELEASE</version>
		<relativepath></relativepath> 
	</parent>

<dependencies>
		<dependency>
			<groupid>org.springframework.boot</groupid>
			<artifactid>spring-boot-starter-amqp</artifactid>
		</dependency>
		<dependency>
			<groupid>org.springframework.boot</groupid>
			<artifactid>spring-boot-starter-web</artifactid>
		</dependency>

<dependency>
			<groupid>org.springframework.boot</groupid>
			<artifactid>spring-boot-starter-test</artifactid>
			<scope>test</scope>
		</dependency>
	</dependencies>

<build>
		<plugins>
			<plugin>
				<groupid>org.springframework.boot</groupid>
				<artifactid>spring-boot-maven-plugin</artifactid>
			</plugin>
			<plugin>
				<groupid>com.spotify</groupid>
				<artifactid>docker-maven-plugin</artifactid>
				<version>0.4.12</version>
				
				<configuration>
					
					<imagename>bolingcavalry/${project.artifactId}</imagename>
					
					<imagetags>
						<imagetag>${project.version}</imagetag>
					</imagetags>
					
					<baseimage>java:8u111-jdk</baseimage>
					
					<entrypoint>["java", "-jar", "/${project.build.finalName}.jar"]</entrypoint>
					
					<resources>
						<resource>
							<targetpath>/</targetpath>
							<directory>${project.build.directory}</directory>
							<include>${project.build.finalName}.jar</include>
						</resource>
					</resources>
				</configuration>
			</plugin>
		</plugins>
	</build>
</project>
```
- 上述poml.xml中，有以下兩點要注意：
1. 依賴**spring-boot-starter-amqp**這個starter，用於RabbitMQ；
2. 使用外掛**docker-maven-plugin**將工程製作為docker映象；

- 接下來看看關鍵原始碼：
- application.properties檔案內容如下，是關於RabbitMQ的vhost和交換機名稱的配置：
```shell
mq.rabbit.virtualHost=/
mq.rabbit.exchange.name=bolingcavalryFanoutExchange
```
- RabbitConfig類加了**@Configuration**註解，表示這是個配置類，程式碼如下：
```java
@Bean(name = "connectionFactory")
    public ConnectionFactory connectionFactory() {
        CachingConnectionFactory connectionFactory = new CachingConnectionFactory();

connectionFactory.setUsername(username);
        connectionFactory.setPassword(password);
        connectionFactory.setVirtualHost(mqRabbitVirtualHost);
        connectionFactory.setPublisherConfirms(true);

//該方法配置多個host，在當前連線host down掉的時候會自動去重連後面的host
        connectionFactory.setAddresses(address);

return connectionFactory;
    }

@Bean
    @Scope(ConfigurableBeanFactory.SCOPE_PROTOTYPE)
    //必須是prototype型別
    public RabbitTemplate rabbitTemplate() {
        RabbitTemplate template = new RabbitTemplate(connectionFactory());
        return template;
    }

//Fanout交換器
    @Bean
    FanoutExchange fanoutExchange() {
        return new FanoutExchange(exchangeName);
    }
```
上述程式碼將RabbitTemplate物件和交換機物件的例項化分別透過兩個加了@Bean註解的方法實現；
- RabbitConfig類中有三個@Value註解配置的成員變數：address、username、password，這三個配置對應的值並沒有寫在application.properties中，因此SpringBoot會去系統環境變數中查詢，找到後設定給它們；
- SendController類，在收到http請求後，會向RabbitMQ傳送一條訊息，程式碼如下，呼叫rabbitTemplate.convertAndSend即可傳送：
```java
@RequestMapping(value = "/send/{name}/{message}", method = RequestMethod.GET)
    public @ResponseBody String send(@PathVariable("name") final String name, @PathVariable("message") final String message) {
        SimpleDateFormat simpleDateFormat=new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
        String timeStr = simpleDateFormat.format(new Date());
        String sendMessage = "hello, " + name + ", " + message  + ", " + timeStr;
        rabbitTemplate.convertAndSend(exchangeName,"", sendMessage);
        return "send message to [" +  name + "] success (" + timeStr + ")";
    }
```

- 以上就是訊息生產者的功能程式碼，在pom.xml所在目錄下執行**mvn clean package -U -DskipTests docker:build**即可編譯構建工程並生成docker映象檔案；

- 接下來我們看看docker-compose.yml中是如何使用這個映象的；

### docker-compose.yml中對rabbitmqproducer映象的使用
- 在叢集版的docker-compose.yml檔案中，關於映象的配置如下：
```yml
producer:
    image: bolingcavalry/rabbitmqproducer:0.0.2-SNAPSHOT
    hostname: producer
    depends_on:
      - rabbit3
    links:
      - rabbit1:rabbitmqhost
    ports:
      - "18080:8080"
    environment:
      - mq.rabbit.address=rabbitmqhost:5672
      - mq.rabbit.username=admin
      - mq.rabbit.password=888888
```
- 這些配置中有以下幾點需要注意：
1. links引數將rabbit1容器對應為別名rabbitmqhost，在environment引數中，mq.rabbit.address等於rabbitmqhost:5672，也就是rabbit1容器的IP地址；
2. mq.rabbit.address、mq.rabbit.username、mq.rabbit.password都被設定到容器的環境變數中，因此RabbitConfig.java中的address、username、password就會被設定為mq.rabbit.address、mq.rabbit.username、mq.rabbit.password對應的值；
3. 將當前電腦的18080埠對映到8080埠，假設當前電腦IP地址為192.168.119.155，那麼要向容器傳送http請求時，向這個地址發起http請求即可：http://192.168.119.155:18080/send/aaa/bbb

- 至此，訊息生產者的開發已經完成，接下來開始開發訊息消費者吧；

### 消費訊息的rabbitmqconsumer
- rabbitmqconsumer是個普通的SpringBoot工程，pom.xml的內容和rabbitmqproducer的pom.xml是一樣的(除了工程名不一樣)：

- 接下來看看關鍵原始碼：
- 配置類是RabbitConfig.java，和rabbitmqproducer的RabbitConfig.java基本一致，不同的是多了個成員變數queuename，用於表示佇列名稱，對應的值也是來自環境變數；
- 作為RabbitMQ的訊息消費者，rabbitmqconsumer要主動連線到RabbitMQ的佇列上，以保持隨時可以消費訊息，對應的繫結程式碼如下：
```java
 @Bean
    FanoutExchange fanoutExchange() {
        return new FanoutExchange(exchangeName);
    }

//佇列A
    @Bean
    public Queue fanoutQueue() {
        return new Queue(queuename);
    }

//繫結對列到Fanout交換器
    @Bean
    Binding bindingFanoutExchange(Queue fanoutQueue, FanoutExchange fanoutExchange) {
        return BindingBuilder.bind(fanoutQueue).to(fanoutExchange);
    }
```
- 收到訊息後，對訊息的消費操作由FanoutReceiver類負責，在日誌中將訊息列印出來：
```java
@Component
@RabbitListener(queues = "${mq.rabbit.queue.name}")
public class FanoutReceiver {
    private static final Logger logger = LoggerFactory.getLogger(FanoutReceiver.class);

@RabbitHandler
    public void process(String message) {
        logger.info("receive message : " + message);
    }
}
```

- 以上就是訊息消費者的功能程式碼，在pom.xml所在目錄下執行**mvn clean package -U -DskipTests docker:build**即可編譯構建工程並生成docker映象檔案；

### 特別注意的地方
- 為了讓rabbitmqconsumer的Docker映象更通用，rabbitmq的賬號、密碼、佇列名稱等引數都沒有寫死在工程中，而是從系統環境變數中獲取，對應的環境變數的名成分別是：mq.rabbit.username、mq.rabbit.password、mq.rabbit.queue.name，這些環境變數的值是誰負責設定的呢？是docker-compose.yml中的environment引數配置的，容器啟動後docker就會在該容器中設定這些環境變數；

- 在實際使用過程中，經常會出現rabbitmqconsumer程式在連線RabbitMQ時經常報錯提示：**ACCESS_REFUSED - Login was refused using authen**

- 目前的推測是：啟動rabbitmqconsumer程式和環境變數設定並沒有嚴格的先後順序，導致了rabbitmqconsumer在使用mq.rabbit.username這些系統環境變數的時候，可能docker還沒有設定好這些環境變數，因此導致連線RabbitMQ失敗；

- 針對這個問題，我在工程的啟動類RabbitmqconsumerApplication的main方法中，先做了6秒的延時，再啟動SpringApplication，目前經過多次測試問題已經不再出現，程式碼如下：
```java
@SpringBootApplication
public class RabbitmqconsumerApplication {
	public static void main(String[] args) {
		try{
			Thread.sleep(1000);
		}catch(Exception e){
			e.printStackTrace();
		}
		SpringApplication.run(RabbitmqconsumerApplication.class, args);
	}
}
```

- 為什麼rabbitmqproducer應用沒有這個問題？
- 檢視容器的日誌，重點是**Attempting to connect to: [rabbitmqhost:5672]**這段資訊，會發現對於rabbitmqproducer應用，只有在第一次發訊息的時候才會去連線RabbitMQ，這時候環境變數已經設定好了，所以連線不會有問題；
- 但是rabbitmqconsumer應用由於是消費者，應用一啟動就要主動去連線佇列繫結交換機，所以一旦此時環境變數沒有設定好，就會導致拿不到正確的引數資訊；

- 如果您不想使用延時這種笨辦法，可以在application.properties中將mq.rabbit.username、mq.rabbit.password、mq.rabbit.queue.name這幾個引數配置好，再去構建映象，此時記得在docker-compose.yml中去掉對應的環境變數配置；

### docker-compose.yml中對rabbitmqconsumer映象的使用
- 在叢集版的docker-compose.yml檔案中，關於映象的配置如下：
```yml
consumer1:
    image: bolingcavalry/rabbitmqconsumer:0.0.5-SNAPSHOT
    hostname: consumer1
    depends_on:
      - producer
    links:
      - rabbit2:rabbitmqhost
    environment:
     - mq.rabbit.address=rabbitmqhost:5672
     - mq.rabbit.username=admin
     - mq.rabbit.password=888888
     - mq.rabbit.queue.name=consumer1.queue
  consumer2:
    image: bolingcavalry/rabbitmqconsumer:0.0.5-SNAPSHOT
    hostname: consumer2
    depends_on:
      - consumer1
    links:
      - rabbit3:rabbitmqhost
    environment:
      - mq.rabbit.address=rabbitmqhost:5672
      - mq.rabbit.username=admin
      - mq.rabbit.password=888888
      - mq.rabbit.queue.name=consumer2.queue
```
- 這些配置中有以下幾點需要注意：
1. 有兩個消費者映象consumer1、consumer2；
2. 由於交換器是fanout型別，生成者每生產一條訊息，由consumer1、consumer2分別消費一次；
3. consumer1、consumer2各自連線一個佇列，這一點在第一章的截圖中有過體現，如下圖：
![image.png](https://bbs-img.huaweicloud.com/blogs/img/20220527/1653666373472590232.png)

- 至此，訊息生產和消費對應的java程式碼就全部實戰完畢了，希望能幫助您快速的開發RabbitMQ相關的java應用，下一章我們將實戰RabbitMQ的高可用，透過docker stop命令模擬生產環境中的當機，看看部分機器的故障是否影響正常的RabbitMQ服務；

### 歡迎關注ITpub：程式設計師欣宸
> [學習路上，你不孤單，欣宸原創一路相伴...](http://blog.itpub.net/70017844/)

Docker下RabbitMQ四部曲之三：細說java開發

相關文章