【Servlet】第一个 Servlet 项目

已于 2023-09-22 17:26:05 修改
阅读量169 收藏
点赞数
分类专栏： Servlet 文章标签： servlet tomcat
于 2023-09-22 17:24:25 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/m0_61832361/article/details/133160179
版权

第一个 Servlet 项目

一. Servlet 是什么

Servlet 是一种实现动态页面的技术. 是一组 API, 帮助程序猿简单高效的开发一个 web app.

静态页面: 内容始终固定的页面. 即使 用户不同/时间不同/输入的参数不同 , 页面内容也不会发生变化.
动态页面: 用户不同/时间不同/输入的参数不同, 页面内容会发生变化.

构建动态页面的技术有很多, 每种语言都有一些相关的库/框架来做这件事.
Servlet 就是 Java 的一组 API, 来完成构建动态页面这个任务.
Tomcat是一个Servlet容器，提供了一个运行 Servlet 和 JavaServer Pages（JSP）的环境。程序员可以使用 Tomcat 来部署和运行 Servlet。

二. Servlet 主要做的工作

  • 允许程序员注册一个类, 在 Tomcat 收到某个特定的 HTTP 请求的时候, 执行这个类中的一些代码.
  • 帮助程序员解析 HTTP 请求, 把 HTTP 请求从一个字符串解析成一个 HttpRequest 对象.
  • 帮助程序员构造 HTTP 响应. 程序员只要给指定的 HttpResponse 对象填写一些属性字段, Servlet 就会自动的安装 HTTP 协议的方式构造出一个 HTTP 响应字符串, 并通过 Socket 写回给客户端.

简而言之, Servlet 是一组 Tomcat 提供的 API, 让程序猿自己写的代码能很好的和 Tomcat 配合起来, 从而更简单的实现一个 web app.
而不必关注 Socket, HTTP协议格式, 多线程并发等技术细节, 降低了 web app 的开发门槛, 提高了开发效率.

三. 第一个 Servlet 程序

1. 创建项目

使用 IDEA 创建一个 Maven 项目.

  1. File -> New -> Project
  2. 填入项目名称, 存放的路径
  3. 注意 Build System 选择 Maven, 而不是选择左侧的 Maven Archetype

在这里插入图片描述

2. 引入依赖

Maven 项目创建完毕后, 会自动生成一个 pom.xml 文件.
我们需要在 pom.xml 中引入 Servlet API 依赖的 jar 包.

  1. 在中央仓库 https://mvnrepository.com/ 中搜索 “Servlet”, 一般第一个结果就是.

在这里插入图片描述

  1. 选择版本. 一般我们使用 3.1.0 版本

在这里插入图片描述

Servlet 的版本要和 Tomcat 匹配.
如果我们使用 Tomcat 8.5, 那么就需要使用 Servlet 3.1.0
可以在 http://tomcat.apache.org/whichversion.html 查询版本对应关系.

在这里插入图片描述

  1. 把中央仓库中提供的 xml 复制到项目的 pom.xml 中

在这里插入图片描述

修改后的 pom.xml 形如

<?xml version="1.0" encoding="UTF-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>org.example</groupId>
    <artifactId>ServletHelloWorld</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>
    
</project>

标签内部放置项目依赖的 jar 包. maven 会自动下载依赖到本地.

注意, 如果首次使用, 代码可能标红, 标红表示还没有下载完, 可以 刷新一下试试.

在这里插入图片描述

关于 groupId, artifactId, version

groupId: 表示组织名称
artifactId: 表示项目名称
version: 表示版本号
中央仓库就是按照这三个字段来确定唯一一个包的.

在这里插入图片描述

红色方框圈出来的部分, 就是这个 jar 包的 groupId, artifactId, version

3. 创建目录

当项目创建好了之后, IDEA 会帮我们自动创建出一些目录. 形如
在这里插入图片描述

这些目录中:

  • src 表示源代码所在的目录
  • main/java 表示源代码的根目录. 后续创建 .java 文件就放到这个目录中.
  • main/resources 表示项目的一些资源文件所在的目录.
  • test/java 表示测试代码的根目录.

这些目录还不够, 我们还需要创建一些新的目录/文件.

  1. 创建 webapp 目录
    在 main 目录下, 和 java 目录并列, 创建一个 webapp 目录 (注意, 不是 webapps).

  2. 创建 web.xml
    在 webapp 目录内部创建一个 WEB-INF 目录, 并创建一个 web.xml 文件

  3. 编写 web.xml
    往 web.xml 中拷贝以下代码. 通过 web.xml Tomcat 才知道要加载哪些文件并运行起来.

<!DOCTYPE web-app PUBLIC
        "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
        "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>
    <display-name>Archetype Created Web Application</display-name>
</web-app>

注意这里的目录结构以及名称都不能错

