javaWEB之Servlet

Servlet

1. 什么是Servlet
  * Servlet是JavaWeb三大组件之一（Servlet、Filter、Listener）
  * Servlet是用来处理客户端请求的动态资源
  * Servlet的任务有：
    > 获取请求数据
    > 处理请求
    > 完成响应
  * Servlet接口方法：
    > void init(ServletConfig)
    > void service(ServletRequest,ServletResponse)
    > void destory()
    > ServletConfig getServletConfig()
    > String getServletInfo()

2. 实现Servlet的方式
  * 实现Servlet接口（不方便）
  * 继承GenericServlet类（不方便）
  * 继承HttpServlet类（方便）

3. Servlet第一例
  * 写一个类cn.itcast.MyServlet，实现Servlet接口
  * 实现service()方法，在其中给出System.out.println("hello servlet!");
  * 在web.xml文件中指定Servlet的访问路径为：/myservlet

<servlet>
  <servlet-name>xxx</servlet-name>
  <servlet-class>cn.itcast.MyServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>xxx</servlet-name>
  <url-pattern>/myservlet</url-pattern>
</servlet-mapping>

当用户在地址栏中访问：http://localhost:8080/day04_1/myservlet时，会执行System.out.println("hello servlet!");

-------------------------------------------------------------------------------------------------------------------------------------

Servlet生命周期

Servlet接口一共5个方法，但其中只有三个是生命周期方法：
  * void init(ServletConfig)
  * void service(ServletRequest,ServletResponse)
  * void destory()

1). 服务器创建Servlet：
  * 当Servlet第一次被请求时，或服务器启动时，服务器会创建Servlet实例。
  * 服务器默认是在servlet第一次被请求时创建Servlet实例，如果希望服务器启动时就创建Servlet实现需要在web.xml中配置
  * 服务器只为一个类型的Servlet创建一个实例对象，所以Servlet是单例的；

  2). 服务器初始化Servlet：
  * 当服务器创建Servlet实例后会马上调用Servlet的init(ServletConfig)方法，完成对Servlet的初始化；
  * init(ServletConfig)只会被调用一次
  * 服务器会在调用init()方法时传递ServletConfig参数
 
  3). 服务器使用Servlet处理请求：
  * 当Servlet被请求时，服务器会调用Servlet的service(ServletRequest,ServletResponse)方法
  * service(ServletRequest,ServletResponse)方法每处理一次请求，就会被调用一次，所以它可能会被调用N次
  * 因为Servlet是单例的，所以可能在同一时刻一个Servlet对象会被多个请求同时访问，所以这可能出现线程案例问题
  * Servlet不是线程案例的，这有助与提高效率，但不能让Servlet具有状态，以免多个线程争抢数据

  4). 服务器销毁Servlet
  * 服务器通常不会销毁Servlet，通常只有在服务器关闭时才会销毁Servlet
  * 服务器会在销毁Servlet之前调用Servlet的destory()方法
  * 可以在destory()方法中给出释放Servlet占有的资源，但通常Servlet是没什么可要释放的，所以该方法一般都是空的

ServletConfig

  ServletConfig是Servlet中的init()方法的参数类型，服务器会在调用init()方法时传递ServletConfig对象给init()方法。
  ServletConfig对象封装了Servlet在web.xml中的配置信息，它对应<servlet>元素。ServletConfig类的功能有：

   String getServletName()；//获取Servlet配置名，即<servlet-name>的值；
   ServletContext getServletContext()；//获取ServletContext对象，这个对象稍后介绍
   String getInitParameter(String name)；//获取初始化参数
   Enumeration getInitParameterNames()；//获取所有初始化参数的名称

在web.xml文件中，配置<servlet>时可以为<servlet>配置0~N个初始化参数，例如：

<servlet>
  <servlet-name>xxx</servlet-name>
  <servlet-class>cn.itcast.servlet.MyServlet</servlet-class>
<!--设置初始化参数1  -->
  <init-param>
    <param-name>p1</param-name>
    <param-value>v1</param-value>
  </init-param>

<!--设置初始化参数2  -->
  <init-param>
    <param-name>p2</param-name>
    <param-value>v2</param-value>
  </init-param>
</servlet>

-------------------------------------------------------------------------------------------------------------------------------------

GenericServlet

  GenericServlet是Servlet接口的实现类，但它是一个抽象类，它唯一的抽象方法就是service()方法
  GenericServlet实现了Servlet方法：
  * 实现了String getServletInfo()方法
  * 实现了void destory()方法，空实现
  * 实现了void init(ServletConfig)方法，用来保存ServletConfig参数
  * 实现了ServletConfig getServletConfig()方法

  GenericServlet实现了ServletConfig接口：
  * 实现了ServletContext getServletContext()方法
  * 实现了String getInitParameter()方法
  * 实现了String getServletName()方法
  * 实现了Enumeration getInitParameterNames()方法

GenericServlet添加了init()方法：
  * 该方法会被init(ServletConfig)方法调用
  * 如果希望对Servlet进行初始化，那么应该覆盖init()方法，而不是init(ServletConfig)方法

-------------------------------------------------------------------------------------------------------------------------------------

