Java 网络编程----初探Servlet
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 <project xmlns="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 package org.example; 2 3 4 import jakarta.servlet.ServletException; 5 import jakarta.servlet.annotation.WebServlet; 6 import jakarta.servlet.http.HttpServlet; 7 import jakarta.servlet.http.HttpServletRequest; 8 import jakarta.servlet.http.HttpServletResponse; 9 10 import java.io.IOException; 11 import java.io.PrintWriter; 12 13 14 @WebServlet(urlPatterns = "/nihao") 15 public class HiServlet extends HttpServlet { 16 @Override 17 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException { 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 package org.example; 2 3 import jakarta.servlet.annotation.WebServlet; 4 import jakarta.servlet.http.HttpServlet; 5 import jakarta.servlet.http.HttpServletRequest; 6 import jakarta.servlet.http.HttpServletResponse; 7 8 import java.io.IOException; 9 import java.io.PrintWriter; 10 11 /** 12 * @discription 13 */ 14 @WebServlet(urlPatterns = "/bye") 15 public class ByeServlet extends HttpServlet { 16 @Override 17 protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException { 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 <project xmlns="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 package com.example.demotom; 2 3 import org.apache.catalina.Context; 4 import org.apache.catalina.LifecycleException; 5 import org.apache.catalina.WebResourceRoot; 6 import org.apache.catalina.startup.Tomcat; 7 import org.apache.catalina.webresources.DirResourceSet; 8 import org.apache.catalina.webresources.StandardRoot; 9 10 import java.io.File; 11 12 /** 13 * @discription 14 */ 15 public class TomMain { 16 public static void main(String[] args) throws LifecycleException { 17 Tomcat tomcat = new Tomcat(); 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 = new StandardRoot(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"]
如果你觉得写的不错,欢迎转载和点赞。 转载时请保留作者署名jilodream/王若伊_恩赐解脱(博客链接:http://www.cnblogs.com/jilodream/