续上篇介绍了第十四个ESB应用,本文介绍第十五个ESB应用——Web Service Consumer 1。
说明:本文及后续文章虽非百分百的原创,但毕竟包含本人的努力和付出,所以希望大家转载时务请注明出处:http://yarafa.iteye.com/,谢谢合作。
1 概述
本实例主要演示了如何配置ESB的Action来调用基于JSR181风格注释的Web Service,即ESB的Action用作Web Service的客户端。
2 新建ESB工程
操作过程略。
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=webserviceconsumer1Esb" 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=webserviceconsumer1EsbReply" 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=webserviceconsumer1RequestGw" 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-type="QUEUE" dest-name="queue/webserviceconsumer1RequestGw" /> </jms-bus> <jms-bus busid="esbChanel"> <jms-message-filter dest-name="queue/webserviceconsumer1Esb" dest-type="QUEUE" /> </jms-bus> </jms-provider>
3.3 定义Service
<service category=" Webservice" description=" Webservice" name=" WebserviceConsumer1"> <listeners /> <actions mep="OneWay" /> </service>
3.4 定义Listener
<listeners> <jms-listener busidref="gwChanel" is-gateway="true" name="gwListener" /> <jms-listener busidref="esbChanel" name="esbListener" /> </listeners>
3.5 定义Action类
3.5.1 MyRequestAction
/***********************************************************************
* <p>Project Name: webserviceconsumer1</p>
* <p>File Name: com.thu.afa.esb.jbossesb.action.MyRequestAction.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 java.util.HashMap;
import org.jboss.soa.esb.actions.AbstractActionLifecycle;
import org.jboss.soa.esb.helpers.ConfigTree;
import org.jboss.soa.esb.message.Message;
/**
* <p>Class Name: MyRequestAction</p>
* <p>Description: </p>
* @author Afa
* @date 2010-9-26
* @version 1.0
*/
public class MyRequestAction extends AbstractActionLifecycle
{
protected ConfigTree configTree;
public MyRequestAction(ConfigTree configTree)
{
this.configTree = configTree;
}
public Message process(Message message) throws Exception
{
System.out.println("Receiving Messages From Client");
String body = (String) message.getBody().get();
HashMap<String, Object> request = new HashMap<String, Object>();
// add parameters to the web service request map
request.put("sayHello.toWhom", body);
message.getBody().add(request);
System.out.println("Request map is: " + request.toString());
return message;
}
public void exceptionHandler(Message message, Throwable exception)
{
System.out.println("!ERROR!");
System.out.println(exception.getMessage());
System.out.println("For Message: ");
System.out.println(message.getBody().get());
}
}
说明:request.put("sayHello.toWhom", body);,该语句将客户端发来的消息内容作为要调用的Web Service中sayHello方法的参数,交由下一个action进行处理。
3.5.2 MyResponseAction
/***********************************************************************
* <p>Project Name: webserviceconsumer1</p>
* <p>File Name: com.thu.afa.esb.jbossesb.action.MyResponseAction.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 java.util.Map;
import org.jboss.soa.esb.actions.AbstractActionLifecycle;
import org.jboss.soa.esb.helpers.ConfigTree;
import org.jboss.soa.esb.message.Body;
import org.jboss.soa.esb.message.Message;
/**
* <p>Class Name: MyResponseAction</p>
* <p>Description: </p>
* @author Afa
* @date 2010-9-26
* @version 1.0
*/
public class MyResponseAction extends AbstractActionLifecycle
{
protected ConfigTree configTree;
public MyResponseAction(ConfigTree configTree)
{
this.configTree = configTree;
}
@SuppressWarnings("unchecked")
public Message process(Message message) throws Exception
{
Map<String, Object> response = (Map<String, Object>) message.getBody().get(Body.DEFAULT_LOCATION);
System.out.println("Response Map is: " + response);
return message;
}
public void exceptionHandler(Message message, Throwable exception)
{
System.out.println("!ERROR!");
System.out.println(exception.getMessage());
System.out.println("For Message: ");
System.out.println(message.getBody().get());
}
}
说明:该action用于打印输出调用Web Service的返回结果。
3.6 发布Web Services
3.6.1 创建Dynamic Web Project
创建过程略。
3.6.2 创建服务类
/***********************************************************************
* <p>Project Name: webservice</p>
* <p>File Name: com.thu.afa.ws.HelloWorldWS.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.ws;
import java.util.Date;
import javax.jws.WebMethod;
import javax.jws.WebParam;
import javax.jws.WebService;
/**
* <p>Class Name: HelloWorldWS</p>
* <p>Description: </p>
* @author Afa
* @date 2010-9-26
* @version 1.0
*/
@WebService
(
name = "HelloWorld",
targetNamespace = "http://afa.thu.com/ws/helloworld"
)
public class HelloWorldWS
{
@WebMethod
public String sayHello(@WebParam(name = "toWhom") String toWhom)
{
String greeting = "Hello World Greeting for '" + toWhom + "' on " + new Date();
return greeting;
}
}
注意:注释语句@WebParam(name = "toWhom")不可少,否则,在调用服务时将找不到参数。
3.6.3 配置服务
在web.xml文件中添加如下配置信息即可将服务类中指定的方法发布为Web Service。
<servlet> <servlet-name>helloWorldWS</servlet-name> <servlet-class>com.thu.afa.ws.HelloWorldWS</servlet-class> </servlet> <servlet-mapping> <servlet-name>helloWorldWS</servlet-name> <url-pattern>/servlet/helloWorldWS</url-pattern> </servlet-mapping>
3.6.4 发布
将工程导出为war包并部署到web服务器的部署目录即可。如欲查看服务是否已发布,可在浏览器中浏览如下地址:http://localhost:8080/jbossws/services,这里是将工程发布到JBoss应用服务器或者JBoss ESB服务器后的查看地址。
3.7 配置Action
<action class="com.thu.afa.esb.jbossesb.action.MyRequestAction" name="request-mapper" process="process" /> <action class="org.jboss.soa.esb.actions.soap.SOAPClient" name="soapClientAction"> <property name="wsdl" value="http://localhost:8080/webservice/servlet/helloWorldWS?wsdl" /> <property name="SOAPAction" value="sayHello" /> <property name="responseAsOgnlMap" value="true" /> </action> <action name="response-mapper" process="process" class="com.thu.afa.esb.jbossesb.action.MyResponseAction" />
注意:在第二个action中,SOAPAction属性表明要调用的服务中的方法名称,不能用operation属性,否则,在部署esb时就会出错。
3.8 配置部署文件
部署依赖文件deployment.xml内容如下:
<jbossesb-deployment> <depends>jboss.esb:deployment=soap.esb</depends> <depends>jboss.esb:service=SoapUIClientService</depends> <depends>jboss.esb.quickstart.destination:service=Queue,name=webserviceconsumer1Esb </depends> <depends>jboss.esb.quickstart.destination:service=Queue,name=webserviceconsumer1EsbReply </depends> <depends>jboss.esb.quickstart.destination:service=Queue,name=webserviceconsumer1RequestGw </depends> </jbossesb-deployment>
3.9 部署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.WebServiceConsumer1.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: WebServiceConsumer1</p>
* <p>Description: </p>
* @author Afa
* @date 2010-9-26
* @version 1.0
*/
public class WebServiceConsumer1Client
{
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/webserviceproducerGw");
//queue = (Queue) context.lookup("queue/webserviceconsumer1RequestGw");
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();
System.out.println("Client Stopped");
}
public void sendAMessage(String text) throws Exception
{
QueueSender sender = session.createSender(queue);
ObjectMessage message = session.createObjectMessage(text);
sender.send(message);
sender.close();
}
/**
* <p>Title: </p>
* <p>Method Name: main</p>
* <p>Description: </p>
* @author: Afa
* @date: 2010-9-26
* @param args
*/
public static void main(String[] args) throws Exception
{
WebServiceConsumer1Client client = new WebServiceConsumer1Client();
client.setupConnection();
client.sendAMessage("Llu");
client.stop();
}
}
运行客户端程序即可看到如下输出结果:
-----------------------------------------------------
Stay Hungry, Stay Foolish!
http://yarafa.iteye.com
Afa
Apr 15th, 2011
-----------------------------------------------------