HttpServlet
 
  HttpServlet是GenericServlet的子类，它专注HTTP请求
  HttpServlet类的方法：
  * 实现了void service(ServletRequest,ServletResponse)方法，实现内容是：
    > 把ServletRequest强转成HttpServletRequest
    > 把ServletResponse强转成HttpServletResponse
    > 调用本类添加的void service(HttpServletRequest,HttpServletResponse)方法
  * 添加了void service(HttpServletRequest,HttpServletResponse)方法，内容是：
    > 调用request的getMethod()获取请求方式
    > 如果请求方式为GET，那么调用本类添加的doGet(HttpServletRequest,HttpServletResponse)方法
    > 如果请求方式为POST，那么调用本类添加的doPost(HttpServletRequest,HttpServletResponse)方法

  doGet(HttpServletRequest,HttpServletResponse)// 添加doGet方法，内容是响应405，表示错误，所以我们应该去覆盖这个方法
  doPost(HttpServletRequest,HttpServletResponse)// 添加doPost方法，内容是响应405，表示错误，所以我们应用去覆盖这个方法

　如果是通过继承HttpServlet类来自定义Sevlet的话，那么：

 // 不要去覆盖void service(ServletRequest,ServletResponse)
  // 不要去覆盖void service(HttpServletRequest, HttpServletResponse)
  //而应该去覆盖doGet()或doPost()方法。

-------------------------------------------------------------------------------------------------------------------------------------

<url-pattern>

<url-pattern>是<servlet-mapping>的子元素，用来绑定Servlet的访问路径
  可以在一个<servlet-mapping>中给出多个<url-pattern>，也就是说一个Servlet可以有多个访问路径：

 <servlet-mapping>
    <servlet-name>xxx</servlet-name>
    <url-pattern>/helo1<url-pattern>
    <url-pattern>/hello2<url-pattern>
  </servlet-mapping>

还可以在<url-pattern>中使用通配符，即“*”。

  <url-pattern>/*<url-pattern><!--表示匹配任何路径  -->
  <url-pattern>/do/*<url-pattern><!--表示匹配以/do开头的任何路径  -->
  <url-pattern>*.do<url-pattern><!--表示匹配任何以“.do”结尾的路径  -->

注意：
  * 通配符要么在开头，要么在结尾，不能在中间，例如：/*.do就是错误的使用。
  * 如果不使用通配符，那么<url-pattern>必须以“/”开头，例如：<url-pattern>abc</url-pattern>就是错误的

-------------------------------------------------------------------------------------------------------------------------------------

ServletContext
 
  ServletContext是Servlet三大域对象之一
  ServletContext在服务器启动时创建，在服务器关闭时销毁，一个JavaWeb应用只创建一个ServletContext对象
 
1. 它的功能分类：
  * 存取数据
  * 读取web.xml中的应用初始化参数
  * 读取应用资源

2. 获取ServletContext对象
  在HttpServlet中可以通过以下方法来获取ServletContext对象

 ServletContext sc = this.getServletContext()；
 ServletContext sc = this.getServletConfig().getServletContext()；

2. 存取数据
  因为在一个JavaWeb应用中，只有一个ServletContext对象，所以在ServletContext中保存的数据可以共整个JavaWeb应用中的动态资源共享
  ServletContext是Servlet三大域对象之一，域对象内部有一个Map，用来保存数据

   servletContext.setAttribute("xxx", "XXXX")；//覆盖添加域数据，如果在域中已经存在数据，则覆盖
   Object getAttribute(String name)；//通过名称来获取域数据
   void removeAttribute(String name)；//通过名称移除域数据
   Enumeration<String> getAttributeNames()；//获取所有ServletContext域数据的名称

3. 读取web.xml中配置的应用初始化参数

  <context-param>
    <param-name>p1</param-name>
    <param-value>v1</param-value>
  </context-param>
  <context-param>
    <param-name>p2</param-name>
    <param-value>v2</param-value>
  </context-param>

  servletContext.getInitParameter("p1")；//返回v1
  servletContext.getInitParameter("p2")；//返回v2
  servletContext.getInitParameterNames()；//返回Enumeration<String>，包含p1和p2

4. 获取项目资源
  * String getRealPath(String path)：获取资源的真实名称

  String path = servletContext.getRealPath("/WEB-INF/a.jpg");

返回值为/WEB-INF/a.jpg真实路径，即磁盘路径：C:/tomcat6/wabapps/hello/WEB-INF/a.jpg

  InputStream getResourceAsStream(String path)：//获取资源的输入流
  InputStream in = servletContext.getResourceAsStream("/WEB-INF/a.jpg");

返回的是a.jpg的输入流对象，可以从流中得到a.jpg的数据

  Set<String> getResourcePaths(String path)：//获取指定目录下的所有资源路径
  Set<String> paths = servletContext.getResourcePaths("/WEB-INF");

返回的Set中包含如下字符串：
    > /WEB-INF/lib/
    > /WEB-INF/classes/
    > /WEB-INF/web.xml
    > /WEB-INF/a.jpg

-------------------------------------------------------------------------------------------------------------------------------------

获取类路径资源

  可以通过Class类的对象来获取类路径下的资源，对应JavaWeb应用的类路径就是classes目录下的资源
  例如：

//获取的是：/WEB-INF/classes/cn/itcast/servlet/a.jpg，即与MyServlet.class同目录下的资源
InputStream in = cn.itcast.servlet.MyServlet.class.getResourceAsStream("a.jpg");

例如：

//获取的是：/WEB-INF/classes/a.jpg，即类路径的根目录下的资源，类路径的根目录就是/classes目录
  InputStream in = cn.itcast.servlet.MyServlet.class.getResourceAsStream("/a.jpg");