Java EE Servlet之Servlet API详解

接下来我们来学习 Servlet API 里面的详细情况

1. HttpServlet

写一个 Servlet 代码，都是要继承这个类，重写里面的方法

Servlet 这里的代码，只需要继承 HttpServlet 就可以了，不必写一个 main 方法

因为在 tomcat 中是拥有 main 方法的，我们重写之后，tomcat 就可以调用到，就可以运行了

---

继承 HttpServlet 这个类，重写里面的方法，目的就是为了把自己定义的代码，“插入到” tomcat 中

这个时候 tomcat 就能自动的 new 出一个自己写的子类
执行到自己写的代码

进一步来说，就相当于，让自己写的代码“嵌入到” tomcat 中了
相当于在处理一次请求的过程中，tomcat 完成了 99% 的工作，剩下的 1% 有我们自己写

1.1 核心方法

这几个方法，都是可以在子类中重写的
在子类重写这些方法之后，这些方法也都是不需要手动调用的
都是 tomcat 在合适的时机自行调用

• init：通过这个方法，完成初始化操作
• destroy：用来释放资源
• service：都会使用到

这三个方法被调用的时期，就被称为 Servlet 的生命周期（经典面试题）

---

但是这三个方法实际开发中，很少使用，一般出现在面试题中

init 还是比较有用

service 一般会被 doGet/ doPosst 替代

destroy 这个方法，大概率执行不到
一个 Servlet 不用了，说明 Tomcat 要关闭了
Tomcat 关闭有两种方式

1. 直接干掉 Tomcat 进程 (比如直接在 任务管理器中 结束任务，或者直接点X)
   完全来不及调用 destroy
2. 通过 8005 管理端口，给 Tomcat 发送一个"停机”指令
   这个时候是能够执行 destroy 的

---

在写代码的时候，记得先把注释写上，否者容易忘记
注解这里的参数，吾必以 / 开头
而且确保一个路径中，多个 servlet 路径不能重复

2. HttpServletRequest

表示了一个 HTTP 请求

• getProtocol：版本号
• getRequestURI
  URI：唯一资源标识符（身份证号码）
  URL：唯一资源定位/地址符（住址）
• InputStream getInputStream
  通过这个方法，得到一个流对象
  读取这个流对象，就能得到一个请求的 body
  （很多时候，在代码中表示一个“不定长”的数据的时候，经常就会想到使用“流对象”）
  使用流对象，就允许我们不必一次性处理完，一次处理一点，但是也可以一次都处理完
  这样可以很好的兼容二进制

上述系列的方法，都是 get 系列的方法（都是 读 方法），没有 set 系列（没有 写 方法）
当前拿到的 HttpServletRequset，这里的数据都是来自客户端发来的，这些数据的内容已经定下来了，程序员是不应该修改的

正是因为框架做出了限制，避免了程序员不小心把发来的请求给改坏了

---

在 xml 中 /n 不能作为换行，起到换行效果的是

@WebServlet("/show")
public class ShowRequestServlet extends HttpServlet {
    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
        //调用上述 api, 把得到的结果构造成一个字符串, 统一返回给客户端
        StringBuilder stringBuilder = new StringBuilder();
        stringBuilder.append(req.getProtocol());
        stringBuilder.append("<br>");
        stringBuilder.append(req.getMethod());
        stringBuilder.append("<br>");
        stringBuilder.append(req.getRequestURI());
        stringBuilder.append("<br>");
        stringBuilder.append(req.getContextPath());
        stringBuilder.append("<br>");
        stringBuilder.append(req.getQueryString());
        stringBuilder.append("<br>");

        //获取所有的 header
        Enumeration<String> headerName = req.getHeaderNames();
        while (headerName.hasMoreElements()) {
            String key = headerName.nextElement();
            String value = req.getHeader(key);
            stringBuilder.append(key + ": " + value + "<br>");
        }

        //把上述内容整体返回到客户端这边
        resp.setContentType("text/html; charset=utf8");
        resp.getWriter().write(stringBuilder.toString());
    }
}

---

在服务器获取请求中的参数（Query String）