在这里插入图片描述

webapp 目录就是未来部署到 Tomcat 中的一个重要的目录. 当前我们可以往 webapp 中放一些静态资源, 比如 html , css 等.
在这个目录中还有一个重要的文件 web.xml. Tomcat 找到这个文件才能正确处理 webapp 中的动态资源.

4. 编写代码

在 java 目录中创建一个类 HelloServlet, 代码如下:

@WebServlet("/hello") // 注意必须以 /  开头, 不能只写一个 hello
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
        System.out.println("hello"); // 只是让服务器在自己的控制台打印
        resp.getWriter().write("hello"); // 真正干活写数据的方法
    }
}

  • 创建一个类 HelloServlet , 继承自 HttpServlet

  • 在这个类上方加上 @WebServlet(“/hello”) 注解, 表示 Tomcat 收到的请求中, 路径为 /hello的请求才会调用 HelloServlet 这个类的代码. (这个路径只是Servlet Path, 未包含 Context Path)

  • 重写 doGet 方法. doGet 的参数有两个, 分别表示收到的 HTTP 请求 和要构造的 HTTP 响应. 这个方法会在 Tomcat 收到 GET 请求时触发, 而不用我们手动调用.

  • 注意要删除 super.doGet (req, resp); 这行代码, 这行代码内部就是直接返回错误页面.

  • HttpServletRequest 表示 HTTP 请求. Tomcat 按照 HTTP 请求的格式把 字符串 格式的请求转成了一个 HttpServletRequest 对象. 后续想获取请求中的信息(方法, url, header, body 等) 都是通过这个对象来获取.

  • HttpServletResponse 表示 HTTP 响应. 代码中把响应对象构造好(构造响应的状态码, header, body 等)

  • resp.getWriter() 会获取到一个流对象, 通过这个流对象就可以写入一些数据, 写入的数据会被构造成一个 HTTP 响应的 body 部分, Tomcat 会把整个响应转成字符串, 通过 socket 写回给浏览器.

这个代码虽然只有寥寥几行, 但是包含的信息量是巨大的.

  1. 我们的代码不是通过 main 方法作为入口了. main 方法已经被包含在 Tomcat 里, 我们写的代码会被 Tomcat 在合适的时机调用起来.
    此时我们写的代码并不是一个完整的程序, 而是 Tomcat 这个程序的一小部分逻辑.
  2. 我们随便写个类都能被 Tomcat 调用嘛? 满足啥样条件才能被调用呢?
    主要满足三个条件:
    a) 创建的类需要继承自 HttpServlet
    b) 这个类需要使用 @WebServlet 注解关联上一个 HTTP 的路径
    c) 这个类需要实现 doXXX 方法.
    当这三个条件都满足之后, Tomcat 就可以找到这个类, 并且在合适的时机进行调用.

5. 打包程序

使用 maven 进行打包. 打开 maven 窗口 (一般在 IDEA 右侧就可以看到 Maven 窗口, 如果看不到的话, 可以通过 菜单 -> View -> Tool Window -> Maven 打开)
然后展开 Lifecycle , 双击 package 即可进行打包.

在这里插入图片描述

如果比较顺利的话, 能够看到 SUCCESS 这样的字样.
在这里插入图片描述

打包成功后, 可以看到在 target 目录下, 生成了一个 jar 包.

在这里插入图片描述

这样的 jar 包并不是我们需要的, Tomcat 需要识别的是另外一种 war 包格式.
另外这个 jar 包的名字太复杂了, 我们也希望这个名字能更简单一点.

war 包和 jar 包的区别:

  • jar 包是普通的 java 程序打包的结果. 里面会包含一些 .class 文件.
  • war 包是 java web 的程序, 里面除了会包含 .class 文件之外, 还会包含 HTML, CSS, JavaScript, 图片, 以及其他的 jar 包. 打成 war 包格式才能被 Tomcat 识别.

ServletHelloWorld-1.0-SNAPSHOT.jar 的由来:
这个名字来源于 pom.xml 中的 artifactId 和 version

在这里插入图片描述

相当于把 artifactId 和 version 拼接起来了.

打为 war 包并重新命名:

  1. 在 pom.xml 中新增一个 packing 标签, 表示打包的方式是打一个 war 包.
<packaging>war</packaging>
  1. 在 pom.xml 中再新增一个 build 标签, 内置一个 finalName 标签, 表示打出的 war 包的名字是
    HelloServlet
<build>
    <finalName>ServletHelloWorld</finalName>
</build>

完整的 pom.xml 形如

