JBoss ESB学习笔记12——第十一个ESB应用Spring Hello World

续上篇介绍了第十个ESB应用，本文介绍第十一个ESB应用——Spring Hello World。

 

说明：本文及后续文章虽非百分百的原创，但毕竟包含本人的努力和付出，所以希望大家转载时务请注明出处：http://yarafa.iteye.com，谢谢合作。

 

 

1 概述
本实例主要演示了基于spring的action调用，这里需要引用spring相关的jar包，这些jar包都可以在所下载的jboss esb中找到。

 

2 新建ESB工程
新建ESB工程，在jbossesb-server-4.7中找到以下两个jar包：jbossesb-spring.jar和spring-2.5.6.SEC01.jar，并将这两个jar包复制到esbcontent/lib目录下，同时添加到项目的classpath。至于这两个jar包的具体位置，不记得了，可以直接搜索找到。

 

3 ESB配置
3.1 创建消息队列

<?xml version="1.0" encoding="UTF-8"?>
<server>
	<mbean code="org.jboss.jms.server.destination.QueueService"		name="jboss.esb.quickstart.destination:service=Queue,name=springhelloworldRequest" 	xmbean-dd="xmdesc/Queue-xmbean.xml">
		<depends optional-attribute-name="ServerPeer">
jboss.messaging:service=ServerPeer
		</depends>
		<depends>jboss.messaging:service=PostOffice</depends>
	</mbean>
	<mbean code="org.jboss.jms.server.destination.QueueService"		name="jboss.esb.quickstart.destination:service=Queue,name=springhelloworldResponse" xmbean-dd="xmdesc/Queue-xmbean.xml">
		<depends optional-attribute-name="ServerPeer">
jboss.messaging:service=ServerPeer
		</depends>
		<depends>jboss.messaging:service=PostOffice</depends>
	</mbean>
	<mbean code="org.jboss.jms.server.destination.QueueService"		name="jboss.esb.quickstart.destination:service=Queue,name=springhelloworldEsb" 	xmbean-dd="xmdesc/Queue-xmbean.xml">
		<depends optional-attribute-name="ServerPeer">
jboss.messaging:service=ServerPeer
		</depends>
		<depends>jboss.messaging:service=PostOffice</depends>
	</mbean>
</server>

 

3.2 定义Provider
这里将定义一个JMS Provider，并定义2个消息通道，内容如下：

<jms-provider connection-factory="ConnectionFactory" name="JBossMQ">
	<jms-bus busid="gwChanel">
		<jms-message-filter dest-name="queue/springhelloworldRequest"
			dest-type="QUEUE" />
	</jms-bus>
	<jms-bus busid="esbChanel">
		<jms-message-filter dest-name="queue/springhelloworldEsb"
			dest-type="QUEUE" />
	</jms-bus>
</jms-provider>

 

3.3 定义Service

<service category="SpringHelloWorld" description="Spring Hello
World" 	name="SpringHelloWorldService">
	<listeners />
	<actions mep="OneWay">
		<action />
	</actions>
</service>

 

3.4 定义Listener

<listeners>
	<jms-listener busidref="gwChanel" is-gateway="true"
		name="gwListener" />
	<jms-listener busidref="esbChanel" name="esbListener" />
</listeners>

 

3.5 定义Java Bean

/***********************************************************************
 * <p>Project Name: springhelloworld</p>
 * <p>File Name: com.thu.afa.esb.jbossesb.action.SaySomething.java</p>
 * <p>Copyright: Copyright (c) 2010</p>
 * <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
 ***********************************************************************/
package com.thu.afa.esb.jbossesb.action;

/**
 * <p>Class Name: SaySomething</p>
 * <p>Description: </p>
 * @author Afa
 * @date 2010-9-16
 * @version 1.0
 */
public class SaySomething
{
	private String greeting;

	public String getGreeting()
	{
		return greeting;
	}

	public void setGreeting(String greeting)
	{
		this.greeting = greeting;
	}
	
}

说明：这是一个普通的JavaBean，为后面验证spring在ESB中的IOC功能而引入。

 

3.6 定义Action

/***********************************************************************
 * <p>Project Name: springhelloworld</p>
 * <p>File Name: com.thu.afa.esb.jbossesb.action.MySpringEnabledAction.java</p>
 * <p>Copyright: Copyright (c) 2010</p>
 * <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
 ***********************************************************************/
package com.thu.afa.esb.jbossesb.action;

import org.jboss.soa.esb.actions.AbstractSpringAction;
import org.jboss.soa.esb.helpers.ConfigTree;
import org.jboss.soa.esb.message.Body;
import org.jboss.soa.esb.message.Message;

/**
 * <p>Class Name: MySpringEnabledAction</p>
 * <p>Description: </p>
 * @author Afa
 * @date 2010-9-16
 * @version 1.0
 */
public class MySpringEnabledAction extends AbstractSpringAction
{
	@SuppressWarnings({"deprecation" })
	public MySpringEnabledAction(final ConfigTree configTree)
	{
		this.configTree = configTree;
	}
	
	public Message displayMessage(Message message) throws Exception
	{
		System.out.println("Body: " + message.getBody().get());
		return message;
	}
	
