续上篇介绍了第十个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
-----------------------------------------------------