ServletContext是整个Web应用程序运行后的代表对象,可以通过ServletConfig的getServletContext()方法来取得,之后就可以利用ServletContext来取得Web应用程序的相关资源或信息。
可以用ServletContext来与Web应用程序进行沟通,甚至是取得同一服务器上其他Web应用程序的ServletContext。
该方法可以取得RequestDispatcher实例,使用时路径的指定必须以“/”作为开头,这个斜杠代表应用程序环境根目录(Context Root)。取得RequestDispatcher实例之后,就可以进行请求的转发(Forward)或包含(Include)。
this.getRequestDispatcher("/pages/some.jsp").forward(request, response);
以”/”作为开头时成为环境相对(context-relative)路径,没有以”/”作为开头则成为请求相对(request-relative)路径。
如果想要知道Web应用程序的某个目录中都有哪些文件,则可以使用getResourcePaths()方法。使用时,指定路径必须以”/”作为开头,表示相对于应用程序环境根目录。例如:
public class ShowPathServlet extends HttpServlet{
protected void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
response.setContentType("text/html;charset=utf-8");
PrintWriter out = response.getWriter();
out.println("<!DOCTYPE html>");
out.println("<head>");
out.println("<title>Resource Paths</title");
out.println("</head>");
out.println("<body>");
out.println("<ul>");
Iterator<String> paths = getServletContext().getResourcePaths("/").iterator();
while (paths.hasNext()) {
String path = paths.next();
out.println("<li>" + path + "</li>");
}
out.println("</ul>");
out.println("</body>");
out.println("</html>");
out.close();
}
}
如果想在Web应用程序中读取某个文件的内容,则可以使用getResourceAsStream()方法,执行路径时必须以“/”作为开头,表示相对于应用程序环境根目录,运行结果会返回InputStream实例,接着就可以运用它来读取文件内容。
使用java.io下的File、FileReader、FileInputStream等与文件读取相关的类时,可以指定绝对路径或相对路径。绝对路径是指文件在服务器上的真实路径。必须注意的是,指定相对路径时,此时路径不是相对于Web应用程序根目录,而是相对于启动Web容器时的命令执行目录。以Tomcat为例,若在Servlet中执行以下语句:
out.println(new File("filename").getAbsolutePath());
则显示的是filename位于Tomcat目录下的bin目录中。
每个Servlet都会有一个相对应的ServletConfig对象,我们可以在web.xml中定义Servlet时设置初始参数,之后通过ServletConfig的getInitParameter()方法来读取初始参数。通常最适合读取初始参数的位置在Servlet的无参数init()方法之中,因为Web容器初始Servlet后,会调用有参数的init()方法,而该方法又会调用无参数的init()方法。
每个Web应用程序都会有一个相对应的ServletContext,针对应用程序初始化时所需用到的一些参数数据,可以在web.xml中设置应用程序初始化参数,设置时使用<context-param>
标签来定义。例如:
<web-app ...>
<context-param>
<param-name>MESSAGE</param-name>
<param-value>/WEB-INF</param-value>
</context-param>
</web-app>
如果想要知道Web应用程序何时初始化或何时结束销毁,可以实现ServletContextListener,并在web.xml中设置告知web容器,在web应用程序初始化后果结束销毁前,调用ServletContextListener实现类中相对应的contextInitialized()或contextDestroyed()。
ServletContextListener接口定义如下:
/** * Implementations of this interface receive notifications about changes to the * servlet context of the web application they are part of. To receive * notification events, the implementation class must be configured in the * deployment descriptor for the web application. * * @see ServletContextEvent * @since v 2.3 */
public interface ServletContextListener extends EventListener {
/** ** Notification that the web application initialization process is starting. * All ServletContextListeners are notified of context initialization before * any filter or servlet in the web application is initialized. * @param sce Information about the ServletContext that was initialized */
public void contextInitialized(ServletContextEvent sce);
/** ** Notification that the servlet context is about to be shut down. All * servlets and filters have been destroy()ed before any * ServletContextListeners are notified of context destruction. * @param sce Information about the ServletContext that was destroyed */
public void contextDestroyed(ServletContextEvent sce);
}
当web容器调用contextInitialized()或contextDestroyed()时,会传入ServletContextEvent,其封装了ServletContext,可以通过ServletContextEvent的getServletContext()方法取得ServletConfig,之后就可以进行ServletContext初始参数的读取了。
对于多个Servlet都会使用到的信息,可以把它设置为ServletContext初始参数,可以在web.xml中做如下定义:
...
<context-param>
<param-name>BOOKMARK</param-name>
<param-value>/WEB-INF/bookmarks.txt</param-value>
</context-param>
<listener>
<listener-class>club.cuxing.web.BookmarkInitializer</listener-class>
</listener>
...
<listener>
与<listener-class>
标签用来定义实现了ServletContextListener接口的类名称。
一个实现了ServletContextListener接口的简单例子:
package club.chuxing.web;
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.util.LinkedList;
import java.util.List;
import java.util.logging.*;
import javax.servlet.ServletContext;
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import club.chuxing.model.Bookmark;
public class BookmarkInitializer implements ServletContextListener{
public void contextInitialized(ServletContextEvent sce) {
BufferedReader reader = null;
try {
ServletContext context = sce.getServletContext();
String bookmarkFile = context.getInitParameter("BOOKMARK");
reader = new BufferedReader(new InputStreamReader(
context.getResourceAsStream(bookmarkFile), "UTF-8"));
List<Bookmark> bookmarks = new LinkedList<Bookmark>();
List<String> categories = new LinkedList<String>();
String input = null;
while ((input = reader.readLine()) != null) {
String[] tokens = input.split(",");
Bookmark bookmark = new Bookmark(tokens[0], tokens[1], tokens[2]);
bookmarks.add(bookmark);
if (!categories.contains(tokens[2])) {
categories.add(tokens[2]);
}
}
context.setAttribute("bookmarks", bookmarks);
context.setAttribute("categories", categories);
} catch (IOException ex) {
Logger.getLogger(BookmarkInitializer.class.getName())
.log(Level.SEVERE, null, ex);
} finally {
try {
reader.close();
} catch (IOException ex) {
Logger.getLogger(BookmarkInitializer.class.getName())
.log(Level.SEVERE, null, ex);
}
}
}
public void contextDestroyed(ServletContextEvent sce) {
// TODO Auto-generated method stub
}
}
在整个web应用程序生命周期内,Servlet所需共享的数据可以设置为ServletContext属性。由于ServletContext在web应用程序期间都会一直存在,所以对于设置为ServletContext属性的数据,除非你主动移除,否则也是一直存活于web应用程序之中的。ServletContext的相关方法:
setAttribute()
设置对象为ServletContext属性getAttribute()
取出某个属性removeAttribute()
移除某个属性