Mule ESB Configuration Patterns 配置摘要

为了节省时间,就不翻译了,摘抄重点总结下,本文大部分摘抄自Mule ESB官网入门教程 Guide.pdf这本书中.

常用的配置定式简介

   Simple Service  : Exposes JAX-WS annotated components as SOAP web services. Exposes JAX-RS annotated beans as RESTful components.Can also handle JAXB,XML and raw content with simple POJO components.

   WebService Proxy : Proxies remote web services. Can perform transformations on the SOAP envelope. Can rewrite or redirect remote WSDLs to localones.

   Bridge : Establishes a direct conduit between an inbound endpoint and an outbound endpoint. Supports request-response and one-way bridging. Can perform transformations. Supports transactional bridging of inbound to outbound.

   Validator : Validates inbound messages against a defined acceptance filter. Returns an ACK or NACK response synchronously and dispatches valid messages asynchronously.

下面只总结 simple service 和 webservice proxy 两种常用的配置定式 的常用配置

   Simple service : 把组件发布成 简单的mule service,包括webservice

   (1) 把pojo定义成simple service

<pattern:simple-service name="maths-service"
address="vm://maths.in"
component-class="org.mule.tck.services.SimpleMathsComponent" />

<!-- 使用引用 -->
<pattern:simple-service name="maths-service"
endpoint-ref="maths-service-endpoint"
component-ref="math-component" />

<!-- 使用transformers -->
<pattern:simple-service name="byte-array-massager"

address="vm://bam.in"

transformer-refs="byte-array-to-string append-bar"

responseTransformer-refs="append-baz string-to-byte-array"

component-class="org.mule.component.simple.EchoComponent" />

<!-- 使用子元素 -->




<pattern:simple-service name="maths-service"component-class="org.mule.tck.services.SimpleMathsComponent"><vm:inbound-endpoint path="maths.in"exchange-pattern="request-response" /><custom-exception-strategy class="com.acme.AcmeExceptionStrategy" /></simple-service>
<!-- 使用Inheritance -->
<pattern:simple-service name="global-exception-strategy"
abstract="true">
<custom-exception-strategy class="com.acme.AcmeExceptionStrategy" />
</pattern:simple-service>
<pattern:simple-service name="inherited-exception-strategy"
parent="global-exception-strategy"
address="vm://maths.in"
component-class="org.mule.tck.services.SimpleMathsComponent" />

<!--发布成JAX-WS Service-->
<pattern:simple-service name="weather-forecaster-ws"
address="http://localhost:6099/weather-forecast"
component-class="org.mule.test.integration.tck.WeatherForecaster"
type="jax-ws" />

<!--发布成JAX-RS Service-->



<pattern:simple-service name="weather-report-rsc"address="http://localhost:6099/rest"component-class="org.mule.test.integration.tck.WeatherReportResource"type="jax-rs" />




  (2)JAXB 支持配置


<pattern:simple-service name="weather-jaxb-consumer"
address="vm://weather-consumer.in"
component-class="org.mule.test.integration.tck.WeatherReportConsumer" />

对应的WeatherReportConsumer类代码,注意:it is required that @Payload,a Mule-specific annotation,is used on the component:

package org.mule.test.integration.tck;
import org.mule.api.annotations.param.Payload;
public class WeatherReportConsumer
{
public String consume(@Payload WeatherReportType weatherReport)
{
return weatherReport.report;
}
}

   (3) XPath 支持配置

<pattern:simple-service name="weather-xpath-consumer"
address="vm://weather-xpath-consumer.in"
component-class="org.mule.test.integration.tck.WeatherReportXpathConsumer" />


对应的WeatherReportXpathConsumer类代码,注意: a Mule annotation,@XPath in this case,is needed for this to work


package org.mule.test.integration.tck;
import org.mule.api.annotations.expression.XPath;
public class WeatherReportXpathConsumer
{
public String consume(@XPath(value = "/weatherReport/report") String report)
{
return report;
}
}

    Web Service Proxy Pattern :  Web Service Proxy在安全和审查等情形下是一种非常通用的实践,它允许用非常简短和简单的方式去配置一个proxy.
    核心特性:

         add or remove HTTP headers,添加或移除http协议头

         transform the SOAP envelope (body or header) to add or remove specific entries,转换soap请求信息,增加或移除特殊条目

         rewrite remote WSDLs so they appear to bind to services inside a corporate firewall,重写wsdl文件,从而指向防火墙内部的service

         introduce custom error handling. 错误处理
    常用配置

<!--Web Service Proxy-->
<pattern:web-service-proxy name="weather-forecast-ws-proxy"
inboundAddress="http://localhost:8090/weather-forecast"
outboundAddress="http://ws.acme.com:6090/weather-forecast" />

<!--Proxy with Transformers-->
<pattern:web-service-proxy name="weather-forecast-ws-proxy-transformers"
inboundAddress="http://localhost:8090/weather-forecast"
transformer-refs="zip-code-transformer add-credentials-transformer"
responseTransformer-refs="weather-code-transformer"
outboundEndpoint-ref="target-ws-endpoint" />

<!--Child Elements 子元素 -->
<pattern:web-service-proxy name="weather-forecast-ws-proxy">
<http:inbound-endpoint address="http://localhost:8090/weather-forecast" />
<http:outbound-endpoint address="http://ws.acme.com:6090/weather-forecast" />
<custom-exception-strategy class="com.acme.AcmeExceptionStrategy" />
</pattern:web-service-proxy>

<!--Inheritance 继承关系 -->
<pattern:web-service-proxy name="abstract-ws-proxy-zipcode-changer"
abstract="true"
transformer-refs="zip-code-transformer add-credentials-transformer"
responseTransformer-refs="weather-code-transformer" />
<pattern:web-service-proxy name="weather-forecast-ws-proxy"
parent="abstract-ws-proxy-zipcode-changer">
<http:inbound-endpoint address="http://localhost:8090/weather-forecast" />
<http:outbound-endpoint address="http://ws.acme.com/weather-forecast" />
</pattern:web-service-proxy>

<!--Remote WSDL Redirection 以远程方式重定向wsdl文件-->
<pattern:web-service-proxy name="weather-forecast-ws-proxy"
inboundAddress="http://localhost:8090/weather-forecast"
outboundAddress="http://ws.acme.com:6090/weather-forecast"
wsdlLocation="http://ws.acme.com:6090/wsdl/weather-forecast" />

<!--File WSDL Redirection  以指定文件方式重定向wsdl文件-->
<pattern:web-service-proxy name="weather-forecast-ws-proxy"
inboundAddress="http://localhost:8090/weather-forecast"
outboundAddress="http://ws.acme.com:6090/weather-forecast"
wsdlFile="path/to/correct/weather-forecaster.wsdl" />