将Mule ESB Http项目转换为Tomcat项目(4) 将ESB项目改造为Web项目

     系列2中建立的ESB项目没法在Studio中直接转换为能够部署到Tomcat的Web项目，由于Mule Anypoint Studio提供的Project Facet不包含Dynamic Web Module，只有Static Web Module,须要咱们进行手动修改。

     Mule ESB官方提供的Tomcat项目转换文档存在不少谬误，不建议参考，我进行转换时主要参考的是这篇博文。

     https://www.ricston.com/blog/tomcat-mule-3-7/

 1. 将Mule ESB的运行时的全部库包拷贝到一个本地库目录，这些库包原来所在的位置在Anypoint的安装目录的plugins\org.mule.tooling.server.3.8.0.ee_6.0.0.201601271348\mule\lib目录下(如图所示),咱们把它们拷贝到一个指定目录,例如D:\muleLib下

  2. 改变项目的packaging类型为war,这样会使得在进行编译时，使用的是mave compile plugin，而不是mule提供的mule-app-maven-plugin。

    <groupId>com.mycompany</groupId>
    <artifactId>testproject</artifactId>
    <version>1.0.0-SNAPSHOT</version>
    <packaging>war</packaging>

 3. 改动项目中引用的mule esb jar包的scope，从provided改成system,这样避免从Mule Enterprise Repository下载mule esb jar包，使其直接指向本地目录，例如对于

mule-core-ee-3.8.0-M1.jar的引用，改动以前的dependency是这样的:

<dependency>
            <groupId>com.mulesoft.muleesb</groupId>
            <artifactId>mule-core-ee</artifactId>
            <version>${mule.version}</version>
            <scope>provided</scope>
 </dependency>

改动以后变成了

<dependency>
    <groupId>com.mulesoft.muleesb</groupId>
    <artifactId>mule-core-ee</artifactId>
    <version>${mule.version}</version>
    <scope>system</scope>
   <systemPath>D:\MuleLib\mule\mule-core-${mule.version}.jar</systemPath>
 </dependency>

这样在编译时仅仅是引用本地mule lib目录下的jar包，而没必要从mule ee repository上下载对应jar包，其余的mule esb jar包作一样修改。

4.添加maven-war-plugin,去除原来pom.xml文件build节点里的plugin.

<build>
        <finalName>testproject</finalName>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-war-plugin</artifactId>
				<version>2.3</version>
				<configuration>
					<webResources>
						<!-- 打包时将src/main/app目录下的testproject.xml流程文件包含到war包的WEB-INF目录下!-->
						<resource>
							<targetPath>WEB-INF</targetPath>
							<directory>src/main/app</directory>
							<includes>
								<include>*.xml
								</include>
							</includes>
						</resource>
					</webResources>
					<failOnMissingWebXml>false</failOnMissingWebXml>
				</configuration>
			</plugin>					 
		</plugins>
	</build>

  5.运行mvn eclipse:clean, mvn eclipse:eclipse命令，将ESB项目转化为可导入Eclipse的eclipse项目。

6.导入5生成的eclipse项目，右键菜单选中[Configure]-[Convert To Maven Project]，将其专程maven项目，这是为了之后添加第三方库包。

7.设置项目的Project Facet为Dynamic Web Module 3.0, Java 1.8.新建src/main/webapp目录，在这个目录下新建web.xml文件，设置web.xml的内容以下:

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/javaee"
	      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	      xsi:schemaLocation="http://java.sun.com/xml/ns/javaee 
	      http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
	      version="3.0">
	      
	<context-param>
		<param-name>org.mule.config</param-name>
		<!-- 设置web application访问的mule流程文件的位置 -->
		<param-value>WEB-INF/testproject.xml</param-value>
	</context-param>
	
	<!-- 设置Context Listener -->
	<listener>
		<listener-class>org.mule.config.builders.MuleXmlBuilderContextListener</listener-class>
	</listener>
	
	<!-- 设置接收http请求的Mule Servlet -->
	<servlet>
		<servlet-name>muleServlet</servlet-name>
		<servlet-class>org.mule.transport.servlet.MuleReceiverServlet</servlet-class>
	</servlet>
	
	<servlet-mapping>
		<servlet-name>muleServlet</servlet-name>
		<url-pattern>/*</url-pattern>
	</servlet-mapping>	
</web-app>

修改src/main/app目录下的testproject.xml，将原流程中的http:listener改成servlet inbound enpoint,注释http:listener-config节点，须要在头部添加servlet前缀的namespace定义。

<?xml version="1.0" encoding="UTF-8"?>

<mule xmlns:servlet="http://www.mulesoft.org/schema/mule/servlet"
    xmlns:dw="http://www.mulesoft.org/schema/mule/ee/dw" 
	xmlns:metadata="http://www.mulesoft.org/schema/mule/metadata" 
	xmlns:http="http://www.mulesoft.org/schema/mule/http" 
	xmlns="http://www.mulesoft.org/schema/mule/core" 
	xmlns:doc="http://www.mulesoft.org/schema/mule/documentation"
	xmlns:spring="http://www.springframework.org/schema/beans" 
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-current.xsd
http://www.mulesoft.org/schema/mule/core http://www.mulesoft.org/schema/mule/core/current/mule.xsd
http://www.mulesoft.org/schema/mule/http http://www.mulesoft.org/schema/mule/http/current/mule-http.xsd
http://www.mulesoft.org/schema/mule/ee/dw http://www.mulesoft.org/schema/mule/ee/dw/current/dw.xsd 
http://www.mulesoft.org/schema/mule/servlet http://www.mulesoft.org/schema/mule/servlet/current/mule-servlet.xsd">
   <!--  <http:listener-config name="HTTP_Listener_Configuration" host="0.0.0.0" port="8081" doc:name="HTTP Listener Configuration"/> -->
    <flow name="testprojectFlow">
        <!-- <http:listener config-ref="HTTP_Listener_Configuration" path="Test" allowedMethods="POST" doc:name="HTTP"/> -->
        <servlet:inbound-endpoint path="Test" responseTimeout="10000" doc:name="Servlet"/>
        <dw:transform-message metadata:id="838915ab-810b-4c29-af43-ae0057731e2a" doc:name="Transform Message">
            <dw:set-payload><![CDATA[%dw 1.0
%output application/xml
---
{
	Student: {
		name: payload.name,
		id: payload.id as :number
	}
}]]></dw:set-payload>
        </dw:transform-message>
    </flow>
</mule>

8.这两个文件改完之后，执行mvn clean package,便可在项目target目录下生成testproject.war文件。