<?xml version="1.0" encoding="UTF-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>org.example</groupId>
    <artifactId>ServletHelloWorld</artifactId>
    <version>1.0-SNAPSHOT</version>

    <properties>
        <maven.compiler.source>8</maven.compiler.source>
        <maven.compiler.target>8</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencies>
        <!-- https://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
        <dependency>
            <groupId>javax.servlet</groupId>
            <artifactId>javax.servlet-api</artifactId>
            <version>3.1.0</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <packaging>war</packaging>
    <build>
        <finalName>ServletHelloWorld</finalName>
    </build>
</project>

重新使用 maven 打包, 可以看到生成的新的 war 包的结果.

在这里插入图片描述

6. 部署程序

把 war 包拷贝到 Tomcat 的 webapps 目录下.

在这里插入图片描述

启动 Tomcat (运行 Tomcat 目录下的 bin 包中的 startup.bat (Windows) / startup.sh (Linux)), Tomcat 就会自动把 war 包解压缩.

在这里插入图片描述

看到这个日志说明 Tomcat 已经正确识别了 ServletHelloWorld 这个 webapp.

在这里插入图片描述

7. 验证程序

此时通过浏览器访问 http://127.0.0.1:8080/ServletHelloWorld/hello
就可以看到结果了.

在这里插入图片描述

注意: URL 中的 PATH 分成两个部分, 其中 HelloServlet 为 Context Path,就是打的包的名字, hello 为 Servlet Path, 是代码中 @WebServlet 注解里面的路径

在这里插入图片描述

可以这么认为:
一个 Tomcat 上可以同时部署多个网站, 一个网站上又有多个页面, Context Path 是告诉 Tomcat 要访问的是哪个网站, Servlet Path 是告诉 Tomcat 要访问的是 Tomcat 上的哪个页面.

四. 更方便的部署方式

手动拷贝 war 包到 Tomcat 的过程比较麻烦. 我们还有更方便的办法.
此处我们使用 IDEA 中的 Smart Tomcat 插件完成这个工作.

1. 安装 Smart Tomcat 插件

  1. File -> Settings

在这里插入图片描述

  1. 选择 Plugins, 选择 Marketplace, 搜索 “tomcat”, 点击 “Install”.

在这里插入图片描述

  1. 安装完毕之后, 会提示 “重启 IDEA”

在这里插入图片描述

2. 配置 Smart Tomcat 插件

  1. 点击右上角的 “Add Configuration”

在这里插入图片描述

  1. 选择左侧的 “Smart Tomcat”

在这里插入图片描述

  1. 在 Name 这一栏填写一个名字(可以随便写)
    在 Tomcat Server 这一栏选择 Tomcat 所在的目录. 其他的选项不必做出修改.
    其中 Context Path 默认填写的值是项目名称, 我们也可以自己更改一下, 但这会影响到后面咱们的访问页面的路径.

在这里插入图片描述

  1. 点击 OK 之后, 右上角变成了

在这里插入图片描述

点击绿色的三角号, IDEA 就会自动进行编译, 部署, 启动 Tomcat 的过程.

在这里插入图片描述

注意:

  • 将之前启动的 Tomcat 关闭, 不然会因为端口号已经被占用而启动失败
  • 直接点击控制台中出现的路径是不能访问的, 这个路径只包含了对应的 Context Path, 不包含具体的Servlet Path 或者其他资源的具体位置.
  1. 访问页面.

在浏览器中使用 http://127.0.0.1:8080/ServletHelloWorld/hello 访问页面.

在这里插入图片描述

注意路径的对应关系, 与上面不同了, Context Path 变成了我们配置 Smart Tomcat 时的 Context Path

在这里插入图片描述

使用 Smart Tomcat 部署的时候, 我们发现 Tomcat 的 webapps 内部并没有被拷贝一个 war 包, 也没有看到解压缩的内容.
所以并没有真正打包. Smart Tomcat 相当于是在 Tomcat 启动的时候直接引用了项目中的 webapp 和 target 目录.

在这里插入图片描述

注意: Tomcat 和 IDEA 是两个独立的程序, Tomcat 不是 IDEA 功能的一部分, Smart Tomcat 是第三方工具, 将 Tomcat 和 IDEA 连接起来了.

