Servlet的使用手把手教学(一）

最新推荐文章于 2023-08-26 21:00:16 发布
最新推荐文章于 2023-08-26 21:00:16 发布
阅读量3.7k 收藏 115
点赞数 41
分类专栏： JavaEE 文章标签： servlet java tomcat
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_46913665/article/details/124850210
版权

文章目录

提示：看这篇文章之前，建议先阅读博主上两篇文章，配合食用。

一、Tomcat-- 掌握汤姆猫，看这一篇文章就够了

二、Maven的安装及使用

一、Servlet是什么

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

1.Servlet的主要工作

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

  当然, Servlet 还支持一些其他的辅助功能, 此处暂时先不介绍。
  简而言之, Servlet 是一组 Tomcat 提供的 API, 让程序猿自己写的代码能很好的和 Tomcat 配合起来, 从而更简单的实现一个 web app，而不必关注 Socket, HTTP协议格式, 多线程并发等技术细节, 降低了 web app 的开发门槛, 提高了开发效率。

 

 

二、第一个 Servlet 程序

1. 创建项目

使用 IDEA 创建一个 Maven 项目.

  1. 菜单 -> 文件 -> 新建项目 -> Maven

在这里插入图片描述
2) 选择项目要存放的目录

在这里插入图片描述
3）创建完成

在这里插入图片描述

2. 引入依赖

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

  1. 在 Maven中央仓库中搜索 “servlet”， 一般第一个结果就是。

在这里插入图片描述

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

在这里插入图片描述
【注意】

  Servlet 的版本要和 Tomcat 匹配，如果我们使用 Tomcat 8.5, 那么就需要使用 Servlet 3.1.0，可以在 这个网址（点击这里）查询版本对应关系。

 

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

在这里插入图片描述

修改后的 pom.xml 形如：

在这里插入图片描述
第一次使用可能有标红的现象，把文件下载下来了，标红就没有了。

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

关于 groupId, artifactId, version

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

例如：下图红色方框圈出来的部分, 就是这个 jar 包的 groupId, artifactId, version。

在这里插入图片描述

3.创建目录

当项目创建好了之后, IDEA 会帮我们自动创建出一些目录。形如：

在这里插入图片描述

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

虽然当下maven 帮我们创建了一些目录，但是还不足以支撑咱们写一个Servlet项目，因此需要手动的再创建一些目录和文件出来。

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

在这里插入图片描述

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

在这里插入图片描述

  1. 编写 web.xml
    往 web.xml 中拷贝以下代码：
<!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")
public class HelloServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        System.out.println("hello servlet!");
        resp.getWriter().write("hello");
    }
}

解释：

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

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

  • 重写 doGet 方法。 doGet 的参数有两个, 分别表示收到的 HTTP 请求 和要构造的 HTTP 响应。 这个方法会在 Tomcat 收到 GET 请求时触发。一个服务器的工作流程,就可以分成三个典型的步骤:
    1.接收请求并解析.
    2.根据请求计算响应一
    3.构造响应数据,并返回给客户端
    1和3这两步, tomcat 已经帮我们做好了；2这步就是咱们程序猿自己要实现的逻辑。也就是doGet要实现的内容

  • 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 即可进行打包。

在这里插入图片描述
如果成功的话，会出现下面的字样：
在这里插入图片描述
如果代码/配置/环境存在问题, 可能会提示 BUILD FAILED, 可以根据具体提示的错误信息具体解决。

 

打包成功后, 可以看到在 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 的由来：

在这里插入图片描述
相当于把 artifactId 和 version 拼接起来了。

在 pom.xml 中新增一个 packing 标签, 表示打包的方式是打一个 war 包。

 <packaging>war</packaging>

在这里插入图片描述
在 pom.xml 中再新增一个 build 标签, 内置一个 finalName 标签, 表示打出的 war 包的名字是HelloServlet。

<build>
	<finalName>ServletHelloWorld</finalName>
</build>

在这里插入图片描述

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

在这里插入图片描述

6. 部署程序

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

(1)打开war的位置
在这里插入图片描述（2）复制黏贴到tomcat文件夹下：

