启动嵌入式Tomcat

从Tomcat5.0开始提供和支持Embeded版本，即最简化Tomcat Server，下面就针对Tomcat Server的Embeded版本进行介绍，怎样把Tomcat集成到Java应用中。

首先可以在http://apache.mirrors.versehost.com/jakarta/tomcat-5/v5.0.28/bin/jakarta-tomcat-5.0.28-embed.tar.gz 下载Tomcat的Embeded版本，下载解压后把最里层的jakarta-tomcat-5.0.28-embed目录copy到容易查找的目录，为简易需要更名为tomcat-embed，作为嵌入Tomcat的工作目录。

首先我们需要了解Tomcat在工作时的层次情况，它按照：
<Server>
  <Service>
    <Connector />
    <Engine>
      <Host>
        <Context 1/>
        <Context 2/>
        <Context n…/>
      </Host>
    </Engine>
  </Service>
</Server>

 

这样的结构表明Tomcat Embeded工作时实例结构情况，一个Server含有1个Connector和1个Engine，其中Engine里含有1个Host，1个Host 内可以含有多个Context，Context代表Web应用，即1个Host里可以包含多个Web应用。

 

接下来在创建开发应用的项目后，我们需要把tomcat-embed目录下的lib内的所有jar包引入到项目的环境中，也就是说把这些Jar文件放到BuildPath中间去，这样就完成了项目开发环境的搭建。

 

在具体应用时启动嵌入式Tomcat，需要根据以下步骤（主要是参照上面的结构图）：
1）创建org.apache.catalina.startup.Embedded实例，其代表嵌入式Tomcat Server的实例；
2）创建org.apache.catalina.Engine 实例，代表上面XML结构示例中的Engine，作为容器用来包含Host节点；
3）创建org.apache.catalina.Host实例，代表虚拟主机服务，把它加入到2）中产生的Engine中去；
4）创建一个或多个org.apache.catalina.Context实例，代表具体Web应用，每个Web应用都需要加入到3）产生的Host中；
5）最后创建org.apache.catalina.Connector实例，把它加入2）创建的Engine中，它用来接收客户发出的请求。

import java.io.File;
import java.net.InetAddress;
import java.net.UnknownHostException;

import org.apache.catalina.Context;
import org.apache.catalina.Engine;
import org.apache.catalina.Host;
import org.apache.catalina.startup.Embedded;

public class TomcatService {
	private static Embedded tomcat;

	public static void main(String[] args) {
		// set the path for tomcat embed
		String path = "F:/myDaRepository/apache-tomcat-embed";
		Embedded tc = createTomcat(path);
		try {
			tc.start();
			System.out.println("Tomcat Server start over");
//			tc.stop();
		} catch (Exception e) {
			e.printStackTrace();
		}
	}

	private static Embedded createTomcat(String path) {
		// create Tomcat Server Instance
		tomcat = new Embedded();
		// set the tomcat home
		tomcat.setCatalinaHome(path);
		// create the Tomcat engine
		Engine engine = tomcat.createEngine();
		engine.setName("MyTestServer");
		// create the host
		Host host = tomcat.createHost("localhost", tomcat.getCatalinaHome()
				+ "/webapps");
		// put the host into engine
		engine.addChild(host);
		engine.setDefaultHost(host.getName());

		String javayouPath = host.getAppBase() + "/CloudscapeDemo";
		if (!new File(javayouPath).exists()) {
			System.err.println("Please test if the javayou exists");
			return null;
		}
		System.out.println("javayouPath"+javayouPath);
		// create the context, and add it to the host
		Context ctxtJavayou = tomcat
				.createContext("/CloudscapeDemo", javayouPath);
		host.addChild(ctxtJavayou);

		tomcat.addEngine(engine);
		try {
			// put the Connector to Tomcat,listen the local visit from 127.0.0.1
			tomcat.addConnector(tomcat.createConnector(InetAddress
					.getByName("127.0.0.1"), 8080, false));
		} catch (UnknownHostException e) {
			System.err
					.println("can not bind tomcat Server to the localhost 127.0.0.1:8080;test the host is free");
			e.printStackTrace();
			tomcat = null;
		}
		return tomcat;
	}

	public void shutdown() throws Exception {
		tomcat.stop();
	}
}

打开IE，输入http://localhost:8080/CloudscapeDemo/HelloCloudscape.jsp，就可以看到运行结果了，Jsp和Servlet在预编译的时候稍显有些慢，之后感觉就和Tomcat实际运行的差不多了。
如果需要设置Host中的默认Web应用，如把javayou设置成默认的Web应用，则参考下面例子：
//创建CloudscapeDemo的Context，虚拟路径为""，而物理路径设置为 ../CloudscapeDemo
Context ctxtJavayou = tomcat.createContext("",host.getAppBase() +"/CloudscapeDemo");
ctxtJavayou.setPrivileged(true);
host.addChild(ctxtRoot);
用来替换上面例子中ctxJavayou的创建，编译后重新启动服务，则通过http://localhost:8080/HelloCloudscape.jsp 也可以访问了。

在这里需要注意，由于嵌入式版本Tomcat没有common/lib目录，一些需要的Jar包可以复制到JDK的/jre/lib/endorsed目录下进行使用。

对于Tomcat5 Embeded版本的使用介绍就到这里。在我们的印象中AppServer是复杂而消耗资源的，能把一个Tomcat整合到你的应用中，是个有趣的想法， 除此之外，它也可以让你方便的整合和调试具有后台应用的Web服务，也可以让你整改早前的胖客户应用程序，使它支持Web功能，还可以用来开发支持Web 功能的自己的服务器，当然还可以扩展更多，但需要我们的有想法。