maven引用servlet_Maven项目+内嵌tomcat+Servlet

写在前面

上篇文章 使用 Intellij IDEA 新建一个 Servlet 项目 ，文章中如何在 Intellij IDEA 中启动 Tomcat 并加载 webapp，但是配置的过程十分繁琐。至少需要进行以下三项的设置：

Add Configuration

Project Structure -> Modules -> Web

Project Structure -> Artifacts -> Add Artifact

Project Structure -> Libraries -> Add Java Library

这个繁琐的过程，不是一个初学者，尤其是想要立马开始敲代码的开发者想要的。因此，我们需要一种简单可靠，能直接在 IDE 中启动并调试 webapp 的方法。

项目地址

git clone https://gitee.com/kendoziyu/code-servlet-parent.git

其中，maven-tomcat-servlet-example 是本文的项目示例。

Maven 配置文件

我们新建一个 maven-tomcat-servlet-example 工程，编写pom.xml如下：

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">

4.0.0

coderead.servlet

maven-tomcat-servlet-example

1.0-SNAPSHOT

war

3.1.0

9.0.39

org.apache.tomcat.embed

tomcat-embed-core

${tomcat.version}

provided

org.apache.tomcat.embed

tomcat-embed-jasper

${tomcat.version}

provided

Hello

其中， 类型为 war，引入依赖 tomcat-embed-core 和 tomcat-embed-jasper，引入的 Tomcat 版本 为 9.0.39。

tomcat-embed-core 依赖包含 javax.servlet 下的内容，因此不需要再额外引入依赖 javax.servlet-api。

指定为 provided，表示编译时使用，但不会打包到.war文件中，因为运行期 Web服务器本身已经提供了 Servlet API 相关的 jar 包。

我们目光转到 这个标签，这个标签将决定你所打包的 war 包的名称。在本文的后续的 Tomcat 部署 war 章节，会为大家展示打包操作。

使用 WebServlet 注解

import javax.servlet.ServletException;

import javax.servlet.annotation.WebServlet;

import javax.servlet.http.HttpServlet;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import java.io.IOException;

import java.io.PrintWriter;

@WebServlet(urlPatterns = "/")

public class HelloServlet extends HttpServlet {

@Override

protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

resp.setContentType("text/html");

String name = req.getParameter("name");

if (name == null) {

name = "world";

}

PrintWriter pw = resp.getWriter();

pw.write("

Hello, " + name + "!

");

pw.flush();

}

}

使用@WebServlet注解，可以简化繁琐的 xml 配置。使用注解前的 web.xml 配置如下：

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"

version="3.1">

helloServlet

coderead.servlet.HelloServlet

helloServlet

/

改为使用注解以后的 web.xml 配置如下：

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"

version="3.1">

1 行的 Java 注解，可以减少 8 行 xml 配置，何乐而不为呢？

Main 函数启动

因为Tomcat实际上也是一个Java程序，我们看看Tomcat的启动流程：

启动 JVM 并执行 Tomcat 的 main() 方法；

加载 war 并初始化 Servlet；

正常服务。

启动Tomcat无非就是设置好 classpath 并执行 Tomcat 某个 jar 包的 main() 方法，我们完全可以把 Tomcat 的 jar 包全部引入进来，然后自己编写一个 main() 方法，先启动 Tomcat，然后让它加载我们的 webapp 就行。

Main.java

import org.apache.catalina.Context;

import org.apache.catalina.LifecycleException;

import org.apache.catalina.WebResourceRoot;

import org.apache.catalina.startup.Tomcat;

import org.apache.catalina.webresources.DirResourceSet;

import org.apache.catalina.webresources.StandardRoot;

import java.io.File;

public class Main {

public static void main(String[] args) throws LifecycleException {

// 启动 tomcat

Tomcat tomcat = new Tomcat();

tomcat.setPort(Integer.getInteger("port", 8080));

tomcat.getConnector();

// 创建 WebApp

Context context = tomcat.addWebapp("", new File("src/main/webapp").getAbsolutePath());

WebResourceRoot resources = new StandardRoot(context);

resources.addPreResources(

new DirResourceSet(resources, "/WEB-INF/classes",

new File("target/classes").getAbsolutePath(), "/"));

context.setResources(resources);

tomcat.start();

tomcat.getServer().await();

}

}

小插曲：我在第一次写 Demo 的时候，遇到了一个 WebServlet 不生效的问题，我最后发现，我没有为 context 设置资源。也就是没写 context.setResources(resources); 这句话。囧

至此，我们已经搞定了一个启动方便，且可以本地调试的 Servlet 程序。接着我们就来讲讲 war 包部署到 Tomcat 容器。

运维篇：war 包部署

本文还是选择在 Windows 上演示，作为开发，有时候不会真的上手部署项目到 Tomcat 容器上，但是我们还是可以了解一下大致的流程。

打包 war 包

如果使用 Intellij Idea，打包位置如下：

这个对应的命令就是 mvn package，也可以在项目根目录下执行该命令。输出结果如下

红色框1部分Hello 文件夹 其实就是 war 包里面的内容， Hello.war 相当于是压缩包，只不过后缀是 .war。

拷贝 war 包

将 Hello.war 拷贝到 Tomcat 安装目录的 webapps 文件夹下(如果你的 Tomcat 版本不支持的话，你还是解压一下吧)。然后，我们就可以在浏览器中通过

首先把 webapps 备份一下，我把它改名为 webapps_backup

重新创建一个全新的文件夹 webapps，并创建一个子文件夹 ROOT，然后把 Hello.war 解压一下

经过上面两步骤就可以直接用 localhost:端口号 访问了~

参考博客