ServletContext接口

ServletContext接口的简述：public interface ServletContext 定义了一系列方法用于与相应的servlet容器通信，比如：获得文件的MIME类型，分派请求，或者是向日志文件写日志等。每一个web-app只能有一个ServletContext，web-app可以是一个放置有web application 文件的文件夹，也可以是一个.war的文件。 ServletContext对象包含在ServletConfig对象之中，ServletConfig对象在servlet初始化时提供servlet对象。 getContext()方法概述：public ServletContext getContext(java.lang.String uripath) 返回一个指定URL地址的ServletContext对象。该方法允许servlets获得对服务器的各部分上下文的访问权，并根据需要从上下文获得RequestDispatcher对象。这个指定的URL路径必须带有"/"，被解释为服务器文档根目录下的相对路径，并跟其它web-app主机的上下文根目录匹配。在一个安全的环境下，servlet容器会返回null。 getMajorVersion()方法概述：public int getMajorVersion() 返回servlet容器支持的Servlet API的版本号，所有实现都必须返回整型数2。 getMinorVersion()方法略。 getMimeType()方法概述：public java.lang.String getMimeType(java.lang.String file) 返回指定文件的文件类型，如果文件类型未知，则返回null。文件类型由servlet容器的配置决定并在一个web-app中被指定。一般情况下的文件类型是："text/html" 和"image/gif"。 getResourcePaths()方法概述：public java.util.Set getResourcePaths(java.lang.String path) 返回一个存储web-app中所有资源路径的Set（集合）。路径以”/"结尾表示一个子目录，并以"/"开头表示一个对于web-app的相对路径。 例子： /welcome.html /catalog/index.html /catalog/products.html /catalog/offers/books.html /catalog/offers/music.html /customer/login.jsp /WEB-INF/web.xml /WEB-INF/classes/com.acme.OrderServlet.class, getResourcePaths("/") 将返回Set {"/welcome.html", "/catalog/", "/customer/", "/WEB-INF/"}； getResourcePaths("/catalog/") 将返回Set {"/catalog/index.html", "/catalog/products.html", "/catalog/offers/"}。 如果子目录为空，返回null。 getResource()方法概述：public java.net.URL getResource(java.lang.String path) throws java.net.MalformedURLException 返回由path指定的资源路径对应的一个URL对象，该path必须以“/"开头并作为当前目录的相对位置。该方法允许servlet容器使serlets中的一个资源变为可用。该资源允许是一个本地资源或者是一个远程文件系统，这些资源可以在数据库中，或者在一个.war文件中。 servlet容器必须实现URL句柄和URLCOnnection对象，这些对象对于资源访问是必需的。如果没有匹配的资源，该方法返回null。某些容器甚至可以向该方法所返回的资源写数据。这个资源可以直接返回，所以请求一个a.jsp文件将返回JSP源文件。用一个RequestDispatcher对象取而代之，可以包含执行的结果。这个方法功能有别于java.lang.Class.getResource，一个基于class loader检索资源的方法。但前者不依赖于class loaders。 getResourceAsStream()方法概述：public java.io.InputStream getResourceAsStream(java.lang.String path) 返回一个由String path指定位置资源的InputStream。返回的InputStream可以是任意类型和长度的。 getRequestDispatcher()方法概述：public RequestDispatcher getRequestDispatcher(java.lang.String path) 返回一个RequestDispatcher对象，该对象扮演着一个给定资源包装者的角色。一个RequestDispatcher对象可以用于传送一个请求到特定资源或者把特定资源包含到一个响应当中。该特定资源可以是动态的也可以是静态的。通过getContext()方法可以为外部contexts资源获取RequestDispatcher对象。如果ServletContext不能获取RequestDispatcher对象，返回null。 getNamedDispatcher()方法概述：public RequestDispatcher getNamedDispatcher(java.lang.String name) 为指定名字的servlet对象返回一个RequestDispatcher对象。Servlet和JSP页面可以通过服务器管理或web application deployment descriptor被命名。一个Servlet实例的名称可以由ServletConfig.getServletName()决定。 getServlet()方法、getServlets()方法、getServletNames()方法，不推荐使用。 log(java.lang.String msg)方法概述：public void log(java.lang.String msg) 把指定的信息写进servlet日志文件，通常是事物日志。日志文件的名称和类型与servlet容器有关。 public void log(java.lang.Exception exception,java.lang.String msg) 略 public void log(java.lang.String message,java.lang.Throwable throwable) 略 getRealPath()方法概述：public java.lang.String getRealPath(java.lang.String path) 返回一个指定虚拟路径的真实路径（完整路径）的字符串。举例：虚拟路径"/index.html"将返回服务器文件系统中的绝对路径"http://host/contextPath/index.html", 当中的contextPath是ServletContext的上下文路径。返回的路径将适用于servlet容器所运行的操作系统。假如无法把虚拟路径映射为真实路径，该方法将返回null。（比如当路径指定的内容是源于.war文件） getServerInfo()方法概述：public java.lang.String getServerInfo() 返回servlet容器的名称和版本号。返回的字符串格式是servername/versionnumber（服务器名/版本号），例如：the JavaServer Web Development Kit 将返回字符串”JavaServer Web Dev Kit/1.0”。 servlet容器还将返回其它可选信息，如：“JavaServer Web Dev Kit/1.0 (JDK 1.1.6; Windows NT 4.0 x86)” getInitParameter()方法概述：public java.lang.String getInitParameter(java.lang.String name) 返回上下文定义的变量的值，如果变量不存在，返回null。见ServletConfig.getInitParameter(java.lang.String)。 getInitParameterNames()方法概述：public java.util.Enumeration getInitParameterNames() 返回上下文定义的所以变量的枚举函数，如果空则返回空枚举函数。 getAttribute()方法概述：public java.lang.Object getAttribute(java.lang.String name) 返回指定名字的servlet容器变量值，如果无该变量则返回null。 getAttributeNames()方法概述：public java.util.Enumeration getAttributeNames() 返回servlet容器的所有变量的枚举函数，如果空则返回空枚举函数。 setAttribute()方法概述：public void setAttribute(java.lang.String name,java.lang.Object object) 在servlet容器内绑定一个指定对象给一个指定的名字。如果该名字已经绑定到一个对象，则用该对象覆盖之。 If listeners are configured on the ServletContext the container notifies them accordingly. （不会翻译，求助）如果传递一个null值，则相当于调用removeAttribute()。 removeAttribute()方法概述：public void removeAttribute(java.lang.String name) 移除指定名字的servlet容器变量。 getServletContextName()方法概述：public java.lang.String getServletContextName() 返回web application的名字。 最后，见Servlet.getServletConfig(), ServletConfig.getServletContext() 〔StartupServlet.java〕 /* * @class: StartupServlet * @version: 1.0 * @Date: 2004/12/16 15:51:40 */ package com.chinacreator.ac.javabean.servlet; import javax.servlet.*; import javax.servlet.http.*; import java.io.*; import java.net.*; import com.chinacreator.tousu.application.*; import com.chinacreator.tousu.application.ApplicationDocument.*; import com.chinacreator.ac.javabean.log.*; import com.chinacreator.ac.javabean.util.*; import com.chinacreator.ac.javabean.servlet.*; /** * *

Title: StartupServlet

*

Description: 启动加载的servlet类

*

Copyright: Copyright (c) 2004

*

Company: chinacreator

* @author hui.deng * @version 1.0 * @see */ public class StartupServlet extends HttpServlet { private static final Log log = new Log(StartupServlet.class); private ApplicationDocument document = null; //Initialize global variables public void init() throws ServletException { ServletContext application = this.getServletContext(); AccessControlFacade facade = new AccessControlFacade(); DictionaryProcessor dictionaryProcessor = facade.getAllDictionariesWrapper(); /** * 存入字典 * @param dictionaryProcessor 字典处理器 */ application.setAttribute(Constant.DICTIONARY_OBJECT_NAME, dictionaryProcessor); } } 〔web.xml〕 startupservlet com.chinacreator.ac.javabean.servlet.StartupServlet 10 startupservlet /startup 〔get.jsp〕 /** * 取出字典 * @return Object 字典处理器 */ public Object getDictionaryProcessor() { return application.getAttribute(Constant.DICTIONARY_OBJECT_NAME); }

 

 

   对于web容器来说，ServletContext接口定义了一个servlet环境对象，这个对象定义了一个在servlet引擎上的servlet的视图。通过使用这个对象，servlet可以记录事件，得到资源并得到来自servlet的引擎类。
servlet容器在启动时会加载web应用，并为每个web应用创建唯一的servlet context对象，可以把ServletContext看成是一个Web应用的服务器端组件的共享内存，在ServletContext中可以存放共享数据，他提供了4个读取和设置共享数据的方法。具体见api帮助文档。
    另外，ServletContext对象只在web应用被关闭的时候才被销毁，不同的web应用，ServletContext各自独立存在。
    一个web应用由jsp,servlet，javabean等web组件的集合构成，每一个web应用，容器都会有一个背景对象，而javax.servlet.ServletContext接口就提供了访问这个背景对象的途径。你可以通过一个servlet实例的getServletContext()方法得到该servlet运行其中的这个背景对象，从这个背景对象中你可以访问如下信息资源：
1.初始化参数
2.存储在背景中的对象
3.与背景关联的资源
4.日志
最后针对ServletContext我自己的总结是：
ServletContext即servlet容器，其内提供的方法可以在同一web应用下的所有servlet中被使用

而对于config对象来说，他与context相比，就有了很大的局限性。
当ServletConfig对象在servlet中被实例化后，对任何客户端在任何时候访问有效。但是一个servlet的ServletConfig对象不能被另一个servlet访问，也就是说，在本servlet声明后的ServletConfig只能在本servlet内被访问，属于内部持久有效的变量。

下有一例，可供深刻理解：

一般来说，对整个应用的配置，为了不使用“硬编码”，应该配置为ServletContext参数，比如字
符集设定。
<web-app>
.................
<init-param>
<param-name>charset</param-name> 
<param-value>GB2312</param-value> 
</init-param>
.................
</web-app>
注意以上格式只是2。0以后的标准格式，旧容器（引擎）采用服务商自己的格式配置。注意它的
父元素应该是<web-app>也就是说它是对一个应用作用的。

而如果只有一个特定的servlet要设定的参数，其它servlet不能共享，应该配置为ServletConfig
参数，如一个读取附件的servlet要用到绝对目录，而别的servlet不会用到：
<servlet>
<servlet-name>GetAtt</servlet-name>
<servlet-class>mail.GetAttServlet</servlet-class>
<init-param>
<param-name>absPath</param-name> 
<param-value>/usr/mail/ax/axman/Maildir/</param-value> 
</init-param>
</servlet>
不用说，因为在<servlet>标签中已经指定了name和class,也就是说只有mail.GetAttServlet这个/r
servlet中才能取到path,而别的Servlet是不能取到的。

前面我们讲了对这连个属性的认识，下面让我们来共同学习一下，如何获取这两个对象的参数：

访问ServletConfig参数：
首先要取得ServletConfig对象，然后调用它的getInitParameter();方法。要访问
ServletConfig对象，jsp中直接使用config内置对象，但因为你的JSP编译后的servlet一般不会被
加到web.xml中的，所以一般不会通过jsp来取对本JSP编译后的servlet的配置参数，那么在servlet
中要得到ServletConfig对象有两种方法：

在inii()方法中取到：通过init的重载方法传递

.....
public class Test extends HttpServlet 
{
ServletConfig config;
public void init(ServletConfig config) throws ServletException {
this.config = config;
}
..................
}
然后在下面的方法中就可以访问config对象。但要注意，为了确保能从构造方法中到当前servlet的
config对象，应该调用父类的构造方法：
.....
public class Test extends HttpServlet 
{
ServletConfig config;
public void init(ServletConfig config) throws ServletException {
super.init(config);
this.config = config;
}
..................
}

通过getServletConfig()方法直接到时，这样做的好处是不必调手工传递属性，想在任何时候都可
以得到。

    还有第三种方法，要自己实现一些接口，这里作为一般讨论就不介绍了。
要访问ServletContext对象，只要从现有的ServletConfig对象getServletContext（）就可以了，然后/r调用它的getInitParameter()方法就可以获取它的参数。

    按说：ServletContext对象的作用域比ServletConfig作用域大，为什么要从ServletConfig中到得
ServletContext对象呢？我个人认为：容器保存了很多个ServletContext对象，请求时容器到底取哪一个/r给你呢？那就取其中包含ServletConfig信息的那个给你，就是说取ServletConfig对象的父级对象。就好象HttpSession要从requset中取得一样，就是取那个包含当前request对象的session对象给你，这只是我的个人想法，还没有来得及看具体实现。反正就这么用吧。