消息队列 / 系统课时
Java 客户端工程
Java 客户端工程
这一课把“能连上 RabbitMQ”整理成一个可复用的 Java 客户端最小工程:Maven 管理依赖,连接参数集中封装,Connection 与 Channel 由明确的生命周期负责关闭。完成后,可以直接在此骨架上继续编写生产者和消费者。
学习目标
- 创建可编译运行的 Maven Java 客户端工程并引入 RabbitMQ Java Client
- 用环境变量集中管理主机、端口、账号和虚拟主机
- 使用
try-with-resources正确关闭Channel和Connection
建立最小 Maven 工程
准备 JDK 17、Maven 3.9+,并确保 RabbitMQ 4.3 节点可访问。示例只需要 pom.xml 和 src/main/java/com/example/rabbitmq/App.java 两个文件;本地开发可使用默认 guest/guest,连接远程节点时应改用专门创建的 RabbitMQ 用户。
pom.xml 负责固定 Java 版本、客户端依赖和运行入口。这里使用 RabbitMQ Java Client 5.33.0。
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.example</groupId>
<artifactId>rabbitmq-java-client</artifactId>
<version>1.0.0</version>
<properties>
<maven.compiler.release>17</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>
<dependencies>
<dependency>
<groupId>com.rabbitmq</groupId>
<artifactId>amqp-client</artifactId>
<version>5.33.0</version>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>exec-maven-plugin</artifactId>
<version>3.5.0</version>
<configuration>
<mainClass>com.example.rabbitmq.App</mainClass>
</configuration>
</plugin>
</plugins>
</build>
</project>这份配置生效后,Maven 会把 AMQP 0-9-1 Java 客户端加入编译和运行时类路径,并使用 App 作为演示入口。后面的构建命令会同时验证依赖解析和代码编译。
封装连接工厂和资源关闭
连接参数不应散落在生产者、消费者代码中。下面把参数解析集中到 RabbitMqConnectionFactory.create(),业务入口只负责申请连接和通道;try-with-resources 会按相反顺序先关闭 Channel,再关闭 Connection。
package com.example.rabbitmq;
import com.rabbitmq.client.Channel;
import com.rabbitmq.client.Connection;
import com.rabbitmq.client.ConnectionFactory;
public final class App {
public static void main(String[] args) throws Exception {
ConnectionFactory factory = RabbitMqConnectionFactory.create();
// 业务入口只申请和使用资源,不重复拼装连接参数。
try (Connection connection = factory.newConnection("anystack-java-client");
Channel channel = connection.createChannel()) {
System.out.printf(
"connected %s:%d, channel=%d%n",
factory.getHost(),
factory.getPort(),
channel.getChannelNumber()
);
}
}
static final class RabbitMqConnectionFactory {
private RabbitMqConnectionFactory() {
}
static ConnectionFactory create() {
ConnectionFactory factory = new ConnectionFactory();
factory.setHost(env("RABBITMQ_HOST", "localhost"));
factory.setPort(Integer.parseInt(env("RABBITMQ_PORT", "5672")));
factory.setUsername(env("RABBITMQ_USER", "guest"));
factory.setPassword(env("RABBITMQ_PASSWORD", "guest"));
factory.setVirtualHost(env("RABBITMQ_VHOST", "/"));
// 长运行客户端遇到网络闪断后允许恢复连接和拓扑。
factory.setAutomaticRecoveryEnabled(true);
factory.setTopologyRecoveryEnabled(true);
return factory;
}
private static String env(String name, String defaultValue) {
String value = System.getenv(name);
return value == null || value.isBlank() ? defaultValue : value;
}
}
}这里故意不把 Channel 做成全局单例。Connection 通常是较重、可复用的 TCP 连接,而 Channel 是建立在连接之上的轻量 AMQP 会话;后续并发编程时,应让不同工作单元按照线程模型管理自己的通道。
构建并验证连接
先启动 RabbitMQ,再在项目根目录执行下面两条命令。第一条验证工程能完整编译,第二条实际创建连接和通道。
mvn -DskipTests package
mvn -q exec:java预期输出(节选)
[INFO] BUILD SUCCESS
connected localhost:<PORT>, channel=<ID><PORT> 默认是 5672,若设置了 RABBITMQ_PORT 则会变化;<ID> 是本次连接分配的通道编号,实际值也可能不同。若第二条命令出现连接拒绝,先检查节点是否监听目标端口,再检查用户名、密码和虚拟主机权限,而不是先修改 Java 代码。
明确工程边界
这个最小工程只负责依赖、连接参数、连接创建和资源释放。Exchange、Queue、Binding 的声明以及发布确认、消费确认等可靠性逻辑,应在后续业务组件中单独封装,避免把所有职责塞进连接工厂。
生产代码还应把密码交给密钥管理或运行环境注入,并为连接建立、恢复失败和关闭事件增加日志与指标。只要连接配置集中、资源生命周期清晰,后面的生产者和消费者就可以共享同一套工程基础,而不会各自复制一份连接代码。