在这里插入图片描述
启动tomcat
在这里插入图片描述
看到这个日志说明 Tomcat 已经正确识别了 ServletHelloWorld 这个 webapp。

7. 验证程序

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

在这里插入图片描述

注意: URL 中的 PATH 分成两个部分, 其中 HelloServlet 为 Context Path, hello 为 Servlet Path。

在这里插入图片描述

  到了这里，有的同学可能会很纳闷，花费了这么大力气，写出来的页面，不过如此，这和你直接创建一个HTML，里面写个hello world有啥区别呢？

   实际上，我们这里的页面内容是用Java代码生成的，也就是说这里的页面是可变的，可以根据用户的不同输入，得到不同的结果；而使用HTML写的话，页面里的内容是固定死的了，是静态的。

  假如现在我们这里加个时间戳的输出的话，页面内容每次刷新都会不一样。
在这里插入图片描述在这里插入图片描述

  上述这七个步骤,这是针对一个新的项目。项目创建好之后，后续修改代码,前三个步骤就不必重复了，直接从4-7进行操作即可。上面步骤看似麻烦，熟练之后，其实一分钟就可以完成。

 

 

三、快捷的部署方式

  上面介绍的步骤,其实都是最原始的操作了。实际上，我们也有一些办法,来提高上述流程的效率，就可以通过一些第三方工具来简化5和6的操作。毕竟每次修改代码,都需要重新打包,重新部署，会有点麻烦。

  这里说的第三方工具，实际上是一些插件。此处我们使用 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即可。

在这里插入图片描述

此时 Tomcat 日志就会输出在 IDEA 的控制台中, 可以看到现在就不再乱码了。

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

在这里插入图片描述

 

 

四、常见的访问出错

1.出现 404

404 表示用户访问的资源不存在。

  1. 你请求的资源路径写的不对
  2. 路径虽然对,但是服务器没有正确把资源加载起来

 

错误实例一： 少写了 Context Path

通过 /hello 访问服务器

在这里插入图片描述

 
错误实例2: 少写了 Servlet Path
通过 /ServletHelloWorld 访问服务器。

在这里插入图片描述

 
错误实例3: Servlet Path 写的和 URL 不匹配.

这里是hello:
在这里插入图片描述少了一个o
在这里插入图片描述

 
错误实例4: web.xml 写错了

清除 web.xml 中的内容

重启 Tomcat 服务器.
通过浏览器访问 URL, 可以看到:

在这里插入图片描述

 

 

2.出现 405

405 表示对应的 HTTP 请求方法没有实现。

错误实例: 没有实现 doGet 方法。

重启 Tomcat 服务器.
在浏览器中访问, 可以看到:

在这里插入图片描述

  在浏览器地址栏直接输入 URL , 会发送一个 HTTP GET 请求。此时就会根据 /ServletHelloWorld/hello 这个路径找到 HelloServlet 这个类. 并且尝试调用HelloServlet 的 doGet 方法，但是如果没有实现 doGet 方法, 就会出现上述现象。

 

 

3.出现 500

往往是 Servlet 代码中抛出异常导致的

假如我们的代码如下，s指向null：
在这里插入图片描述

重启 Tomcat 服务器，重新访问页面, 可以看到:

在这里插入图片描述
  在页面上已经有具体的异常调用栈，异常信息里已经提示了出现异常的代码是 HelloServlet.java 的第 15 行。仔细检查这里的代码就可以看到空指针异常。

4.出现 “空白页面”

我们修改代码, 去掉 resp.getWritter().write() 操作。

重启服务器,访问服务器, 可以看到一个空白页面:在这里插入图片描述
抓包可以看到, 响应 body 中的内容就是 “空数据”:

5.出现 “无法访问此网站”

一般是 Tomcat 启动就失败了。

比如说Servlet Path 写错了。应该写作 “/hello”。
在这里插入图片描述

  Tomcat 在启动的时候已经提示了相关的错误。Tomcat 启动的日志里面报错信息可能比较多, 需要耐心观察, 找到关键的提示。

