Tomcat5中的Embeded版本,为应用中集成完整的Web服务提供了尽可能大的空间,不仅使开发者容易获得对标准HTTP的处理,还有SSL的通讯处理,使开发者很容易就可以对原有非Web系统进行扩展以支持瘦客户端应用,通向Web大门的钥匙已经放在这里,剩下的就是看你怎样来发挥了。
Tomcat严格意义上不是一个真正的AppServer,只是支持运行Servlet和Jsp的Web容器,此外扩展了一些AppServer的功能,如数据库连接池,JNDI等,如何提炼,或者说把Tomcat整理成一个最小的集合成为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在工作时的层次情况,它按照:
上面是Tomcat实现的内部工作结构:
一个Server含有几个Connector,比如non-SSL HTTP/1.1 Connector on port 8080,SSL HTTP/1.1 Connector on port 8443和AJP 1.3 Connector on port 8009。连接器就是接受客户端情况然后封装成request和response对象交给容器处理。
通常是一个Engine,其中Engine里含有1个Host,1个Host 内可以含有多个Context,Context代表Web应用,即1个Host里可以包含多个Web应用,tomcat的webapps目录里面防止的就是一个个web应用。Engine接收Service发过来的请求(通过Connector),交给相应的Host进行处理,然后Host交给具体的Context。
下面是非常简单的创建Embeded tomcat的例子,示意其使用
把tomcat-embed目录下的lib内的所有jar包引入到项目的环境中,即完成了项目的环境搭建。在应用里开发嵌入式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实例,把它加入1)创建的tomcat实例中,它用来接收客户发出的请求。
具体和完整的代码如下:
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.Logger;
import org.apache.catalina.startup.Embedded;
public class TomcatService {
public static void main(String[] args) {
//设置Tomcat的工作目录,并启动Tomcat Server
String path = "/usr/local/tomcat-embed";
Embedded tc = createTomcat(path);
try {
tc.start();
System.out.println("---------- Tomcat Server start over. ------------");
} catch (Exception e) {
e.printStackTrace();
}
}
private static Embedded createTomcat(String path) {
//创建嵌入式Tomcat Server的实例
Embedded tomcat = new Embedded();
//设置Tomcat的工作目录
tomcat.setCatalinaHome(path);
//产生Tomcat引擎
Engine engine = tomcat.createEngine();
engine.setName("EmbededServer");
//创建Host,设置Host的工作目录
Host host = tomcat.createHost("localhost", tomcat.getCatalinaHome()
+ "/webapps");
//把Host加入Engine
engine.addChild(host);
engine.setDefaultHost(host.getName());
String path = host.getAppBase() + "/instance1";
if (!new File(path).exists()) {
System.err.println("请检查instance1应用的目录以及相关资源是否存在.");
return null;
}
//创建instance1的Context,并加入Host中
Context ctxt = tomcat.createContext("/instance1", path);
host.addChild(ctxt);
tomcat.addEngine(engine);
tomcat.setDebug(Logger.WARNING);
try {
//Tomcat加入Connector,监听本地(127.0.0.1)的访问
tomcat.addConnector(tomcat.createConnector(InetAddress
.getByName("127.0.0.1"), 8080, false));
} catch (UnknownHostException e) {
System.err.println("绑定Tomcat Server到127.0.0.1:8080失败,请检查端口是否被占用.");
e.printStackTrace();
tomcat = null;
}
return tomcat;
}
}
在这里需要注意,由于嵌入式版本Tomcat没有common/lib目录,一些需要的Jar包可以复制到JDK的/jre/lib/endorsed目录下进行使用。
在OFBiz中默认使用的embeded tomcat,具体的可以参考里面对于嵌入式启动相关的内容。