续上篇介绍了第六个ESB应用,本文介绍第七个ESB应用——Https Gateway。
说明:本文及后续文章虽非百分百的原创,但毕竟包含本人的努力和付出,所以希望大家转载时务请注明出处:http://yarafa.iteye.com,谢谢合作。
1概述
该实例主要演示了两点:一是配置一个https的ESB入口,二是在ESB外部端点中配置http路由器实现https传输方式的调用。
2 新建ESB工程
操作过程略。
3 ESB配置
3.1 创建消息队列
这里将创建一个消息地理用于接收客户端消息,在esbcontent文件夹下创建文件jbm-queue-service.xml用于配置消息队列,内容如下:
<?xml version="1.0" encoding="UTF-8"?> <server> <mbean code="org.jboss.jms.server.destination.QueueService" name="jboss.esb.quickstart.destination:service=Queue,name=httpsgateway" xmbean-dd="xmdesc/Queue-xmbean.xml"> <dependsptional-attribute-name="ServerPeer"> jboss.messaging:service=ServerPeer </depends> <depends>jboss.messaging:service=PostOffice</depends> </mbean> </server>
3.2 定义Provider
这里将创建两个provider,一个提供客户端消息通道,另一个是jbr-provider,下面具体介绍。
3.2.1 jms-provider
<jms-provider connection-factory="ConnectionFactory" name="JMS"> <jms-bus busid="httpsgatewayChanel"> <jms-message-filter dest-name="queue/httpsgateway" dest-type="QUEUE" /> </jms-bus> </jms-provider>
3.2.2 jbr-provider
<jbr-provider host="localhost" name="httpsgateway" protocol="https"> <property name="jbr-KeyStoreURL" value="C:/jbossesb-server-4.7/httpsgateway.keystore" /> <property name="jbr-KeyStorePassword" value="123456" /> <property name="jbr-TrustStoreURL" value="C:/jbossesb-server-4.7/httpsgateway.keystore" /> <property name="jbr-TrustStorePassword" value="123456" /> <property name="jbr-ClientAuthMode" value="need" /> <property name="serviceInvokerTimeout" value="20000" /> <jbr-bus busid="httpsgatewayJBRChanel" port="9433" /> </jbr-provider>
关于jbr-provider的配置如上所示,下面对各个属性做简要说明:
jbr-KeyStoreURL:**库文件的路径,下面会说明如何创建**库文件
jbr-KeyStorePassword:**库文件的密码,在创建**库文件时指定
jbr-TrustStoreURL:受信任的**库文件路径,可与jbr-KeyStoreURL属性值一样
jbr-TrustStorePassword:受信任的**库文件的密码
jbr-ClientAuthMode:客户端验证模式
serviceInvokerTimeout:服务调用时限
httpsgatewayJBRChanel:JBR端口设置
关于各个属性的详细说明,可参考官方文档或者相关API。
3.2.3 keystore制作
**库文件的制作如下图所示,这里使用的是JDK提供的keytool工具。关于如何使用keytool制作**库文件,请自行查找,网上到处都是,这里不再说明。
将制作好的keystore文件命名为httpsgateway.keystore,并保存至C:/jbossesb-server-4.7目录下。
3.2.4 配置属性文件
在esbcontent/ META-INF目录下新建属性文件HttpRouter.properties,其内容如下:
configurators=HttpProtocol protocol-socket-factory=org.apache.commons.httpclient.contrib.ssl.EasySSLProtocolSocketFactory keystore=C:/jbossesb-server-4.7/httpsgateway.keystore keystore-passw=123456 truststore=C:/jbossesb-server-4.7/httpsgateway.keystore truststore-passw=123456 max-connections-per-host=5
3.3定义Action类
3.3.1 Client Action
该类用于打印输出客户端响应的具体内容。
package com.thu.afa.esb.jbossesb.action.client; import org.jboss.soa.esb.actions.AbstractActionLifecycle; import org.jboss.soa.esb.helpers.ConfigTree; import org.jboss.soa.esb.http.HttpHeader; import org.jboss.soa.esb.http.HttpResponse; import org.jboss.soa.esb.message.Message; import java.util.List; public class HttpResponsePrinter extends AbstractActionLifecycle { protected ConfigTree configTree; public HttpResponsePrinter(ConfigTree config) { this.configTree = config; } public Message process(Message message) throws Exception { HttpResponse httpResponse = (HttpResponse) message.getBody().get(HttpResponse.RESPONSE_KEY); System.out.println("=========== Client Response: ==================================="); System.out.println("Message Payload:"); System.out.println("\t[" + message.getBody().get() + "]"); System.out.println(); System.out.println("Http Response:"); System.out.println("\tCode: " + httpResponse.getResponseCode()); System.out.println("\tLength: " + httpResponse.getLength()); System.out.println("\tEncoding: " + httpResponse.getEncoding()); System.out.println("\tHeaders:"); List<HttpHeader> headers = httpResponse.getHttpHeaders(); for (HttpHeader header : headers) { System.out.println("\t\t" + header.getName() + ": " + header.getValue()); } System.out.println("================================================================"); return message; } }
3.3.2 Server Action
该类用于打印输出服务端请求的具体内容。
package com.thu.afa.esb.jbossesb.action.server; import org.jboss.soa.esb.actions.AbstractActionLifecycle; import org.jboss.soa.esb.helpers.ConfigTree; import org.jboss.soa.esb.message.Message; import org.jboss.soa.esb.message.Properties; public class HttpRequestPrinter extends AbstractActionLifecycle { protected ConfigTree configTree; public HttpRequestPrinter(ConfigTree config) { this.configTree = config; } public Message process(Message message) throws Exception { Properties properties = message.getProperties(); System.out.println("=========== Server Request: ===================================="); System.out.println("Message Payload:"); System.out.println("\t[" + message.getBody().get() + "]"); System.out.println(); System.out.println("\tHeaders:"); System.out.println("\t\thost: " + properties.getProperty("host")); System.out.println("\t\tMethod: " + properties.getProperty("MethodType")); System.out.println("\t\tPath: " + properties.getProperty("Path")); System.out.println("\t\tuser-agent: " + properties.getProperty("user-agent")); System.out.println("\t\tcontent-type: " + properties.getProperty("content-type")); System.out.println("================================================================"); message.getBody().add("Http Response Payload!!"); return message; } }
3.4 定义第一个Service
<service category="HttpsService" description="Https Client" invmScope="GLOBAL" name="HttpsClientService"> <listeners> <jms-listener busidref="httpsgatewayChanel" is-gateway="true" name="httpsgatewayListener" /> </listeners> <actions mep="OneWay"> <action name="httprouter" class="org.jboss.soa.esb.actions.routing.http.HttpRouter"> <property name="method" value="POST" /> <property name="responseType" value="STRING" /> <property name="endpointUrl" value="https://localhost:9433/x/y"> <http-client-property name="file" value="/META-INF/HttpRouter-localhost-https-9433.properties" /> </property> <property name="headers"> <header name="name" value="llu" /> </property> </action> <action name="printResponse" class="com.thu.afa.esb.jbossesb.action.client.HttpResponsePrinter" /> </actions> </service>
配置说明:该服务执行了两次操作,首先将接收到的消息执行了一次http转发,然后由HttpResponsePrinter打印请求的内容。
3.5 定义第二个Service
<service category="HttpsService" description="Https Server" invmScope="GLOBAL" name="HttpsServerService"> <listeners> <jbr-listener busidref="httpsgatewayJBRChanel" is-gateway="true" name="httpsgatewayJbsListener" /> </listeners> <actions> <action name="printMessage" process="process" class="com.thu.afa.esb.jbossesb.action.server.HttpRequestPrinter"/> </actions> </service>
配置说明:该服务用语打印输出接收到的消息的内容。
3.6 配置部署文件
部署依赖文件deployment.xml内容如下:
<jbossesb-deployment> <depends>jboss.esb.quickstart.destination:service=Queue,name=httpsgateway </depends> </jbossesb-deployment>
3.7 部署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.HttpsGatewayClient.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.Message; import javax.jms.ObjectMessage; import javax.jms.Queue; import javax.jms.QueueConnection; import javax.jms.QueueConnectionFactory; import javax.jms.QueueReceiver; import javax.jms.QueueSender; import javax.jms.QueueSession; import javax.jms.TextMessage; import javax.naming.Context; import javax.naming.InitialContext; /** * <p>Class Name: HttpsGatewayClient</p> * <p>Description: </p> * @author Afa * @date 2010-9-7 * @version 1.0 */ public class HttpsGatewayClient { 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/httpsgateway"); 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 void receiveMessage() throws Exception { QueueReceiver receiver = session.createReceiver(queue); Message message = receiver.receive(); if(message != null) { if(message instanceof ObjectMessage) { ObjectMessage objectMessage = (ObjectMessage) message; System.out.println(objectMessage.getObject().toString()); } else if (message instanceof TextMessage) { TextMessage textMessage = (TextMessage) message; System.out.println(textMessage.getText()); } } receiver.close(); } /** * <p>Title: </p> * <p>Method Name: main</p> * <p>Description: </p> * @author: Afa * @date: 2010-9-7 * @param args */ public static void main(String[] args) throws Exception { HttpsGatewayClient client = new HttpsGatewayClient(); client.setupConnection(); client.sendAMessage("Llu, miss you, afa"); client.stop(); } }
运行客户端,结果如下图所示:
上述便是ESB第七个应用实例。如有问题,欢迎指正。
-----------------------------------------------------
Stay Hungry, Stay Foolish!
http://yarafa.iteye.com
AfaMar 5th, 2011-----------------------------------------------------