Apache ActiveMQ Artemis 1.5.3 User Manual

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

摘要

The document provides an in-depth guide to Apache ActiveMQ Artemis 1.5.3, covering installation, configuration, and usage. It details supported protocols such as AMQP, MQTT, and STOMP, and explains how to configure them. The guide also covers logging setup, security measures, and management features. Additionally, it includes examples for using JMS and explains how to handle large messages and last-value queues.

AI总结

《Apache ActiveMQ Artemis 1.5.3 用户指南》总结如下：

### 1. 安装与配置
- **安装目录结构**：
- `bin`：包含运行ActiveMQ Artemis所需的二进制文件和脚本。
- `web`：Web上下文加载目录。
- `lib`：运行ActiveMQ Artemis所需的JAR和库文件。
- `licenses`：许可证文件。
- `schemas`：用于验证ActiveMQ Artemis配置文件的XML架构。

- **创建 Broker 实例**：
- Broker 实例目录包含配置和运行时数据（如日志和数据文件）。
- 建议将实例目录与主安装目录分离，便于后续升级。
- 示例命令：`mkdir /var/lib/mybroker`。

### 2. 协议与 interoperability
- **支持的协议**：
- AMQP 1.0
- OpenWire
- MQTT
- STOMP
- HornetQ
- Artemis 自有的高性能“Core”协议。

- **配置协议**：
- 通过配置 `acceptors` 启用特定协议。
- 示例：`tcp://localhost:1883?protocols=MQTT` 启用 MQTT。
- 默认配置包含多个协议接受器。

### 3. 安全性
- **默认 Web 访问**：
- 使用 plain HTTP，默认绑定地址为 `http://localhost:8161`。
- 可通过配置 `bootstrap.xml` 启用 HTTPS。

- **安全配置**：
- 支持通过 `keystorePath` 和 `keystorePassword` 配置 SSL 证书。
- 可设置 `clientAuth` 和 `trustStorePath` 等属性实现双向认证。

### 4. 日志管理
- **日志框架**：
- 使用 JBoss Logging 框架，日志级别包括 `INFO` 和 `DEBUG` 等。
- 默认配置同时输出控制台和文件日志。

- **客户端日志配置**：
- 在客户端程序中设置 `java.util.logging.manager=org.jboss.logmanager.LogManager` 和 `logging.configuration` 属性。
- 示例日志配置文件：`logging.properties`。

### 5. 高级功能
- **大消息支持**：
- 支持传输和存储远大于内存容量的大消息。
- 消息持久化到磁盘，确保服务器重启后仍可访问。

- **最后值队列（Last-Value Queue）**：
- 仅保留最新消息的队列，适用于股票价格等实时数据场景。

- **JMS 对象消息反序列化控制**：
- 提供黑白名单机制，控制可反序列化的类。
- 黑名单优先级高于白名单，确保安全。

### 6. 示例与工具
- 提供多个 JMS 和 Java EE 示例，涵盖消息发送、接收、桥接等场景。
- 提供 JMX 管理工具，支持通过 JMX 监控和管理 ActiveMQ Artemis 服务。

### 总结
Apache ActiveMQ Artemis 是一个功能强大的消息中间件，支持多种协议和高级功能，适用于高性能、高可靠性的分布式 messaging 系统。文档详细介绍了安装、配置、安全、日志管理及其实现细节，帮助用户快速上手并深入掌握其功能。