tomcat和应用集成

将tomcat作为应用的一部分集成到应用中，使得应用可以直接开启http服务，对外提供接口。此时应用程序不必再遵守j2ee中的文件目录格式要求。

此种方式改变了以往先部署tomcat容器，再按照j2ee标准目录格式部署应用的做法，简化了网络应用的部署工作，也方便了将现有模块功能网络化访问的需求。

建立maven工程

pom.xml文件，其中使用了tomcat8.5.9版本，jdk1.8。

<project
    xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.founder</groupId>
    <artifactId>embed-tomcat</artifactId>
    <version>8.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>tomcat</name>
    <url>http://maven.apache.org</url>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <tomcat.version>8.5.9</tomcat.version>
        <!-- <tomcat.version>7.0.32</tomcat.version> -->
    </properties>

    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>3.8.1</version>
            <scope>test</scope>
        </dependency>

        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-util</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-servlet-api</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-juli</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jsp-api</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jdbc</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jasper-el</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <!-- -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-jasper</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-i18n-ja</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-i18n-fr</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-i18n-es</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-el-api</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-dbcp</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-coyote</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <!-- tomcat.version must be greater than 8.*.* <dependency> <groupId>org.apache.tomcat</groupId> <artifactId>tomcat-jni</artifactId>
            <version>${tomcat.version}</version> </dependency> -->
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-api</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-annotations-api</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-catalina-ws</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-catalina-ha</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat</groupId>
            <artifactId>tomcat-catalina-ant</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-core</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <version>${tomcat.version}</version>
        </dependency>
    </dependencies>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>2.1</version>
                <configuration>
                    <source>1.8</source>
                    <target>1.8</target>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

Tomcat组成结构

建立tomcat启动类

public class TomcatStarter {
    public static void main(String[] args) throws LifecycleException {
        Tomcat tomcat = new Tomcat();
        // tomcat.setBaseDir("/temp");
        Server server = tomcat.getServer();
        // server.setPort(8080);
        Service service = tomcat.getService();
        service.setName("Tomcat-embbeded");
        Connector connector = tomcat.getConnector();
        // connector.setPort(8888);
        Context context = tomcat.addContext("", "/");
        tomcat.addServlet("", "test", new MyServlet());
        context.addServletMappingDecoded("/*", "test");
        server.start();
        server.await();
    }
}

实例初始化

tomcat

因为Tomcat启动时，需要指定它的工作目录（此原因还未深究），所以在建立Tomcat实例后，使用

tomcat.setBaseDir("/temp");

设置此目录。如果为设置过此目录，则默认会是“tomcat.8080”。8080是tomcat实例中设置的port值，默认为8080。

此外此目录中，要确保有“webapps”目录（此原因还未深究）。

server

通过

tomcat.getServer();

可获得一个Server实例，并可以设置此server的port值，在此端口上监听server关闭请求。

service

通过

tomcat.getService();

可获得service实例，其真实类型为StandardService。

此service实际为上述创建的server中的service；

connector

通过

tomcat.getConnector();

可获得一个connector实例，默认protocol为“HTTP/1.1”。

此connector实际上为上述创建的service中的connector。

connector.setPort(8888);

用于设置监听的端口，即http请求时访问的端口。

context

tomcat.addContext("", "/");

创建context时，会将默认的engine、host一同创建，因此在TomcatStarter中可以忽略其创建。

addContext中的两个参数分别是contextPath和docBase。

contextPath：即网络请求是的路径；

docBase：即在tomcatBaseDir/webapps目录下的目录，可以不包含任何文件，但必须存在（此原因还未深究）。

这里同server.xml中的配置相似。

servlet

tomcat.addServlet("", "test", new MyServlet());

用于向指定的context添加servlet。

context.addServletMappingDecoded("/*", "test");

用于完成servlet在context中的映射配置。

这里同web.xml中的配置相似。

注意：context的显示创建是不可以忽略的。

• context用于映射网络请求到具体的程序；

注意：service、connector、engine、host的显式创建可以忽略。

• engine、host会在context创建时创建；
• server会在engine创建时创建；
• service会在server创建时创建；
• 如果没有显式创建connector，需要使用tomcat实例去设置port值，使用tomcat实例启动服务时，会创建connector；

简化后的TomcatStarter可以为

public class TomcatStarter {
    public static void main(String[] args) throws LifecycleException {
        Tomcat tomcat = new Tomcat();
        tomcat.setPort(8080);
        Context context = tomcat.addContext("", "/");
        tomcat.addServlet("", "test", new MyServlet());
        context.addServletMappingDecoded("/*", "test");
        tomcat.start();
        tomcat.getServer().await();
    }
}

启动

server.start(); // 或者tomcat.start();
server.await(); //或者tomcat.getServer().await();