Java Web简明教程–Servlet篇[1]–手（首）写Servlet

2021-09-23 02:09:39

OK，最近有点忙，哈哈，今天就从一个观察者的视角来实现一个手写的Servlet，手写的特点是麻烦，好处是能知道这玩意是从哪来的——便于理解。PS：所谓观察者视角，就是不站立场，观察双方，双方就是网站的使用者和网站开发者两方了。


好的，大体分为以下几步吧：


1，网站用户访问网址

2，网站接受用户访问请求，并将该请求交给一个Servlet处理

3，我们来写这个Servlet，响应用户请求

为了更加直接的体现的Servlet实现的网页是动态的，功能是比单纯html网页牛X的，我们实现一个显示当前时间的功能，用户的每次请求都会返回当前的时间，都是不同的。


第一步，首先我们建一个新的Web Project（之前一直用WebSiteFirst也是够了），因为是学习Servlet用的，就起名叫ServeltDemo。然后我们建一个servlet包用来放置所有的Servlet类。如图：


第二步，我们在WebRoot下面建立一个visitDemo.html文件用来演示使用网址访问html文件，编辑visitDemo内容如下：

<!DOCTYPE html>
<html>
  <head>
    <title>visitDemo.html</title>
  </head>
  <body>
  <!-- 这里是注释，我们很容易就发现，静态的html页面内容是固定，很难实现动态的当前时间输出 -->
    现在的年份是2017年<br>
  </body>
</html>

我们部署该网站到Tomcat上，然后启动Tomcat（这个过程如果都不熟，烦请看下猫哥以前的文字），打开浏览器，在地址栏输入：

http://127.0.0.1:8080/ServletDemo/visitDemo.html 那么毫无疑问，我们希望看到的内容就显示在网页了。


此处一定要注意网页部署在Tomcat下的意义，网址中的127.0.0.1表示的是本机地址，如果我们的计算机是联网的，那么在别的计算机上，将127.0.0.1改为我们使用的计算机地址，一样能访问到这个网页，这说明Tomcat在监听8080端口，然后将用户的访问请求理解、处理后返回。


第三步，那么Servlet其实跟html根本原理一样的，Tomcat也是根据用户访问的请求来调用响应的Servlet处理后返回响应结果。现在用户请求一个返回当前时间的Servlet，请求地址为：http://127.0.0.1:8080/ServletDemo/TimeServlet。这个请求发送到127.0.0.1机器的8080端口，也就是本机的Tomcat服务器监听的端口，然后发送到了ServletDemo这个网站，然后是要请求ServletDemo这个网站的/TimeServlet。这时候我们的网站服务器就发现啊，这个请求不是网页啊，网页应该是XXX.html。所以重点来了，这时候网站服务器就去一个叫做web.xml文件中寻找帮助。


第四步，那么这个web.xml干嘛的呢，其实就是个配置文件，能保存访问请求和我们Servlet类之间的映射。通俗的说，就是刚刚这个/TimeServlet请求对应到我们网站的哪个Servlet类处理，就是由web.xml配置的。讲到此处，其实所有的谜底都已经揭开了，用户访问网址http://127.0.0.1:8080/ServletDemo/TimeServlet，ServletDemo项目根据web.xml找到/TimeServlet请求对应的Servlet处理，完事。


第五步，那么web.xml怎么写，很简单，就是一个固定的模版样式如下，需要注意的是web.xml文件要放在WebRoot目录的WEB-INF文件夹下才自动生效，至于为啥是这目录，问Tomcat设计者去：

<?xml version="1.0" encoding="UTF-8"?><!-- 此处是注释，该行表明这是一个xml文件，使用UTF-8编码，固定格式，不用记 -->
<!-- web-app标签固定的，不用记 -->
<web-app version="3.0"
    xmlns="http://java.sun.com/xml/ns/javaee"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd">
  <servlet>
    <servlet-name>MyTimeServletName</servlet-name><!-- 这是servlet的名字 -->
    <servlet-class>servlet.MyTimeServlet</servlet-class><!-- 这是对应的Java类 -->
  </servlet>
  <servlet-mapping>
    <servlet-name>MyTimeServletName</servlet-name><!-- 这是servlet的名字，跟前面那个名字是对应的 -->
    <url-pattern>/TimeServlet</url-pattern><!-- 这是匹配的用户请求，此处应为/TimeServlet -->
  </servlet-mapping>
