Apache ActiveMQ Artemis 2.15.0 User Manual

• 语言: 英语
• 格式: .pdf
• 来源: activemq.apache.org

摘要

本文档是《Apache ActiveMQ Artemis 2.15.0 User Manual》，主要介绍了Apache ActiveMQ Artemis的使用方法和配置选项。文档涵盖了多个示例，包括请求-回复模式、计划消息、安全性配置、LDAP集成、慢消费者检测等。此外，文档还详细列出了各个版本的发布说明，包括新增功能、改进和升级注意事项。主要内容包括如何配置SSL传输、静态消息选择器、嵌入式使用、虚拟主题映射以及排他队列等功能。文档还提供了关于broker实例创建、目录布局和日志管理的详细信息，帮助用户更好地理解和使用ActiveMQ Artemis。

AI总结

《Apache ActiveMQ Artemis 2.15.0 用户手册》提供了关于 Apache ActiveMQ Artemis 消息中间件的详细指南，涵盖了功能介绍、示例、版本更新、升级说明和配置指南等内容。以下是总结的核心观点和关键信息：

### 1. 功能概述
Apache ActiveMQ Artemis 是一个高性能的分布式消息中间件，支持多种协议（如 JMS、AMQP、STOMP 等），具备以下核心功能：
- **事务与复制**：支持事务和消息复制功能。
- **请求-响应模式**：通过 JMS 请求-响应模式实现客户端与服务器之间的异步通信。
- **计划消息**：允许设置消息的计划投递时间。
- **安全性**：支持基于角色的访问控制（RBAC），并提供 LDAP 集成。
- **慢消费者检测**：能够检测和配置慢消费者策略。
- **SSL 传输**：支持通过 SSL 进行安全通信。
- **静态消息选择器**：支持通过静态过滤器配置消息选择器。

### 2. 示例功能
文档提供了多个示例，展示了如何使用 ActiveMQ Artemis 的核心功能：
- **请求-响应示例**：演示 JMS 请求-响应模式。
- **计划消息示例**：展示如何发送计划消息。
- **安全性示例**：演示基于角色的安全配置。
- **慢消费者示例**：展示如何检测和处理慢消费者。
- **Spring 集成示例**：演示如何使用 Spring 框架集成 ActiveMQ Artemis。
- **虚拟主题映射和专有队列示例**：展示新版本的虚拟主题和专有队列功能。

### 3. 版本更新亮点
文档列出了多个版本的更新内容，以下是各版本的主要亮点：
- **2.15.0 版本**：
- 支持正则表达式匹配客户端证书。
- 支持 SASL_EXTERNAL 协议。
- 新增虚拟主题映射和专有队列示例。
- **2.5.0 版本**：
- 支持专有消费者。
- 提供与 ActiveMQ 5.x 相同的虚拟主题命名能力。
- 支持 SSL 证书吊销列表。
- 支持 OpenWire 的最后值队列。
- **2.4.0 版本**：
- 支持通过 XML 配置 JMX。
- 支持 STOMP WebSocket 的最大帧负载长度配置。
- 支持基于 JDBC 的高可用性配置。
- **2.14.0 版本**：
- 提供更新分发策略。
- 支持禁用队列以避免消息路由。
- 支持 JVM 垃圾回收和线程指标。
- **2.13.0 版本**：
- 支持地址的最小/最大过期延迟。
- 新增按接受器的安全域配置。
- 提供健康检查工具。
- **2.12.0 版本**：
- 支持 SOCKS 代理。
- 支持大消息的 AMQP 支持。
- 自动创建死亡队列和过期队列。
- 支持通过环境变量覆盖 JVM 参数。

### 4. 升级指南
文档提供了从旧版本升级到新版本的具体步骤，特别需要注意以下事项：
- **从 2.4.0 升级到 2.5.0**：
- 需要在 `acceptor` URL 中手动配置 `anycastPrefix` 和 `multicastPrefix`，以确保与旧版客户端兼容。
- **从 2.3.0 升级到 2.4.0**：
- 需要创建 `management.xml` 文件，并确保其包含必要的配置。
- **从 2.13.0 升级到 2.14.0**：
- 需要调整队列参数以匹配新版本的 `broker.xml` 配置。

### 5. 创建 Broker 实例
文档推荐将 Broker 实例目录与主程序目录分离，以便于升级和管理。创建实例的命令如下：

cd /var/lib
${ARTEMIS_HOME}/bin/artemis create mybroker

实例目录包含以下子目录：
- `bin`：包含运行脚本。
- `etc`：包含配置文件。
- `data`：存储持久化消息数据。
- `log`：存储日志文件。
- `tmp`：存储临时文件。

### 6. 其他功能
- **嵌入式 Broker**：支持将 Broker 嵌入到应用程序中，通过 POJO 或 XML 配置实现。
- **消息过期**：支持设置消息的过期地址，过期消息将被路由到指定地址。
- **HTTP 传输**：支持通过 HTTP 协议实现消息传输。

### 总结
《Apache ActiveMQ Artemis 2.15.0 用户手册》全面介绍了 ActiveMQ Artemis 的核心功能、示例实现、版本更新和升级指南，适合开发人员和系统管理员参考使用。通过合理配置和优化，可以充分发挥 ActiveMQ Artemis 的高性能和高可用性特点。