选择ActiveMQ作为JMS的入门学习中间件,是因为其拥有以下优点
1.多种语言和协议编写客户端。语言: Java, C, C++, C#, Ruby, Perl, Python, PHP。应用协议: OpenWire,Stomp REST,WS Notification,XMPP,AMQP
2.完全支持JMS1.1和J2EE 1.4规范 (持久化,XA消息,事务)
3.对Spring的支持,ActiveMQ可以很容易内嵌到使用Spring的系统里面去,而且也支持Spring2.0的特性
4.完全支持JMS1.1和J2EE 1.4规范 (持久化,XA消息,事务)
5.通过了常见J2EE服务器(如 Geronimo,JBoss 4, GlassFish,WebLogic)的测试,其中通过JCA 1.5 resource adaptors的配置,可以让ActiveMQ可以自动的部署到任何兼容J2EE 1.4 商业服务器上
6.支持多种传送协议:in-VM,TCP,SSL,NIO,UDP,JGroups,JXTA
7.从设计上保证了高性能的集群,客户端-服务器,点对点
8.支持Ajax
9.支持与Axis的整合
10.可以很容易得调用内嵌JMS provider,进行测试
学会了ActiveMQ之后,其它供应商的MQ也可以在短时间内快速上手。
安装:
ActiveMQ(本文简称MQ)要求JDK1.5以上,推荐1.6以上版本。还没安装JDK的朋友,请先安装,在此不赘诉了。
安装完JDK后,从 http://activemq.apache.org/download.html下载MQ的最新版本,本教程使用版本为5.5。
解压后,可以看到MQ目录下有以下文件和目录
activemq-all-5.5.0.jar:所有MQ JAR包的集合,用于用户系统调用
bin:其中包含MQ的启动脚本
conf:包含MQ的所有配置文件
data:日志文件及持久性消息数据
example:MQ的示例
lib:MQ运行所需的所有Lib
webapps:MQ的Web控制台及一些相关的DEMO
启动MQ:
双击bin目录下的activemq.bat文件即可启动MQ
第一个示例:
新建一个JAVA工程,引用activemq-all-5.5.0.jar,SLFAPI其及对应版本LOG4J的JAR包(懒的上网找的到附件里下载)
import java.util.Hashtable;
import java.util.Map;
import javax.jms.Connection;
import javax.jms.ConnectionFactory;
import javax.jms.Destination;
import javax.jms.JMSException;
import javax.jms.MapMessage;
import javax.jms.Message;
import javax.jms.MessageProducer;
import javax.jms.Session;
import org.apache.activemq.ActiveMQConnectionFactory;
import org.apache.activemq.command.ActiveMQMapMessage;
public class Publisher {
protected int MAX_DELTA_PERCENT = 1;
protected Map<String, Double> LAST_PRICES = new Hashtable<String, Double>();
protected static int count = 10;
protected static int total;
protected static String brokerURL = "tcp://localhost:61616";
protected static transient ConnectionFactory factory;
protected transient Connection connection;
protected transient Session session;
protected transient MessageProducer producer;
public Publisher() throws JMSException {
factory = new ActiveMQConnectionFactory(brokerURL);
connection = factory.createConnection();
try {
connection.start();
} catch (JMSException jmse) {
connection.close();
throw jmse;
}
session = connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
producer = session.createProducer(null);
}
public void close() throws JMSException {
if (connection != null) {
connection.close();
}
}
public static void main(String[] args) throws JMSException {
Publisher publisher = new Publisher();
while (total < 1000) {
for (int i = 0; i < count; i++) {
publisher.sendMessage(args);
}
total += count;
System.out.println("Published '" + count + "' of '" + total + "' price messages");
try {
Thread.sleep(1000);
} catch (InterruptedException x) {
}
}
publisher.close();
}
protected void sendMessage(String[] stocks) throws JMSException {
int idx = 0;
while (true) {
idx = (int)Math.round(stocks.length * Math.random());
if (idx < stocks.length) {
break;
}
}
String stock = stocks[idx];
Destination destination = session.createTopic("STOCKS." + stock);
Message message = createStockMessage(stock, session);
System.out.println("Sending: " + ((ActiveMQMapMessage)message).getContentMap() + " on destination: " + destination);
producer.send(destination, message);
}
protected Message createStockMessage(String stock, Session session) throws JMSException {
Double value = LAST_PRICES.get(stock);
if (value == null) {
value = new Double(Math.random() * 100);
}
// lets mutate the value by some percentage
double oldPrice = value.doubleValue();
value = new Double(mutatePrice(oldPrice));
LAST_PRICES.put(stock, value);
double price = value.doubleValue();
double offer = price * 1.001;
boolean up = (price > oldPrice);
MapMessage message = session.createMapMessage();
message.setString("stock", stock);
message.setDouble("price", price);
message.setDouble("offer", offer);
message.setBoolean("up", up);
return message;
}
protected double mutatePrice(double price) {
double percentChange = (2 * Math.random() * MAX_DELTA_PERCENT) - MAX_DELTA_PERCENT;
return price * (100 + percentChange) / 100;
}
}
Consumer.java
import java.text.DecimalFormat;
import javax.jms.MapMessage;
import javax.jms.Message;
import javax.jms.MessageListener;
public class Listener implements MessageListener {
public void onMessage(Message message) {
try {
MapMessage map = (MapMessage)message;
String stock = map.getString("stock");
double price = map.getDouble("price");
double offer = map.getDouble("offer");
boolean up = map.getBoolean("up");
DecimalFormat df = new DecimalFormat( "#,###,###,##0.00" );
System.out.println(stock + "\t" + df.format(price) + "\t" + df.format(offer) + "\t" + (up?"up":"down"));
} catch (Exception e) {
e.printStackTrace();
}
}
}
先运行Consumer.java, 输入参数ORCL,然后运行Publisher.java,输入参数ORCL,
就可以看到Publisher在发送消息,Consumer在接收消息了。
(不知道怎么在ECLIPSE里带参数运行程序的,请自行GOOGLE。)
好了,MQ的安装与第一个示例程序的介绍就到此为止了。
JMS API的主要概念如一下:
JMS client: 纯Java写的用于发送和接收消息的应用程序
Non-JMS client: 用JMS提供的本地用户API来发送和接收消息的应用程序
JMS producer: 创建和发送JMS消息的客户端
JMS consumer: 接收和处理JMS消息的客户端
JMS provider: 完全用Java写的JMS接口的实现
JMS message: JMS消息
JMS domains: 两种发送方式,包括点对点(point-to-point)和发布/订阅(publish/subscribe)
Administered objects: 预定义的包含JMS provider的配置数据,客户端一般通过JNDI调用
Connection factory: 客户端用Connection Factory创建Connection来连接JMS provider
Destination: 用于记录消息的目的地址或接收地址。
本节只列出提纲,详细说明,请查看附件。
下面对两种JMS domains进行一下说明:
1.publish/subscribe
在这种模式下,MQ服务器中的客户端可订阅自己感兴趣的TOPIC,当其它客户端向MQ服务器发送一个TOPIC且该TOPIC是自己订阅过的TOPIC,则接收该消息。上一节的例子就是用了这个模式
2.point-to-point
在这种模式下,消息是点对点发送的,一个QUEUE只会发送到一个客户端。
在MQ目录/conf/activemq-demo.xml中可看到如下配置
- <transportConnectors>
- <transportConnector name="openwire" uri="tcp://localhost:61616"
- discoveryUri="multicast://default"/>
- <transportConnector name="ssl" uri="ssl://localhost:61617"/>
- <transportConnector name="stomp" uri="stomp://localhost:61613"/>
- <transportConnector name="xmpp" uri="xmpp://localhost:61222"/>
- </transportConnectors>
<transportConnectors> <transportConnector name="openwire" uri="tcp://localhost:61616" discoveryUri="multicast://default"/> <transportConnector name="ssl" uri="ssl://localhost:61617"/> <transportConnector name="stomp" uri="stomp://localhost:61613"/> <transportConnector name="xmpp" uri="xmpp://localhost:61222"/> </transportConnectors>
可以看到在MQ中可配置个连接,并且还可以配置多种协议的连接。
MQ中支持的网络协议有TCP、NIO、UDP、SSL、HTTP(S)、VM等。
下面对其中常用的几种进行一下说明。
TCP:
MQ默认使用的协议,开放性、高效性、可靠性是其主要特点,这个协议可满足一般应用的大部分需求,因此在项目中还是比较常用的。第一节中的例子用到的就是TCP协议。
NIO:
NIO的概念是在JAVASE1.4首先提出来的,这是一种新的JAVA IO模型,是对底层IO的一种封装,让程序员们可以更方便的对IO进行操作。
这种协议下,网络消息的传播效率非常的高。因此,当系统存在高用户量、高并发或网络堵塞时,可考虑用此协议。
配置示例如下:
- <transportConnector name="nio" uri="nio:localhost:61618" />
<transportConnector name="nio" uri="nio:localhost:61618" />
SSL:
安全套接层协议,这种协议比较重要,因此本教程将对SSL协议连接方式作重点介绍。
在MQ目录/conf/activemq.xml文件中修改以下配置
- <sslContext>
- <sslContext keyStore="file:${activemq.base}/conf/broker.ks" keyStorePassword="password"/>
- </sslContext>
- <transportConnectors>
- <transportConnector name="ssl" uri="ssl://localhost:61617"/>
- </transportConnectors>
<sslContext> <sslContext keyStore="file:${activemq.base}/conf/broker.ks" keyStorePassword="password"/> </sslContext> <transportConnectors> <transportConnector name="ssl" uri="ssl://localhost:61617"/> </transportConnectors>
broker.ks是MQ的默认证书,默认密码为password
启动activemq.bat
可发现MQ已经以SSL方式启动,端口为61617
将第一节中Consumer.java与Publisher.java的以下代码
- protected static String brokerURL = "tcp://localhost:61616";
protected static String brokerURL = "tcp://localhost:61616";
修改为
- protected static String brokerURL = "ssl://localhost:61617";
protected static String brokerURL = "ssl://localhost:61617";
在Consumer.java和Publisher的VM arguments 里输入
-Djavax.net.ssl.keyStore=MQ目录\conf\client.ks
-Djavax.net.ssl.keyStorePassword=password
-Djavax.net.ssl.trustStore=MQ目录\conf\client.ts
设置Consumer.java和Publisher的Program arguments为 ORCL
启动Consumer.java和Publisher,将看到和第一节示例一样的结果,只不过这里的连接协议改为了SSL。
由于本例中用到的证书是MQ自带的,正式环境中不可能用默认证书,否则SSL将形同虚设。因此,我们必须生成自己的证书,以保证其安全性。
在命令行中输入
keytool -genkey -alias broker -keyalg RSA -keystore mybroker.ks
按提示输入密码(本例子的密码为test123)和其它信息,可以看到在当前目录下生成了一个mybroker.ks文件,接着在命令行输入keytool -export -alias broker -keystore mybroker.ks -file mybroker_cert,输入刚才的密码test123,生成mybroker_cert。
接成生成客户端keystore,输入keytool -genkey -alias client -keyalg RSA -keystore myclient.ks,输入客户端密码和其它信息,生成myclient.ks,接着输入keytool -import -alias broker -keystore myclient.ts -file mybroker_cert,生成myclient.ts。
证书生成的工作就完成了。
接着把刚刚生成的证书复制到MQ目录\conf下,将activemq.xml的sslContext节点修改为
- <sslContext>
- <sslContext keyStore="file:${activemq.base}/conf/mybroker.ks" keyStorePassword="test123"/>
- </sslContext>
<sslContext> <sslContext keyStore="file:${activemq.base}/conf/mybroker.ks" keyStorePassword="test123"/> </sslContext>
重启MQ,修改Consumer.java和Publisher.java和VM参数为
-Djavax.net.ssl.keyStore=MQ目录\conf\myclient.ks
-Djavax.net.ssl.keyStorePassword=test123
-Djavax.net.ssl.trustStore=MQ目录\conf\myclient.ts
启动Consumer.java和Publisher.java
到此,我们把我们自己生成的证书用到了SSL协议上。
其它诸如HTTP(S)/UDP(不可靠性)/VM(用于虚拟机内应用程序间的通信)等协议,在实际中用的并不多,本教程就不介绍了。