Gmerrysong
关注
专栏目录
使用Tomcat搭建一个Servlet项目
weixin_46429649的博客
08-25 2375
Tomcat maven 使用 创建maven项目 管理依赖 实践 使用总结 GET,POST请求应用场景 Servlet运行原理 Tomcat伪代码 Tomcat初始化 Tomcat处理请求 Servlet的关键API HTTPServlet HttpServletRequest和HttpServletResponse 例子1： 例子2： body格式 请求body格式 响应body格式 Cookie和Session HttpServletRequest类中的相关方法 HttpServletRespons
Servlet项目创建
最新发布
m0_52478073的博客
02-06 2283
Servlet项目的创建，访问异常情况分析
servlet项目
02-28
项目 servlet 毕业设计
Servlet 项目
qq_45898173的博客
09-23 518
Servlet是利用Java类编写的服务端应用程序，它可以被看作是位于客户端和服务器的一个中间层，负责接受和请求客户端用户的响应。 1：对客户端发送的数据惊醒读取和拦截 2：读取客户端请求的隐含数据 3：运行结果或者生活结果 4：发送响应的数据 #Servlet的技术特点 Servlet的xml文件配置 inder文件 Servlet的生命周期 // 运行 protected void service(HttpServletRequest arg0, HttpServletResponse arg1)
基于servlet开发的项目
12-02
用纯servlet技术开发的一个项目，帮你快速了解servlet开发过程，包含oracle脚本文件。
servlet实例项目
08-14
servlet实例项目，主要功能为日报管理，前端为bootstrap技术
servlet第一个例子（工程+tomcat）
05-06
创建Servlet的第一个步骤是建立一个Java项目。这通常涉及到以下步骤： 1. **环境配置**：确保你已经安装了Java Development Kit (JDK) 和 Apache Tomcat。设置好环境变量，如`JAVA_HOME`和`CATALINA_HOME`。 2. **...
j2ee.zip servlet第一个例子
05-06
"Servlet第一个例子"可能包括以下步骤： 1. **创建Servlet类**：在Java中，你需要继承`javax.servlet.http.HttpServlet`抽象类或实现`javax.servlet.Servlet`接口来创建一个Servlet。通常，我们会选择前者，因为它...
NomeDoProjeto:第一个 Servlet 项目 - 博客 http
07-05
【Servlet技术介绍】 Servlet是Java编程语言...总之，"NomeDoProjeto"是一个很好的实践平台，通过这个项目，初学者能够深入理解Servlet在实际Web开发中的应用，从而为进一步学习Java EE或其他Web框架打下坚实的基础。
servlet小型项目
08-03
servlet小项目 public class BookListener implements ServletContextListener { public void contextDestroyed(ServletContextEvent arg0) { // TODO Auto-generated method stub } public void contextInitialized(ServletContextEvent event) { Map map = new TreeMap(); Book b1 = new Book(1,"core java",100); Book b2 = new Book(2,"c++",132); Book b3 = new Book(3,"php",10); Book b4 = new Book(4,"asp",178); map.put(b1.getId(), b1); map.put(b2.getId(), b2); map.put(b3.getId(), b3); map.put(b4.getId(), b4); ServletContext context = event.getServletContext(); context.setAttribute("bookmap",map); } }
servlet+Jsp 项目
07-22
利用servlet技术写的小项目，数据库sql语句，jsp，持久层，业务层
通过原始Servlet写最基本的Web应用（1）源码
09-09
之前做项目都是一股脑的做SpringMVC的SSH项目，而且还是半路出家的那种。。。感觉好多前后台交互的东西实现起来很困难，而后才真正懂了什么叫JSP。。。很尴尬，所以现在重新补JAVA-JSP-Web知识，记录一下发个源码，方便需要的童鞋，也方便自己的理解！详情请移步我的博文：http://blog.csdn.net/o0DarkNessYY0o/article/details/52491572
纯Servlet web项目无框架
07-15
该项目未使用任何框架，使用最初的web编程技术写的demo
纯servlet简易demo
04-06
简易servlet项目
Servlet示例项目
miracle_8的博客
08-12 447
页面部分或js$.ajax({ type: "POST", url: _contextPath + "/getAllInfo", dataType: "json", success: function() {} });web.xml 修改<servlet> <servlet-name>getAllInfo</servlet-name>
敲一个servlet项目
fenghuanxia66的博客
12-25 153
首先 pom.xml引入依赖 &amp;lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&amp;gt; &amp;lt;project xmlns=&quot;http://maven.apache.org/POM/4.0.0&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-in
servlet的一个小项目（五）
Leo_cumt的博客
02-14 781
servlet的一个小项目（五）ps：这个代码用的是韩顺平老师的servlet课程中的代码，稍作修改。更新页面：其实重要的还是sql语句，一定要打牢基础。//修改用户界面package com.tsinghua;import javax.servlet.http.*;import java.io.*; public class Update extends HttpServlet { //处
第一个servlet项目
mqingo的博客
12-09 460
1.web工程测试没问题后,开始新建一个servlet项目 2.新建一个类,实现Servlet接口 注:在实现接口前,一定要选中项目,右键build path,找到configure build path ,library,add library,server runtime,我用的是tomcat8.0,选中,点击finish.否则,实现接口的时候,无法选择包. 3.Hell...
Servlet入门教程：创建第一个Servlet程序
实验目的中的第一点强调理解Servlet的三大要素： 1. **Servlet的作用**：Servlet主要用来处理和生成动态网页内容，它可以接收HTTP请求，执行服务器端的业务逻辑，然后生成响应返回给客户端。例如，处理用户登录、...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值