初始配置
初始配置
首先,您需要将 jar 包添加到您的类路径中。
必需的 JAR 包
为了使 ActiveMQ Classic 易于使用,默认的 activemq-all.jar 包含了所有必要的库。如果您希望明确控制 ActiveMQ Classic 使用的所有 jar 包,以下是必需的单个 jar 包的完整列表:
- activemq-broker.jar
- activemq-client.jar
- activeio-core.jar
- activemq-kahadb-store.jar (如果您想使用持久化)
- slf4j-api.jar
- J2EE API,可以是来自 Sun 的 j2ee.jar 或您的 J2EE 容器,或者您可以使用 Geronimo 的免费分发版 geronimo-spec-j2ee.jar。如果您在 servlet 容器内部,并且依赖于 j2ee.jar 导致出现问题,那么我们依赖的 J2EE jar 的部分如下:
- geronimo-spec-jms.jar
- geronimo-spec-jta.jar
- geronimo-spec-j2ee-management.jar
如果您想获取 J2EE 规范 jar,我们建议您使用 Apache 存储库
可选的 JAR 包
- spring.jar - 如果您想使用 XML 配置文件来配置消息代理
- 如果您想使用消息持久化,则需要将持久化 jar 包添加到您的类路径中(见下文)。如果您只需要一个没有持久性的轻量级消息总线,则可以跳过此步骤,但我们强烈建议在生产部署中使用持久化。
持久化支持
我们支持通过 专用的 KahaDB 文件系统消息存储或 JDBC 进行持久化。要完全控制配置,请查看 XML 配置。如果您想使用 KahaDB,请将 kahadb.jar 包含在您的类路径中。对于 JDBC,您需要包含相应的数据库驱动程序。
如果您只是进行一些测试或在 VM 内进行基于 SEDA 的消息传递,您可能希望禁用持久化。您可以使用 XML 配置 来实现这一点。
在 5.x 版本中,您可以通过将 persistent=false
属性设置为 false 来禁用持久化,无论是通过 XML 配置 还是在 代理 URL 中。
下一步
您可能想要做的第一件事之一是 启动代理。代理运行后,您可以尝试一些 示例程序
如果您想编写自己的应用程序,您可以直接实例化一个 ActiveMQConnectionFactory,配置其属性,然后就可以使用标准的 JMS API 来创建 Connection、Session、MessageProducer 和 MessageConsumer 实例。
您还可以查看我们的 单元测试,以获取更多有关如何使用 ActiveMQ Classic 的示例。
其他资源
相关阅读
- Sun 的 JMS 教程 是一个很好的起点,可以了解如何直接使用 JMS API
- ActiveMQ Classic 网站 提供了有关如何使用 ActiveMQ Classic 的详细信息
- ActiveMQ Classic 拓扑结构
- ActiveMQ Classic 集群
- ActiveMQ Classic 代理网络
- 分阶段事件驱动架构 (SEDA)
规范
相关开源项目
- Apache Camel
- Apache Geronimo
- Stomp 是一种开放式线路协议(类似于 HTTP),用于与不同语言的 MOM 进行通信。它为 C、C#、Python、Perl、Ruby 等语言提供客户端。
- XBean 被用作 ActiveMQ Classic 的默认 XML 配置机制