零、前提
在按照本文進行操作之前，假設(shè)您的系統(tǒng)已經(jīng)具備以下前提：
已經(jīng)安裝了Sun公司的JDK1.4或JDK5.0版本，推薦使用JDK5.0。
正確設(shè)置了JAVA_HOME環(huán)境變量到JDK目錄（注意不是JRE目錄）。
確保%JAVA_HOME%\bin路徑在系統(tǒng)尋找路徑中。
安裝有Eclipse3.2或以上版本的開發(fā)環(huán)境。
安裝有Apache Tomcat 5.0或以上版本，推薦使用5.5。文檔假設(shè)Tomcat的安裝目錄為%TOMCAT_HOME%。
一、下載與安裝
到Mule的官方網(wǎng)站（
http://mule.mulesource.org/display/MULE/Download）上下載Mule的最新穩(wěn)定版，目前是1.3.3（http://www.mulesource.com/ccount/click.php?id=17），也可以使用社區(qū)版的1.4.1（http://www.mulesource.com/ccount/click.php?id=33）。本文檔以1.3.3版為例，1.4.1請參照文檔自行修改。
下載后得到一個ZIP格式的壓縮文件mule-1.3.3.zip，將該文件解壓至任一目錄，假設(shè)為C:\mule-1.3.3，本文檔以環(huán)境變量MULE_HOME表示該目錄。
二、運行Echo示例
Mule自帶了很多示例，從最簡單的echo示例到一個比較完整的貸款中介服務(wù)loanbroker。每個示例程序都分為ant和maven兩個版本，它們分別位于 %MULE_HOME%\examples\ant和 %MULE_HOME%\examples\maven目錄下。文檔將以ant版本為例說明如何運行echo示例。
1、到apache官方網(wǎng)站的ant項目下載頁（
http://ant.apache.org/bindownload.cgi）上下載ant1.7.0（http://apache.mirror.phpchina.com/ant/binaries/apache-ant-1.7.0-bin.zip），下載后將文件解壓到任一目錄（假設(shè)為C:\apache-ant-1.7.0，文檔中表示為ANT_HOME環(huán)境變量）。
2、設(shè)置環(huán)境變量ANT_HOME到ant的解壓目錄，如：
ANT_HOME=
3、將%ANT_HOME%\bin加入到系統(tǒng)尋找路徑中，如：
PATH=%ANT_HOME%\bin;%PATH%
4、啟動命令行窗口，進入%MULE_HOME%\examples\ant\echo目錄，執(zhí)行下面命令：
echo.bat
示例程序會先顯示一個License信息，輸出一些日志記錄，最終出現(xiàn)以下信息：
INFO 2007-08-29 16:54:44,062 [WrapperSimpleAppMain] org.mule.MuleManager:
**********************************************************************
* Mule ESB and Integration Platform version Not Set *
* Not Set *
* For more information go to http://mule.mulesource.org *
* *
* Server started: 2007年8月29日 星期三 下午04時54分42秒 CST *
* Server ID: Mule_Echo_Sample *
* JDK: 1.5.0_11 (mixed mode, sharing) *
* OS: Windows XP - Service Pack 2 (5.1, x86) *
* Host: zengfl (192.168.25.71) *
* *
* Agents Running: *
* Mule Admin: accepting connections on tcp://localhost:60504 *
**********************************************************************
INFO 2007-08-29 16:54:44,062 [WrapperSimpleAppMain] org.mule.MuleServer: Mule S
erver initialized.
Please enter something:
表示示例程序運行成功，隨便輸入一些字符，這些字符被回顯出來的同時，回顯的處理日志信息也被顯示出來。
注意，在執(zhí)行這個步驟時，請確信您能訪問互聯(lián)網(wǎng)，否則，示例程序無法運行。
三、一個簡單的Mule Java Application
下面，以一個類似Echo的Java Application為例說明如何使用Mule來建立應(yīng)用。后面會說明如何在Web應(yīng)用程序中集成Mule。
1、在Eclipse中建立一個Java Application，為Application命令為MuleAppTest。
2、在Package Explorer視圖中，選中剛剛建立的MuleAppTest項目，按下Alt+Enter鍵打開該項目的屬性設(shè)置對話框，找到Java Build Path菜單，打開右邊的Libraries標(biāo)簽頁。
3、點擊“Add External JARs...”按鈕，將 %MULE_HOME%\lib\mule 目錄和 %MULE_HOME%\lib\opt 目錄下的所有jar文件添加到項目的庫路徑中（%MULE_HOME%\bin\opt目錄下的jar文件并不是必須的，您可以根據(jù)需要選擇您要加入的包，本文實際上只使用了與Web Service相關(guān)的一些庫文件）。
4、在源碼目錄（src）下建立一個EchoService接口及其實現(xiàn)類EchoServiceImpl。
EchoService.java
package com.san.mule;
public interface EchoService {
public String echo(String s);
}
EchoServiceImpl.java
package com.san.mule;
public class EchoServiceImpl implements EchoService {
public String echo(String s) {
return s;
}
}
5、在源碼目錄（src）下建立一個mule-config.xml文件，為Mule配置入口端點，并將這個端點發(fā)布成一個基于axis的Web服務(wù)。
mule-config.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mule-configuration PUBLIC "-//MuleSource //DTD mule-configuration XML V1.0//EN"
"http://mule.mulesource.org/dtds/mule-configuration.dtd">
<mule-configuration id="mule-test" version="1.0">
<model name="echoService">
<mule-descriptor name="echoService"
implementation="com.san.mule.EchoServiceImpl">
<inbound-router>
<endpoint
address="axis:http://localhost:8181/services">
</endpoint>
</inbound-router>
<properties>
<list name="serviceInterfaces">
<entry value="com.san.mule.EchoService" />
</list>
</properties>
</mule-descriptor>
</model>
</mule-configuration>
6、建立一個Mule的Application示例。
MuleAppTest.java
package com.san.mule;
import org.mule.config.ConfigurationException;
import org.mule.config.builders.MuleXmlConfigurationBuilder;
import org.mule.umo.manager.UMOManager;
public class MuleAppTest {
public static void main(String[] args) throws ConfigurationException {
MuleXmlConfigurationBuilder builder = new MuleXmlConfigurationBuilder();
UMOManager manager = builder.configure("mule-config.xml");
}
}
7、在MuleAppTest.java點擊右鍵，選擇Run As菜單中的Java Application運行MuleAppTest類。
8、打開瀏覽器，訪問http://localhost:8181/services/echoService?wsdl，即可看見服務(wù)的描述信息。
9、我們來運行一下這個Web服務(wù)，看是否能正確運行，在瀏覽器地址欄中輸入：
http://localhost:8181/services/echoService?method=echo¶m=zengfl四、在Web Application中集成Mule
繼續(xù)前面的項目，我們將Mule集成到Tomcat的一個Web Application中，并使用一個JSP頁面來訪問Mule組件。
1、在項目中建立Web Application的相關(guān)目錄WEB-INF、WEB-INF\lib和WEB-INF\classes。
2、將%MULE_HOME%\lib\mule目錄和%MULE_HOME%\lib\opt目錄下的所有文件復(fù)制到項目的WEB-INF\lib目錄下。
將%MULE_HOME%\lib\user\activation.jar和%MULE_HOME%\lib\user\mail.jar兩個文件復(fù)制到項目的WEB-INF\lib目錄下。（注意，如果你沒有找到這兩個文件，那是因為你沒有成功運行第二節(jié)中的測試程序。）
3、將項目的output folder設(shè)置成項目的WEB-INF/classes目錄。
4、將項目src目錄下的mule-config.xml文件復(fù)制到項目的WEB-INF目錄下。
注意，當(dāng)你把項目的output folder設(shè)置成WEB-INF/classes時，該目錄會從Package Explorer中消失，這是正?，F(xiàn)在，你可以在Navigator視圖中找到這個目錄。
5、建立WEB-INF\web.xml文件。
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app>
<display-name>Mule</display-name>
<description>Mule Demo</description>
<context-param>
<param-name>org.mule.config</param-name>
<param-value>/WEB-INF/mule-config.xml,</param-value>
</context-param>
<listener>
<listener-class>
org.mule.config.builders.MuleXmlBuilderContextListener
</listener-class>
</listener>
<servlet>
<servlet-name>muleServlet</servlet-name>
<servlet-class>
org.mule.providers.http.servlet.MuleReceiverServlet
</servlet-class>
<load-on-startup />
</servlet>
<servlet-mapping>
<servlet-name>muleServlet</servlet-name>
<url-pattern>/services/*</url-pattern>
</servlet-mapping>
</web-app>
6、建立一個測試頁面echo.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"%>
<%@ page import="org.mule.extras.client.MuleClient" %>
<%@ page import="org.mule.umo.UMOMessage" %>
<html>
<head>
<title>Mule Web Application Test</title>
</head>
<body>
<%
String s = request.getParameter("name");
if (s != null) {
MuleClient client = new MuleClient();
UMOMessage message = client.send(
"axis:http://localhost:8181/services/echoService?method=echo",
s, null);
%>
<h3><%=message.getPayload()%></h3>
<%
}
%>
你的名字:
<form method="POST" name="submitEcho" action="">
<table>
<tr>
<td><input type="text" name="name" /></td>
<td><input type="submit" name="Go" value=" 確定 " /></td>
</tr>
</table>
</form>
<p/>
</body>
</html>
7、將項目部署到%TOMCAT_HOME%\webapp目錄下，啟動Tomcat，訪問
http://localhost:8080/MuleAppTest/echo.jsp輸入你的名字測試一下，OK。