</web-app>

需要注意，一个Servlet的定义是由两部分构成的<serlvet>标签保存名字和Java类，servlet-mapping标签保存同样的名字和用户请求样式。此处猫哥定义类名为MyTimeServlet，名字为MyTimeServletName是故意弄了不一样的名字以便于看官区分的。


第六步，到了此处，服务器根据web.xml配置知道了——“哦，用户请求/TimeServlet应该是由servlet.MyTimeServlet，也就是serlvet包下的MyTimeServlet类处理”，现在我们就在servlet包下建立一个名为MyTimeServlet的类，代码如下：

package servlet;
public class MyTimeServlet {

}

OK，类建好了，服务器也将响应/TimeServlet响应这个光荣的使命交给了MyTimeServlet类处理，但是这个类能干的了这个活吗。我们重新部署项目后重启Tomcat，然后在浏览器地址栏输入：http://127.0.0.1:8080/ServletDemo/TimeServlet，显示如下页面：

Java Web简明教程–Servlet篇[1]–手（首）写Servlet


我们看Message一栏提示:Class servlet.MyTimeServlet is not a Servlet，猫哥发挥自己英语X级的能力给您翻译下：有一个类，是servlet.MyTimeServlet，它啊，不是一个纯种的Servlet。啥意思啊，很简单，它披羊皮卖狗肉呢。它根本就不是一个司机，开什么火车啊，开的了吗？

也就是说MyTimeServlet 根本就干不了响应用户http请求的活，谁干的了啊？当然是HttpServlet啦，Java语言中干这个活最好的，赶紧去认干爹吧，认了干爹好干活。


第七步，认干爹，学本领。继承HttpServlet。代码如下:

package servlet;
import javax.servlet.http.*;//导入HttpServlet所在的包
public class MyTimeServlet extends HttpServlet{//继承HttpServlet类

}

OK，重新部署、启动Tomcat之后再试，哎，这下提示信息就变了呢。如下：


message HTTP method GET is not supported by this URL

1

猫哥再次发挥自己牛X的英文技能，翻译为：提示：HTTP请求有个方法叫GET，它啊，不是被这个URL地址支持。也就是说，我们这个Servlet不支持Get方法， Get方法不就是一个叫Get的办事方法嘛，它干爹HttpServlet就会干。


第八部，在MyTimeServlet编辑区域点右键，选择【Source】-【Override/Implement Methods】。选中其中的doGet方法。代码如下：

package servlet;
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.*;//导入HttpServlet所在的包
public class MyTimeServlet extends HttpServlet{//继承HttpServlet类
    /**
     * doGet方法就是用来处理Get类型的网页请求的
     */
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {

        super.doGet(req, resp);
    }
}

好的，猫哥也不再兜圈子了，直接在这个方法里实现我们需要的功能如下：

package servlet;
import java.io.IOException;
import java.io.PrintWriter;
import java.util.Date;
import javax.servlet.ServletException;
import javax.servlet.http.*;//导入HttpServlet所在的包
public class MyTimeServlet extends HttpServlet{//继承HttpServlet类
    /**
     * doGet方法就是用来处理Get类型的网页请求的
     */
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp)
            throws ServletException, IOException {
        resp.setContentType("text/html");//设置输出的类型
        PrintWriter out=resp.getWriter();//out对象是用于向网页输出内容的对象
        out.print(new Date().toString());//输出的内容为：当前时间
        out.flush();//立刻输出
        out.close();//使用完了关闭
    }
}
上一篇：Redis事务和锁机制


下一篇：【Java8新特性】接口中的默认方法和静态方法，你都掌握了吗？