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的一些基本概念和配置。

 

评论

1 楼 wrrwhn 2014-12-04  

您好，请问一下。
若我一开始用的是9091端口发布invoke接口服务，调用方式即为localhost:9091/invoke。
那当我部署在Tomcat后，我应该怎么调用呢，默认的端口仍是8080来着。