Jave Web是java面向web开发的相关技术,他是相关技术的统称,并不是指某一个单一的技术。
在我之前的博客中(Java网络编程----通过实现简易聊天工具来聊聊BIO模型 https://www.cnblogs.com/jilodream/p/17405923.htm),就已经写到过java可以作为一个服务器(如TCP/UDP),接收外部的请求。如使用TCP监听端口,然后直接用web页面请求该端口,那么服务器就会接收到相关的响应,接着做好业务处理,返回响应的请求即可。但是整个的业务流程太繁琐了。我们不但要处理业务流程,还要控制请求会话,还要控制各种业务分支的处理,显然这不是我们想要的。
于是聪明的开发者很快想到了-----解耦,业务人员只要编写相关的业务即可,不需要关心繁琐的网络细节处理,因此就诞生了servlet。开发人员只要实现servlet,而servlet和不同的路径绑定。web请求后,由系统直接转发到各自的Servlet,并由Servlet来处理相关业务即可。
那什么是servlet呢?servlet 是
Server Applet
(服务器应用程序)的简写,从名字我们就可以看出它是专门用来编写服务器端的应用程序。我们通常用它来处理服务器中http请求的处理和响应。
它是一项很古老的技术,随java诞生之初就已经问世,很多人甚至都不知Servlet是做什么。那么问题来了,我们为什么还要学习和掌握Servlet呢?这主要是由于Servlet是javaEE的重要组成,是java web开发的重要基石。我们现在项目中常用到的Jsp、Springmvc、Springboot等框架,在处理网络请求的核心技术,仍然是Servlet。我们虽然不需要再继续直面Servlet或更底层的技术进行开发,但是Servlet究竟是什么样的,如何执行,以及再新技术中承担什么样的角色,这个却是我们想要熟悉底层原理所必须要掌握的。
话不多说,想要使用Servlet,我们需要做两步:
1、编写Servlet相关业务代码
2、将业务代码打包放置在Tomcat中,由Tomcat来加载这些Servlet
第一步,试着来编写一个Servlet
我们首先通过IDEA 新建一个web项目,此处我们选择采用maven部署,搭建好之后项目整体的结构就如下面的文件层级树一样
了
E:.
├─.idea
├─.smarttomcat
│ └─PureJaveServlet
│ └─conf
└─src
└─main
├─java
│ └─org
│ └─example
├─resources
└─webapp
其中:
resources 一般是我们填写的资源信息,如图片,业务配置文件等,
webapp则会放置html、css等渲染文件,还会放一些web组件(Servlet、Filter)的配置信息。我们这里只要知道作用即可。
src/main/java则是我们的业务代码。值得注意的是,我们要引入Servlet网络编程的相关依赖包,才能进行相关的web开发。默认的java SE是不包含这些开发包的。
在Servlet4.0之前,我们只使用javax相关的包,并且未来对接的是Tomcat 9.x及以下版本。(防盗连接:本文首发自http://www.cnblogs.com/jilodream/ )
在Servlet5.0之后,我们只使用javax相关的包,并且未来对接的是Tomcat 10.x及以后版本。
这里我们使用高版本来学习,即jakarta版本,未来tomcat也需要使用高版本。
接着编写POM文件:
1 <?xml version="1.0" encoding="UTF-8"?>
2 <projectxmlns="http://maven.apache.org/POM/4.0.0"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
5 <modelVersion>4.0.0</modelVersion>
6
7 <groupId>org.example</groupId>
8 <artifactId>PureJaveServlet</artifactId>
9 <version>1.0-SNAPSHOT</version>
10 <name>PureJaveServlet</name>
11 <packaging>war</packaging>
12
13 <properties>
14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15 <maven.compiler.target>11</maven.compiler.target>
16 <maven.compiler.source>11</maven.compiler.source>
17 </properties>
18
19 <dependencies>
20 <dependency>
21 <groupId>jakarta.servlet</groupId>
22 <artifactId>jakarta.servlet-api</artifactId>
23 <version>5.0.0</version>
24 <scope>provided</scope>
25 </dependency>
26
27 <dependency>
28 <groupId>org.projectlombok</groupId>
29 <artifactId>lombok</artifactId>
30 <version>1.18.30</version>
31 </dependency>
32 <dependency>
33 <groupId>org.apache.commons</groupId>
34 <artifactId>commons-lang3</artifactId>
35 <version>3.13.0</version>
36 </dependency>
37 <!--http客户端-->
38 <!--fastjson-->
39 <dependency>
40 <groupId>com.alibaba</groupId>
41 <artifactId>fastjson</artifactId>
42 <version>1.2.83</version>
43 </dependency>
44
45
46 <dependency>
47 <groupId>com.fasterxml.jackson.core</groupId>
48 <artifactId>jackson-databind</artifactId>
49 <version>2.10.0</version>
50 </dependency>
51 <dependency>
52 <groupId>io.pebbletemplates</groupId>
53 <artifactId>pebble</artifactId>
54 <version>3.1.6</version>
55 </dependency>
56 <dependency>
57 <groupId>org.apache.maven.plugins</groupId>
58 <artifactId>maven-compiler-plugin</artifactId>
59 <version>3.10.1</version>
60 </dependency>
61
62 </dependencies>
63
64 <build>
65 <plugins>
66 <plugin>
67 <groupId>org.apache.maven.plugins</groupId>
68 <artifactId>maven-war-plugin</artifactId>
69 <version>3.3.2</version>
70 </plugin>
71 <plugin>
72 <groupId>org.apache.maven.plugins</groupId>
73 <artifactId>maven-compiler-plugin</artifactId>
74 <configuration>
75 <compilerArgs>
76 <arg>-parameters</arg>
77 </compilerArgs>
78 </configuration>
79 </plugin>
80 </plugins>
81 </build>
82 </project>
Servlet类
1 packageorg.example;2
3
4 importjakarta.servlet.ServletException;5 importjakarta.servlet.annotation.WebServlet;6 importjakarta.servlet.http.HttpServlet;7 importjakarta.servlet.http.HttpServletRequest;8 importjakarta.servlet.http.HttpServletResponse;9
10 importjava.io.IOException;11 importjava.io.PrintWriter;12
13
14 @WebServlet(urlPatterns = "/nihao")15 public class HiServlet extendsHttpServlet {16 @Override17 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throwsIOException {18 String name = req.getParameter("name");19 resp.setContentType("text/html");20 PrintWriter out =resp.getWriter();21 out.println("<html><body>");22 out.println(String.format("<h1>Hello, %s </h1>", name));23 out.println("</body></html>");24 out.flush();25 }26 }
1 packageorg.example;2
3 importjakarta.servlet.annotation.WebServlet;4 importjakarta.servlet.http.HttpServlet;5 importjakarta.servlet.http.HttpServletRequest;6 importjakarta.servlet.http.HttpServletResponse;7
8 importjava.io.IOException;9 importjava.io.PrintWriter;10
11 /**
12 * @discription13 */
14 @WebServlet(urlPatterns = "/bye")15 public class ByeServlet extendsHttpServlet {16 @Override17 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throwsIOException {18 String name = req.getParameter("name");19 resp.setContentType("text/html");20 PrintWriter out =resp.getWriter();21 out.println("<html><body>");22 out.println(String.format("<h1>bye bye, %s </h1>", name));23 out.println("</body></html>");24 out.flush();25 }26 }
代码部分就结束了,我们观察代码可以发现两点:
1、所有的Sevlet都要继承自HttpServlet。HttpServlet是一个抽象类,我们需要复写抽象类中的抽象方法,以保证未来Tomcat等web服务器在加载Servlet时,可以按照统一的规范查找,执行。
我们在Servlet中重写了doGet() 方法,表示处理该servlet路径下的get请求,同理还可以重写doPost doDelete doPut等方法,来处理对应的请求类型。
这里我们很简单,直接返回一段响应的html。
2、我们并没有写main方法,而是在Pom中标记我们的工程需要打包成一个war包。
第二步,配置tomcat
没有main方法,我们如何启动我们的java程序呢?我们通常是将其配置到tomcat的指定路径中,启动tomcat后,tomcat会加载war包中servlet的相关类,进行处理。
因此我们会将tomcat这样的web服务器称之为Servlet容器。
我们首先从tomcat官网上(https://tomcat.apache.org/whichversion.html)下载一个与我们对应的servlet版本匹配的tomcat版本。
下载到本地之后解压即可。
接着我们为了方便在IDEA中下载一个smart tomcat的组件,将该组件关联好servlet代码和tomcat服务器即可。
关键配置如下:
Tomcat server: 选择我们下载好的tomcat服务器,如果没有下拉选项就选择"Congure..."手动加一下。
Deployment dirctory:部署文件夹,(防盗连接:本文首发自http://www.cnblogs.com/jilodream/ )该配置指向前文项目结构树种的webapp。
Use classpath of module:选择当前项目
Context path:选择上下文路径(其实就是url的前缀路径),按照url规则随便填,我这里叫填的是/biubiubiu
server port:Servlet的服务器端口,默认填8080
admin port:tomcat的管理端口 默认填8005,一般就是用于停掉tomcat(其实一般也不用)。
之后我们通过IDEA:拉起tomcat,加载servlet相关类和资源。
命令行输入如下:
....
15-Nov-2024 10:34:38.099 信息 [main] org.apache.coyote.AbstractProtocol.start 开始协议处理句柄["http-nio-8080"]15-Nov-2024 10:34:39.831 信息 [main] org.apache.catalina.startup.Catalina.start [4858]毫秒后服务器启动
http://localhost:8080/biubiubiu
执行效果如下:
有人会觉得通过下载并配置tomcat有点麻烦,我们如果想debug代码的话,就更麻烦了,有没有简单点的办法:
其实除了下载tomcat,我们还可以通过代码的形式直接拉起tomcat。思路如下:
首先通过maven加载对应tomcat依赖,然后在main方法中创建tomcat实例,并且指定tomcat所需要的配置信息,如资源和class路径。然后通过start()方法启动tomcat实例就可以了。
代码如下:
新搭建一个java web项目,Servlet类和工程结构我们保持不变还是和原来一样
POM文件
1 <?xml version="1.0" encoding="UTF-8"?>
2 <projectxmlns="http://maven.apache.org/POM/4.0.0"
3 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
5 <modelVersion>4.0.0</modelVersion>
6
7 <groupId>com.example</groupId>
8 <artifactId>demotom</artifactId>
9 <version>1.0-SNAPSHOT</version>
10 <name>demotom</name>
11 <packaging>war</packaging>
12
13 <properties>
14 <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
15 <maven.compiler.target>11</maven.compiler.target>
16 <maven.compiler.source>11</maven.compiler.source>
17 <tomcat.version>10.0.0</tomcat.version>
18 </properties>
19
20 <dependencies>
21
22
23 <dependency>
24 <groupId>org.apache.tomcat.embed</groupId>
25 <artifactId>tomcat-embed-core</artifactId>
26 <version>${tomcat.version}</version>
27 <scope>provided</scope>
28 </dependency>
29 <dependency>
30 <groupId>org.apache.tomcat.embed</groupId>
31 <artifactId>tomcat-embed-jasper</artifactId>
32 <version>${tomcat.version}</version>
33 <scope>provided</scope>
34 </dependency>
35 </dependencies>
36
37 <build>
38 <plugins>
39 <plugin>
40 <groupId>org.apache.maven.plugins</groupId>
41 <artifactId>maven-war-plugin</artifactId>
42 <version>3.3.2</version>
43 </plugin>
44 </plugins>
45 </build>
46 </project>
主类:
1 packagecom.example.demotom;2
3 importorg.apache.catalina.Context;4 importorg.apache.catalina.LifecycleException;5 importorg.apache.catalina.WebResourceRoot;6 importorg.apache.catalina.startup.Tomcat;7 importorg.apache.catalina.webresources.DirResourceSet;8 importorg.apache.catalina.webresources.StandardRoot;9
10 importjava.io.File;11
12 /**
13 * @discription14 */
15 public classTomMain {16 public static void main(String[] args) throwsLifecycleException {17 Tomcat tomcat = newTomcat();18 tomcat.setPort(Integer.getInteger("port", 8080));19 tomcat.getConnector();20 String docBase = new File("src/main/webapp").getAbsolutePath();21 Context ctx = tomcat.addContext("", docBase);22 WebResourceRoot resources = newStandardRoot(ctx);23 String base = new File("target/classes").getAbsolutePath();24 resources.addJarResources(new DirResourceSet(resources, "/WEB-INF/classes", base, "/"));25 ctx.setResources(resources);26 tomcat.start();27 tomcat.getServer().await();28 }29 }
启动后控制台输出如下,我们可以看到8080端口已经被监听:
"C:\Program Files\Java\jdk-11\bin\java.exe" -agentlib:jdwp=transport=dt_socket,address=127.0.0.1:51854,suspend=y,server=n -Dfile.encoding=UTF-8 -classpath ....
Connected to the target VM, address: '127.0.0.1:51854', transport: 'socket'
11月 15, 2024 10:47:54 上午 org.apache.coyote.AbstractProtocol init
信息: Initializing ProtocolHandler ["http-nio-8080"]
11月 15, 2024 10:47:54 上午 org.apache.catalina.core.StandardService startInternal
信息: Starting service [Tomcat]
11月 15, 2024 10:47:54 上午 org.apache.catalina.core.StandardEngine startInternal
信息: Starting Servlet engine: [Apache Tomcat/10.0.0]
11月 15, 2024 10:47:56 上午 org.apache.catalina.util.SessionIdGeneratorBase createSecureRandom
警告: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [1,753] milliseconds.
11月 15, 2024 10:47:56 上午 org.apache.coyote.AbstractProtocol start
信息: Starting ProtocolHandler ["http-nio-8080"]