在这里插入图片描述

6.小结

  初次学习Servlet, 遇到的出错的这类问题会非常多. 我们不光要学习 Servlet 代码的基本写法, 也要学习排查错误的思路。熟悉 HTTP 协议能够让我们调试问题事半功倍。

  • 4xx 的状态码表示路径不存在, 往往需要检查 URL 是否正确, 和代码中设定的 Context Path 以及Servlet Path 是否一致。
  • 5xx 的状态码表示服务器出现错误, 往往需要观察页面提示的内容和 Tomcat 自身的日志, 观察是否存在报错。
  • 出现连接失败往往意味着 Tomcat 没有正确启动, 也需要观察 Tomcat 的自身日志是否有错误提示。
  • 空白页面这种情况则需要我们使用抓包工具来分析 HTTP 请求响应的具体交互过程。

  观察日志是调试程序的重要途径，Tomcat 的日志往往很多, 需要我们耐心阅读, 经常阅读, 熟练了就能更快速的找到问题了。

 

 

完！

十叶知秋
关注
  • 41
    点赞
  • 踩
  • 115
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 23
    评论
专栏目录
实验四 JavaBean及Servlet使用
02-08
一、实验目的 1．熟悉JavaBean的开发过程。 2．掌握Servlet的开发过程。 二、实验学时 2H 三、实验性质 综合性实验
使用Servlet处理一个上传的文件
08-26
今天小编就为大家分享一篇关于使用Servlet处理一个上传的文件，小编觉得内容挺不错的，现在分享给大家，具有很好的参考价值，需要的朋友一起跟随小编来看看吧
使用Servlet实现文件的下载
10-17
使用Servlet实现文件的下载
token-servlet使用案例.zip
06-06
java+servlet-来实现token的使用，可经过简易修改即可用于大多数java项目的token异步登录功能。
Servlet 简单使用
08-15
Servlet 简单使用
Servlet的基本使用
m0_67683346的博客
11-18 2630
servlet的基本使用
Servlet 的使用
wwzzzzzzzzzzzzz的博客
04-24 1643
文章目录1. Servlet1.1 什么是 Servlet1.2 Servlet 的使用① 创建 Maven 项目② 引入依赖③ 创建目录结构④ 写一个简单的代码⑤ 打包程序(打war包)⑥ 将 war 包 部署到 Tomcat 的 webapps目录下⑦ 在浏览器上访问1.3 使用 IDEA 的插件部署① File -> Settings② Plugins -> Marketplace 搜索 Smart Tomcat 下载 然后重启IDEA③ 点击 Add Configuration...-&
Servlet详细教程
qq_52699757的博客
08-26 6289
Servlet详细教程
servlet的基本使用
weixin_67235801的博客
04-27 1632
servlet的介绍以及配置
报错已解决:@WebServlet报红,@Param报红
m0_63673788的博客
03-02 5029
报错描述 基于Spring+idea创建JavaWeb项目,在LoginServlet类中出现@WebServlet报红,@Param报红. 报红消失前的操作:pom.xml文件中的<plugin>标签改为如下 <build> <plugins> <plugin> <groupId>org.apache.tomcat.maven</groupId>
Servlet配置与使用
weixin_46721191的博客
04-18 9147
Servlet（Server Applet）是Java Servlet的简称，称为小服务程序或服务连接器，用Java编写的服务器端程序，具有独立于平台和协议的特性，主要功能在于交互式地浏览和生成数据，生成动态Web内容。狭义方面来讲 Servlet是指Java语言实现的一个接口，广义的Servlet是指任何实现了这个Servlet接口的类，一般情况下，人们将Servlet理解为后者。Servlet运行于支持Java的应用服务器中。
Servlet的详细教程
小yu别错过的博客
09-10 3056
文章目录一、Servlet的简介二、Servlet的入门案例三、创建Servlet的三种方式3.1实现Servlet接口的方式3.2继承GenericServlet抽象类的方式3.3继承HttpServlet的方式四、Servlet注解和配置文件的写法4.1配置文件的写法4.2注解的写法五、Servlet的生命周期六、Servlet获取前端请求的参数七、通过前端发送数据到servlet，然后存入到数据库八、中文乱码的解决方案九、重定向和转发【重要】9.1重定向9.2转发十、URL匹配规则十一、Servlet
Servlet的使用（JavaEE初阶系列17）
最新发布
weixin_61599986的博客
08-26 1193
Servlet的使用，快来码住了。
IDEA解决@WebServlet报红的问题
qq_47455677的博客
10-26 4044
1、@WebServlet注解依赖servlet-api，检查是项目已经导入。2、看idea是否导入Tomcat依赖（本人就是这个问题）
@Webservlet注解爆红（已经解决）
qq_55018589的博客
04-16 3897
就是，我想用注解代替web.xml时，发现爆红了，于是我开始盲目的找爆红的原因， 在网上看到说，没有把tomcat jar包导入工程下边，然后我导入了，发现还是不行 最后听说只有servlet3.0之后才能够使用注解 发现自己的servet-api还是2.多版本的，当然不行了 换成4.多的版本就好了 哭了 感悟 遇到报错应该先分析自己是否会这个知识十分了解，否则不要无病乱投医，要不然只会浪费时间 ...
servlet执行详解
qq_62939743的博客
07-27 2898
servlet
Servlet快速入门和 HttpServlet使用步骤
我要记录学习博客
03-24 1763
Servlet快速入门和 HttpServlet使用步骤 Servlet是JavaWeb最为核心的内容，它是Java提供的一门动态web资源开发技术。 使用Servlet就可以实现，根据不同的登录用户在页面上动态显示不同内容。 Servlet是JavaEE规范之一，其实就是一个接口，将来我们需要定义Servlet类实现Servlet接口，并由web服务器运行Servlet 快速入门 1、插件web项目并引入tomcat服务器插件和servlet坐标 <!--导入servlet依赖坐标-->
HttpServlet 详解
qq_45793102的博客
01-05 5222
1. 简述 1.1 Servlet Java Servlet 是运行在服务器上的程序，其作为来自 Web 浏览器或其他 HTTP 客户端的请求和 HTTP 服务器上的数据库或应用程序之间的中间层。 使用 Servlet可收集来自网页表单的用户输入，呈现来自数据库或者其他源的记录，还可以动态创建网页。 1.2 HttpServlet HttpServlet是Servlet接口的一个实现类，并且它是一个抽象类，servlet.http包中定义了采用HTTP通信协议(一个无状态协议)的HttpServle
servlet的使用
wxx200008的博客
07-22 779
servlet的基本使用方法
java servlet 使用教程
05-13
Java Servlet 是一种运行在 Web 服务器上的 Java 类，用于处理来自客户端（浏览器）的请求并生成响应。Servlet 通常用于开发 Web 应用程序，如电子商务网站、博客、社交平台等。 以下是 Java Servlet 的使用教程： 1. 下载并安装 Java 开发工具包（JDK）和 Apache Tomcat 服务器。 2. 创建一个 Java 项目，并在项目中创建一个 Servlet 类。例如，创建一个名为 MyServlet 的 Servlet 类： ```java import java.io.IOException; import javax.servlet.ServletException; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; public class MyServlet extends HttpServlet { private static final long serialVersionUID = 1L; protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { response.getWriter().println("Hello, World!"); } } ``` 3. 在 web.xml 文件中配置 Servlet。例如，在 web.xml 文件中添加以下代码： ```xml <servlet> <servlet-name>MyServlet</servlet-name> <servlet-class>MyServlet</servlet-class> </servlet> <servlet-mapping> <servlet-name>MyServlet</servlet-name> <url-pattern>/myservlet</url-pattern> </servlet-mapping> ``` 4. 启动 Tomcat 服务器，并在浏览器中访问 `http://localhost:8080/your-application/myservlet`。您应该能够看到 "Hello, World!" 的输出。 这只是 Java Servlet 的基本用法。它还有很多其他功能，例如处理表单数据、会话管理、过滤器等。您可以查阅相关文档来深入学习。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 23
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

十叶知秋

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值