	public Message sayHelloSpring(Message message) throws Exception
	{
		SaySomething saySomething = (SaySomething) getBeanFactory().getBean("saySomething");
		Body body = message.getBody();
		String contents = (String) message.getBody().get();
		StringBuffer buffer = new StringBuffer();
		buffer.append(contents + "\n");
		buffer.append(saySomething.getGreeting());
		body.add(buffer.toString());
		
		return message;
	}
}

注意：这里的action 扩展的是AbstractSpringAction类，而不是AbstractActionLifecycle。 

3.7 Spring配置
在src目录下创建spring配置文件：spring-context.xml，内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans ttp://www.springframework.org/schema/beans/spring-beans-2.0.xsd">
	<bean id="saySomething"
		class="com.thu.afa.esb.jbossesb.action.SaySomething">
		<property name="greeting" value="hello from Spring" />
	</bean>
</beans>

经常跟Spring打交道的朋友看到这里应该感到很亲切了，这里的配置跟平时的没什么分别。想必大家也能猜到，这里的配置是利用Spring的依赖注入功能，在程序中获取greeting属性的值。

 

3.8 配置Action

<actions mep="OneWay">
	<action name="sayHelloAction"
	class="com.thu.afa.esb.jbossesb.action.MySpringEnabledAction"
	process="sayHelloSpring,displayMessage">
	<property name="exceptionMethod" value="exceptionHandler" />
	<property name="springContextXml" value="spring-context.xml" />
	</action>
</actions>

说明：这里的springContextXml属性指明了spring配置文件的位置。消息处理分发是sayHelloSpring和displayMessage，按顺序依次执行。首先执行sayHelloSpring方法，往消息主体中添加SaySomething的greeting属性的值，而该属性值是通过上面的spring配置文件注入的。后面的测试结果会证明这一点。

 

3.9 配置部署文件
部署依赖文件deployment.xml内容如下：

<jbossesb-deployment>
	<depends>jboss.esb:deployment=spring.esb</depends>
	<depends>jboss.esb.quickstart.destination:service=Queue,name=springhelloworldRequest
	</depends>
	<depends>jboss.esb.quickstart.destination:service=Queue,name=springhelloworldResponse
	</depends>
	<depends>jboss.esb.quickstart.destination:service=Queue,name=springhelloworldEsb
	</depends>
</jbossesb-deployment>

 

3.10 部署ESB
将整个工程导出成一个ESB文件，并保存至JBoss ESB Server的部署目录下，启动JBoss ESB Server即可。

 

4 ESB客户端
4.1 新建Java工程
这里略去操作过程以及添加所需要的Jar包，具体操作过程可参考第一个ESB实例说明。

 

4.2 发送消息的客户端

/***********************************************************************
 * <p>Project Name: helloworldclient</p>
 * <p>File Name: com.thu.afa.esb.jbossesb.client.SpringHelloWorldClient.java</p>
 * <p>Copyright: Copyright (c) 2010</p>
 * <p>Company: <a href="http://afa.thu.com">http://afa.thu.com</a></p>
 ***********************************************************************/
package com.thu.afa.esb.jbossesb.client;

import java.util.Properties;

import javax.jms.ObjectMessage;
import javax.jms.Queue;
import javax.jms.QueueConnection;
import javax.jms.QueueConnectionFactory;
import javax.jms.QueueSender;
import javax.jms.QueueSession;
import javax.naming.Context;
import javax.naming.InitialContext;

/**
 * <p>Class Name: SpringHelloWorldClient</p>
 * <p>Description: </p>
 * @author Afa
 * @date 2010-9-16
 * @version 1.0
 */
public class SpringHelloWorldClient
{
	private QueueConnection connection;
	private QueueSession session;
	private Queue queue;
	
	public void setupConnection() throws Exception
	{
		Properties properties = new Properties();
		properties.put(Context.INITIAL_CONTEXT_FACTORY, "org.jnp.interfaces.NamingContextFactory");   
		properties.put(Context.URL_PKG_PREFIXES, "org.jboss.naming:org.jnp.interfaces");   
		properties.put(Context.PROVIDER_URL, "jnp://127.0.0.1:1099");
		InitialContext context = new InitialContext(properties);
		
		QueueConnectionFactory factory = (QueueConnectionFactory) context.lookup("ConnectionFactory");
		connection = factory.createQueueConnection();
		queue = (Queue) context.lookup("queue/springhelloworldRequest");
		session = connection.createQueueSession(false, QueueSession.AUTO_ACKNOWLEDGE);
		connection.start();
		
		System.out.println("Connection Started");
	}
	
	public void stop() throws Exception
	{
		if(connection != null) connection.stop();
		if(session != null) session.close();
		if(connection != null) connection.close();
	}
	
	public void sendAMessage(String text) throws Exception
	{
		QueueSender sender = session.createSender(queue);
		ObjectMessage message = session.createObjectMessage(text);
		sender.send(message);
		sender.close();
	}
	
	public static void main(String[] args) throws Exception
	{
		SpringHelloWorldClient client = new SpringHelloWorldClient();
		client.setupConnection();
		client.sendAMessage("Llu, miss you, afa - hello, spring");
		client.stop();
	}
	
	
}

 

运行客户端程序即可看到以下输出结果：

  

 

 

-----------------------------------------------------
Stay Hungry, Stay Foolish!
http://yarafa.iteye.com
Afa
Apr 1st, 2011
-----------------------------------------------------