Mule ESB浅析3——集成到tomcat

殇帝刘玢你

　　

　　

一，部署mule 到tomcat
将mule部署到tomcat中，有两种部署方式：
      1，  将Mule作为一个webApp应用，此时不需要修改tomcat的相关设置。
      2，  将Mule作为tomcat的一个组件，此时需要修改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
# 设定logger的root level为DEBUG，指定的输出目的地（appender）为file
log4j.rootLogger=INFO, file , stdout
 
# 设定stdout控制台
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=[%d{HH:mm:ss}] %5p %c{2} \"%m\"%n
 
# 设定输出位置，此处设定tomcat目录的logs下,文件名为bugmgrsys.log。
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=${catalina.home}/logs/projectLogs.log
log4j.appender.file.MaxFileSize=1024KB
 
# 设定制定的file使用的PatternLayout.
# 有关ConversionPattern中的转意字符的含义参考说明
log4j.appender.file.layout=org.apache.log4j.PatternLayout
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>
</web-app>
　　

 
注意：此处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的一些基本概念和配置。