query string 中的键值对，都是程序员自定义的
实际开发中，都会非常广泛的使用到 query string 这样的机制

请求中，没有加上 query string，得到的结果就是空值

如果在后面加上 query string


前端输入的不同，查找的就会不同

那如果我写中文的呢？

虽然也是可以显示出正确的结果
但是最好要进行 urlencode
不进行 urlencode 可能有些浏览器/服务器无法正常处理

encode 之后的结果发到服务器这边，服务器也能自动的进行 urldecode

---

除了 query string 之外，还可以通过 http 请求的 body 来传递参数（POST）

1. 直接通过 form 表单
   （body 的格式就是 query string 的格式）
   Content-Type: application/x-www-form-urlencoded
   
   
   

---

2. 直接使用 json
   （body 的格式就是 json）
   Content-Type: application/json
   上面两种方式，都是 Servlet 天然支持的
   但是 json Servlet 自身不支持，需要引入额外的第三方库

json 本质上也是键值对
规则和 form 表单截然不同
解析方式自然也就变了
由于 json 支持“嵌套”（某个 key 的 value 也可以是另一个 json）
因此自己手写解析 json 的代码，并不容易
这里我们就用第三方库，比如 Jackson

1）下载导入 Jackson 到项目中，通过 maven

2）使用 Jackson
一个类，两个方法
ObjectMapper
对象 映射
把 json 字符创，映射成一个 java 对象（read 方法）
把一个 java 对象，映射成 json 字符串（write 方法）

网络传输，使用 json 字符串
java 代码中各种逻辑，使用 java 对象

咱在服务器的角度，收到的请求，就是 json 字符串
就需要把 json 字符串，先映射成 java 对象
在进行一系列的业务逻辑处理

处理完了之后，可能还需要把得到的 java 对象，映射回 json 字符串，并且通过响应来返回



objectMapper.readValue，核心工作，就是把第一张图的 json 字符串，映射成第二张图的 java 对象

参数就是 json 字符串（json 字符串是在 http 的 body 中，就需要通过 HttpServletRequest 中的 getInputStream 来获取）
此处把这个留兑现郭志杰传送给 readValue，readValue 内部机会读取 InputStream 中的所有数据（http 请求的 body，上面的 json 字符串）

按照json 的格式，进行解析，把 json 字符串，解析成 Map（键值对）

把 Map 转换成 java 对象
在方法的第二个阐述，传入 Reque.class
告诉 readValue 方法内部，要把当前的 Map 转成啥样的 java 对象

readValue 内部，就可以通过反射 api，创建出 Request.class 实例
并且，根据 Request.class 提供的属性的名字，来查询上述 Map，把得到的结果，赋值给对应的属性

这个代码就是 readValue 的反向操作
就能把 java 代码映射成 json 字符串

通过传入的参数,获取到类对象,通过反射拿到都有哪些属性
就有一个属性,ok

根据属性的名字拿到属性的值
拿到了值 true

把上述 属性名字 和 属性值 按照 json 格式构造成字符串就是返回值
形如:" ok: true }

postman 对于json 格式要求比较严格
key 必须加上引号
(但是比如前端的 ajax 这里就可以不加引号)

---

这三种方式，本质上是等价的，都是把键值对数据交个服务器
只不过具体使用哪种凡是，更多的是看个人习惯和公司要求

3. HttpServletResponse

• setHeader：覆盖旧的值

• addHeader 不覆盖，并列添加新的值
  （对于 header 来说，允许存在多个相同的 key）

• PrintWriter getWriter

• OutputStream getOutputStream
  这两个相应的 body 也是通过流对象来进行体现的
  此处是写入，要使用输出流

response 里的 api 都是 set 系列的方法
request 里的 api 都是 write 系列的方法

---

设置状态码

这里改成 404 之后，发现页面是空的，是不太友好的

接下来，我们使用 sendError

---

自动刷新

通过 setHeader 给响应中设置一些特殊的 header
比如们可以设置 refresh，让浏览器自动刷新

---

重定向

1. 状态码 是 3xx（比如 302）
2. header 需要有一个 Location 属性，表示要跳转到哪里

这样也可以跳转到网页