Java 网络编程-

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文件：

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>

<groupId>org.example</groupId>
<artifactId>PureJaveServlet</artifactId>
<version>1.0-SNAPSHOT</version>
<name>PureJaveServlet</name>
<packaging>war</packaging>

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

<dependencies>
    <dependency>
        <groupId>jakarta.servlet</groupId>
        <artifactId>jakarta.servlet-api</artifactId>
        <version>5.0.0</version>
        <scope>provided</scope>
    </dependency>

    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
        <version>1.18.30</version>
    </dependency>
    <dependency>
        <groupId>org.apache.commons</groupId>
        <artifactId>commons-lang3</artifactId>
        <version>3.13.0</version>
    </dependency>
    <!-- http客户端 -->
    <!-- fastjson -->
    <dependency>
        <groupId>com.alibaba</groupId>
        <artifactId>fastjson</artifactId>
        <version>1.2.83</version>
    </dependency>


    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.10.0</version>
    </dependency>
    <dependency>
        <groupId>io.pebbletemplates</groupId>
        <artifactId>pebble</artifactId>
        <version>3.1.6</version>
    </dependency>
    <dependency>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-compiler-plugin</artifactId>
        <version>3.10.1</version>
    </dependency>

</dependencies>

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>3.3.2</version>
        </plugin>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <configuration>
                <compilerArgs>
                    <arg>-parameters</arg>
                </compilerArgs>
            </configuration>
        </plugin>
    </plugins>
</build>
</project>

 

Servlet类

package org.example;


import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.io.PrintWriter;


@WebServlet(urlPatterns = "/nihao")
public class HiServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws  IOException {
        String name = req.getParameter("name");
        resp.setContentType("text/html");
        PrintWriter out = resp.getWriter();
        out.println("<html><body>");
        out.println(String.format("<h1>Hello, %s </h1>", name));
        out.println("</body></html>");
        out.flush();
    }
}

 

package org.example;

import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.io.PrintWriter;

/**
 * @discription
 */
@WebServlet(urlPatterns = "/bye")
public class ByeServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws IOException {
        String name = req.getParameter("name");
        resp.setContentType("text/html");
        PrintWriter out = resp.getWriter();
        out.println("<html><body>");
        out.println(String.format("<h1>bye bye, %s </h1>", name));
        out.println("</body></html>");
        out.flush();
    }
}

代码部分就结束了，我们观察代码可以发现两点：
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文件

<?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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>demotom</artifactId>
    <version>1.0-SNAPSHOT</version>
    <name>demotom</name>
    <packaging>war</packaging>

    <properties>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <maven.compiler.target>11</maven.compiler.target>
        <maven.compiler.source>11</maven.compiler.source>
        <tomcat.version>10.0.0</tomcat.version>
    </properties>

    <dependencies>


        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-core</artifactId>
            <version>${tomcat.version}</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>org.apache.tomcat.embed</groupId>
            <artifactId>tomcat-embed-jasper</artifactId>
            <version>${tomcat.version}</version>
            <scope>provided</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>3.3.2</version>
            </plugin>
        </plugins>
    </build>
</project>

主类：

package com.example.demotom;

import org.apache.catalina.Context;
import org.apache.catalina.LifecycleException;
import org.apache.catalina.WebResourceRoot;
import org.apache.catalina.startup.Tomcat;
import org.apache.catalina.webresources.DirResourceSet;
import org.apache.catalina.webresources.StandardRoot;

import java.io.File;

/**
 * @discription
 */
public class TomMain {
    public static void main(String[] args) throws LifecycleException {
        Tomcat tomcat = new Tomcat();
        tomcat.setPort(Integer.getInteger("port", 8080));
        tomcat.getConnector();
        String docBase = new File("src/main/webapp").getAbsolutePath();
        Context ctx = tomcat.addContext("", docBase);
        WebResourceRoot resources = new StandardRoot(ctx);
        String base = new File("target/classes").getAbsolutePath();
        resources.addJarResources(new DirResourceSet(resources, "/WEB-INF/classes", base, "/"));
        ctx.setResources(resources);
        tomcat.start();
        tomcat.getServer().await();
    }
}

启动后控制台输出如下，我们可以看到8080端口已经被监听：

"C:Program FilesJavajdk-11injava.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"]