Activemq-cpp开发手册

丁靖 2008-05-06

1 引言

1.1 编写目的

快速学习CMS，提高CMS开发效率，提供一个CMS开发参考手册

详细API手册请参考http://activemq.apache.org/cms/api_docs/activemqcpp-2.1/

1.2 功能介绍

Activemq-cpp是一个与ActiveMQ交互通讯的C++ API开发库，为C++开发者提供了一个访问ActiveMQ的接口。

Winkeemq-cpp是一个在Activemq-cpp基础上封装的API库，对一些重复机械的初始化及销毁清除及一些不关心的细节进行了封装，从而简化了编程。

1.3 术语解析

ActiveMQ ：开源的消息队列服务器

Broker ：消息中介，每个消息队列服务器中至少有一个broker，是消息队列的载体 Destination ：消息在broker上的目的地 Queue ：消息队列 Topic ：主题 Message ：消息

Producer ：消息产生者 Consumer ：消息消费者

Client ：客户端，生产者和消费者都在客户端上 Server ：Activemq服务器

BrokerUri ：客户端访问服务器上broker时的Uri

其它资料请参考http://activemq.apache.org/

2 开发前准备

在开发前必须先安装activemq-cpp及winkeemq-cpp库，具体步骤参考《activemq-cpp安装及使用文档.doc》

3 CMS

3.1 p概述

CMS（stands for C++ Messaging Service）是一组C++应用程序接口(C++ API)，它提供创建、发送、接收、读取消息的服务。定义了一组和Sun公司和它的合作伙伴设计的CMS API相同的公共应用程序接口和相应语法，使得C++程序能够和其他消息组件进行通信。 CMS是一种与厂商无关的 API，用来访问消息收发系统。它类似于 JDBC (Java Database Connectivity)：这里，JDBC 是可以用来访问许多不同关系数据库的 API，而 CMS 则提供同样与厂商无关的访问方法，以访问消息收发服务。CMS 使您能够通过消息收发服务（有时称为消息中介程序或路由器）从一个 CMS 客户机向另一个客户机发送消息。消息是 CMS 中的一种类型对象，由两部分组成：报头和消息主体。报头由路由信息以及有关该消息的元数据组成。消息主体则携带着应用程序的数据或有效负载。根据有效负载的类型来划分，可以将消息分为几种类型，它们分别携带：简单文本 (TextMessage)、可序列化的对象 (ObjectMessage)、属性集合 (MapMessage)、字节流 (BytesMessage)、原始值流 (StreamMessage)，还有无有效负载的消息 (Message)。

消息收发系统是异步的，也就是说，CMS 客户机可以发送消息而不必等待回应。比较可知，这完全不同于基于 RPC 的（基于远程过程的）系统，如 EJB 1.1、CORBA 和 Java RMI 的引用实现。在 RPC 中，客户机调用服务器上某个分布式对象的一个方法。在方法调用返回之前，该客户机被阻塞；该客户机在可以执行下一条指令之前，必须等待方法调用结束。在 CMS 中，客户机将消息发送给一个虚拟通道（主题或队列），而其它 CMS 客户机则预订或监听这个虚拟通道。当 CMS 客户机发送消息时，它并不等待回应。它执行发送操作，然后继续执行下一条指令。消息可能最终转发到一个或许多个客户机，这些客户机都不需要作出回应。

CMS的通用接口集合以异步方式发送或接收消息。异步方式接收消息显然是使用间断网络连接的客户 机，诸如移动电话和PDA的最好的选择。另外， CMS采用一种宽松结合方式整合企业系统的方法，其主要的目的就是创建能够使用跨平台数据信息的、可移植的企业级应用程序，而把开发人力解放出来。

CMS消息服务支持两种消息模型：Point-to-Point消息(P2P)和发布订阅消息（Publish Subscribe messaging，简称Pub/Sub）。CMS规范并不要求供应商同时支持这两种消息模型，但开发者应该熟悉这两种消息模型的优势与缺点。 P2P消息模型是在点对点之间传递消息时使用。如果应用程序开发者希望每一条消息都能够被处理，那么应该使用P2P消息模型。与Pub/Sub消息模型不同，P2P消息总是能够被传送到指定的位置。

Pub/Sub模型在一到多的消息广播时使用。如果一定程度的消息传递的不可靠性可以被接受的话，那么应用程序开发者也可以使用Pub/Sub消息模型。换句话说，它适用于所有的消息消费程序并不要求能够收到所有的信息或者消息消费程序并不想接收到任何消息的情