apache synapse使用（1）

一．Synapse介绍

Synapse 是一个简单的 XML 和 Web 服务管理与集成代理，可用于构成 SOA 和企业服务总线（ESB）的基础。Synapse是 Web 服务项目中一项成熟的 Apache 活动，并且是非常成功的 Apache Axis2 项目的一个分支。它提供了中介、管理、以及在各种不同的应用程序之间转换 XML 消息的能力

看看官方给出的架构图

二．官方示例

1，环境准备

• A Java 2 SE - JDK or JRE of version 1.5.x or higher (JDK 1.6.0_21 recommended)
• Apache Ant http://ant.apache.org

2，日志记录示例

在这个示例中，只是将执行过的调用执行日志记录功能

首先下载synapse: http://synapse.apache.org/download.html

解压，下文中提到的<synapse-home>就是解压后的根目录，进入到<synapse-home>/samples/axis2Server/src/SimpleStockQuoteService

运行ant

执行成功之后，到<synapse-home>/samples/axis2Server目录启动服务

axis2Server.bat

启动

启动Synapse

到目录<synapse-home>/repository/conf/sample目录下，看一下文件synapse_sample_0.xml

?

<!-- Introduction to Synapse --> <definitions xmlns= "http://ws.apache.org/ns/synapse"               xmlns:xsi= "http://www.w3.org/2001/XMLSchema-instance"               xsi:schemaLocation= "http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd" >         <sequence name= "main" >          <!-- log all attributes of messages passing through -->          <log level= "full" />             <!-- Send the message to implicit destination -->          <send/>      </sequence>    </definitions>

 定义记录所有通过的日志消息

然后到<synapse-home>/bin目录下，启动Synapse

执行 synapse.bat -sample 0

如上图所示表示启动成功

运行客户端

进行<synapse-home>/samples/axis2Client目录

运行 ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280 -Dmode=quote -Dsymbol=IBM

查看发布的结果

http://localhost:9000/services/SimpleStockQuoteService

运行其它的示例程序如上。

使用代理服务发布

?

<!-- Introduction to proxy services --> < definitions xmlns = "http://ws.apache.org/ns/synapse"               xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"               xsi:schemaLocation = "http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd" >         < proxy name = "StockQuoteProxy" >          < target >              < endpoint >                  < address uri = "http://localhost:9000/services/SimpleStockQuoteService" />              </ endpoint >              < outSequence >                  < send />              </ outSequence >          </ target >          < publishWSDL uri = "file:repository/conf/sample/resources/proxy/sample_proxy_1.wsdl" />      </ proxy >    </ definitions >

 启动synapse服务

synapse.bat -sample 150

运行客户端

ant stockquote -Dtrpurl=http://localhost:8280/services/StockQuoteProxy -Dmode=quote -Dsymbol=IBM

控制台显示如下信息：

Standard :: Stock price = $165.32687331383468

3，改变日志级别

假如你在调试模式下运行，那么可以修改对应的配置文件的日志级别

可以在<synapse-home>/lib目录下log4j.properties，修改

"log4j.category.org.apache.synapse=INFO" as "log4j.category.org.apache.synapse=DEBUG"

就可以看到调试的信息

 

三．消息中介示例

1，简单介绍

在这个示例中

?

<!-- Introduction to Synapse --> < definitions xmlns = "http://ws.apache.org/ns/synapse"               xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"               xsi:schemaLocation = "http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd" >         < sequence name = "main" >          <!-- log all attributes of messages passing through -->          < log level = "full" />             <!-- Send the message to implicit destination -->          < send />      </ sequence >    </ definitions >

 使用示例有两种模式在客户端调用

1）智能客户端模式：ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/

2）使用synapse作为http代理

执行成功行服务端能看到

Thu Nov 03 16:47:22 CST 2011 samples.services.SimpleStockQuoteService :: Generat
ing quote for : IBM

客户端能看到

 Standard :: Stock price = $80.1611906447455

2，执行代理客户端

?

<!-- Simple content based routing (CBR) of messages --> < definitions xmlns = "http://ws.apache.org/ns/synapse"               xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"               xsi:schemaLocation = "http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd" >         < sequence name = "main" >          <!-- filtering of messages with XPath and regex matches -->          < filter source = "get-property('To')" regex = ".*/StockQuote.*" >              < then >                  < send >                      < endpoint >                          < address uri = "http://localhost:9000/services/SimpleStockQuoteService" />                      </ endpoint >                  </ send >                  < drop />              </ then >          </ filter >          < send />      </ sequence >    </ definitions >

 执行结果同上

可以在9000端口上看到执行的结果

打开 http://localhost:9000/services/SimpleStockQuoteService?wsdl 可以看到接口的定义

3，使用CBR选择属性

配置文件如下：

?

<!-- CBR with the Switch-case mediator, using message properties --> < definitions xmlns = "http://ws.apache.org/ns/synapse"               xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"               xsi:schemaLocation = "http://ws.apache.org/ns/synapse http://synapse.apache.org/ns/2010/04/configuration/synapse_config.xsd" >         < sequence name = "main" >          < switch source = "//m0:getQuote/m0:request/m0:symbol" xmlns:m0 = "http://services.samples" >              < case regex = "IBM" >                  <!-- the property mediator sets a local property on the *current* message -->                  < property name = "symbol" value = "Great stock - IBM" />              </ case >              < case regex = "MSFT" >                  < property name = "symbol" value = "Are you sure? - MSFT" />              </ case >              < default >                  <!-- it is possible to assign the result of an XPath expression as well -->                  < property name = "symbol" expression = "fn:concat('Normal Stock - ', //m0:getQuote/m0:request/m0:symbol)" />              </ default >          </ switch >          < log level = "custom" >              <!-- the get-property() XPath extension function allows the lookup of local message properties                          as well as properties from the Axis2 or Transport contexts (i.e. transport headers) -->              < property name = "symbol" expression = "get-property('symbol')" />              <!-- the get-property() function supports the implicit message headers To/From/Action/FaultTo/ReplyTo -->              < property name = "epr" expression = "get-property('To')" />          </ log >          <!-- Send the messages where they are destined to (i.e. the 'To' EPR of the message) -->          < send />      </ sequence >    </ definitions >

 服务端执行synapse.bat -sample 2

客户端执行

ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dsymbol=IBM
或者执行

ant stockquote -Daddurl=http://localhost:9000/services/SimpleStockQuoteService -Dtrpurl=http://localhost:8280/ -Dsymbol=MSFT

后面的例子在下面的文章中依次列出

四．属性说明

1，definitions

Synapse配置的根元素，有默认的命名空间

?

http://ws.apache.org/ns/synapse

2，sequence

这个是所有消息中介的入口点，有一个非常重要的属性

?

name="main"

这个是所有程序的入口点，相当于java中的main函数

3，log

指定日志配置用的级别

4，in

标明执行请求要执行哪些中介