开发一个带有Servlet的Web应用：从零到一

本文链接：https://blog.csdn.net/xycxycooo/article/details/140939176

开发一个带有Servlet的Web应用：从零到一

在当今的互联网时代，Web应用已经成为企业级应用和互联网服务的主流。Servlet作为Java Web应用的核心技术之一，负责处理客户端请求并生成动态内容。本文将详细介绍如何开发一个带有Servlet的Web应用，从目录结构的搭建到Servlet的编写和配置，全面解析开发过程中的每一个步骤。

1. Web应用的基本目录结构

1.1 创建Web应用根目录

首先，在Tomcat服务器的webapps目录下新建一个目录，例如命名为crm。这个目录就是你的Web应用的根目录。

webapps
    |------crm

1.2 创建WEB-INF目录

在crm目录下新建一个名为WEB-INF的目录。这个目录的名字是Servlet规范中规定的，必须全部大写，且必须存在。

crm
    |------WEB-INF

1.3 创建classes目录

在WEB-INF目录下新建一个名为classes的目录。这个目录用于存放Java程序编译后的class文件（字节码文件）。

WEB-INF
    |------classes

1.4 创建lib目录

在WEB-INF目录下新建一个名为lib的目录。这个目录用于存放第三方jar包，例如数据库驱动jar包。

WEB-INF
    |------lib

1.5 创建web.xml文件

在WEB-INF目录下新建一个名为web.xml的文件。这个文件是Web应用的配置文件，用于描述请求路径和Servlet类之间的对照关系。

WEB-INF
    |------web.xml

1.5.1 web.xml文件内容

web.xml文件可以从其他Web应用中复制，内容如下：

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

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                      https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
  version="5.0"
  metadata-complete="true">

</web-app>

2. 编写Servlet类

2.1 实现Servlet接口

编写一个Java程序，这个程序必须实现Servlet接口。Servlet接口是Java EE规范的一部分，位于servlet-api.jar中。

package com.bjpowernode.servlet;

import jakarta.servlet.ServletException;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;

public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.println("<h1>Hello, Servlet!</h1>");
    }
}

2.2 编译Servlet类

为了编译Servlet类，需要配置环境变量CLASSPATH，使其包含servlet-api.jar。

CLASSPATH=.;C:\dev\apache-tomcat-10.0.12\lib\servlet-api.jar

编译Java源代码：

javac -d . HelloServlet.java

2.3 将class文件拷贝到classes目录

将编译后的HelloServlet.class文件拷贝到WEB-INF\classes目录下。

WEB-INF
    |------classes
              |------com
                    |------bjpowernode
                          |------servlet
                                |------HelloServlet.class

3. 配置web.xml文件

在web.xml文件中配置Servlet类和请求路径的映射关系。

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

<web-app xmlns="https://jakarta.ee/xml/ns/jakartaee"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee
                      https://jakarta.ee/xml/ns/jakartaee/web-app_5_0.xsd"
  version="5.0"
  metadata-complete="true">

    <!--servlet描述信息-->
    <servlet>
        <servlet-name>HelloServlet</servlet-name>
        <servlet-class>com.bjpowernode.servlet.HelloServlet</servlet-class>
    </servlet>

    <!--servlet映射信息-->
    <servlet-mapping>
        <servlet-name>HelloServlet</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>

</web-app>

4. 启动Tomcat服务器

启动Tomcat服务器，确保服务器正常运行。

5. 访问Servlet

打开浏览器，输入以下URL访问Servlet：

http://127.0.0.1:8080/crm/hello

浏览器将显示Servlet生成的内容：

Hello, Servlet!

6. 使用超链接

为了简化URL的输入，可以在HTML页面中使用超链接。HTML页面必须放在WEB-INF目录之外。

<!DOCTYPE html>
<html>
<head>
    <title>Home Page</title>
</head>
<body>
    <a href="/crm/hello">访问HelloServlet</a>
</body>
</html>

将这个HTML文件命名为index.html，并放在crm目录下。

crm
    |------index.html
    |------WEB-INF
              |------classes
              |------lib
              |------web.xml

7. 总结

通过以上步骤，我们成功开发了一个带有Servlet的Web应用。从目录结构的搭建到Servlet的编写和配置，每一步都严格按照Servlet规范进行。Servlet作为Java Web应用的核心技术，负责处理客户端请求并生成动态内容，是Java Web开发中不可或缺的一部分。

7.1 合法的Web应用目录结构

一个合法的Web应用目录结构如下：

webapproot
    |------WEB-INF
             |------classes(存放字节码)
             |------lib(第三方jar包)
             |------web.xml(注册Servlet)
    |------html
    |------css
    |------javascript
    |------image
    ....