Mule ESB浅析3——集成到tomcat
一，部署mule 到tomcat
将mule部署到tomcat中，有两种部署方式：
第二种方式部署时，
1）需要在conf/server.xml中增加<Listener className="org.mule.module.tomcat.MuleTomcatListener" />。
2）拷贝所有的mule\lib下除/boot外的所有文件夹到mule-libs下（在tomcat根目录下创建）。
3）拷贝mule-libs/mule/下的mule-module-tomcat-<version>.jar到tomcat根目录的lib目录下。
4）拷贝lib/boot/目录下的jcl104-over-slf4j-**.jar, log4j-1.2.*.jar, slf4j-api-**.jar, slf4j-log4j12-**.jar到mule-libs/opt目录下。
注意这里可能某些包不存在，需要使用maven下载。
同时可能出现错误信息，
java.lang.NoClassDefFoundError: org/tanukisoftware/wrapper/security/WrapperPermission
at org.mule.module.management.agent.JmxAgent.registerWrapperService(JmxAgent.java:339)
at org.mule.module.management.agent.JmxAgent$MuleContextStartedListener.onNotification(JmxAgent.java:676)
此时还需要拷贝mule/lib/boot下的wrapper.jar包。
本人采用的是第一种部署方式，部署比较方便，同时仍然按照第二种部署方式，将所有的mule相关jar包放入${TOMCAT_HOME}\mule-libs目录下，并在conf\catalina.properties文件中common.loader=下增加：
${catalina.home}/mule-libs,${catalina.home}/mule-libs/usr/*.jar,${catalina.home}/mule-libs/mule/*.jar,${catalina.home}/mule-libs/opt/*.jar
从而避免了对mule应用发布时，繁重的mule包池拷贝。
二、log4j的配置
1，下载jar包：
http://www.apache.org/dist/tomcat/tomcat-6/v6.0.36/bin/extras/tomcat-juli-adapters.jar?
http://www.apache.org/dist/tomcat/tomcat-6/v6.0.36/bin/extras/tomcat-juli.jar
注意这里v6.0.36版本是当前最新版本，后续需要更新，否则路径不正确。
这里下载的文件是.zip后缀的，需要修改为.jar后缀。
?
http://www.apache.org/dist/logging/log4j/1.2.15/apache-log4j-1.2.15.zip
这里mule本身已经附带了log4j.jar，直接拷贝过来即可。
注意：针对log4的版本需要统一，否则在实际加载时，可能无法正常启动。
?
2，编写log4j.properties
log4j.appender.file.layout.ConversionPattern=%d{HH:mm:ss} %-5p [%C] (%F:%L) - %m%n
?
3，部署文件
将tomcat-juli-adapters.jar,log4j-1.2.16.jar,log4j.properties复制到%TOMCAT_HOME%\lib下面.
将tomcat-juli.jar复制到%TOMCAT_HOME%\bin\下面.
至此，启动tomcat后，也可以在控制台看到mule的日志信息。
?
实际运行过程中输出的日志由对应app下的log4j.properties配置文件设置。因此，需要将上述的配置文件拷贝到mule应用的WEB_INF中，web.xml中增加相应的loglistener的配置即可。
在linux下，所有的日志自动都会输出到catalina.out文件中，包括输出到控制台的日志。
建议都输出到文件，而不是控制台，有一定性能提升。
三，应用部署
1，首先需要对工程转换为Dynamic Web Module，具体操作为：工程右击选择properties?à?Project Facets进行工程转换，勾选Dynamic Web Module，其他保持不变即可。
2，在web.xml文件中补充的相应内容为：
<web-app>
<display-name>MuleHelloTest</display-name>
<description>Mule Hello Test</description>
<context-param>
<param-name>org.mule.config</param-name>
<param-value>WEB-INF/mule-config.xml</param-value>
</context-param>
<!--
To use a Mule XML configuration file use this context listener
-->
<listener>
?<listener-class>org.mule.config.builders.MuleXmlBuilderContextListener</listener-class>
</listener>
?
注意：此处listener应当配置为MuleXmlBuilderContextListener，而不是手册中描述的DeployableMuleXmlContextListener。否则会报重复启动错误：
org.mule.api.config.ConfigurationException: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)2012-9-26 13:51:32 org.apache.catalina.core.ApplicationContext log
严重: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)
org.mule.api.config.ConfigurationException: Already in lifecycle phase 'start', cannot fire the same phase twice (java.lang.IllegalStateException)
?????? at org.mule.config.builders.AbstractConfigurationBuilder.configure(AbstractConfigurationBuilder.java:52)
…
?
3，将通过eclipse创建的mule project打成war包。工程右击选择Export?àWAR file。导出路径为tomcat的WebApp目录。也可以自己实现ant脚本进行打包发布。
如果环境正常启动了，那么下面就可以正式开发基于mule的服务了！下一篇将介绍mule的一些基本概念和配置。
?