消息队列 / 系统课时

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。

xml
<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。

java
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,再在项目根目录执行下面两条命令。第一条验证工程能完整编译,第二条实际创建连接和通道。

bash
mvn -DskipTests package
mvn -q exec:java

预期输出(节选)

text
[INFO] BUILD SUCCESS
connected localhost:<PORT>, channel=<ID>

<PORT> 默认是 5672,若设置了 RABBITMQ_PORT 则会变化;<ID> 是本次连接分配的通道编号,实际值也可能不同。若第二条命令出现连接拒绝,先检查节点是否监听目标端口,再检查用户名、密码和虚拟主机权限,而不是先修改 Java 代码。

明确工程边界

这个最小工程只负责依赖、连接参数、连接创建和资源释放。Exchange、Queue、Binding 的声明以及发布确认、消费确认等可靠性逻辑,应在后续业务组件中单独封装,避免把所有职责塞进连接工厂。

生产代码还应把密码交给密钥管理或运行环境注入,并为连接建立、恢复失败和关闭事件增加日志与指标。只要连接配置集中、资源生命周期清晰,后面的生产者和消费者就可以共享同一套工程基础,而不会各自复制一份连接代码。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Java 客户端工程

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通