📄 requestdispatcher.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.5.0_08) on Wed Nov 07 18:40:02 CST 2007 -->
<TITLE>
RequestDispatcher
</TITLE>
<META NAME="keywords" CONTENT="com.javax.servlet.RequestDispatcher interface">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="RequestDispatcher";
}
</SCRIPT>
<NOSCRIPT>
</NOSCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/RequestDispatcher.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/javax/servlet/GenericServlet.html" title="com.javax.servlet 中的类"><B>上一个类</B></A>
<A HREF="../../../com/javax/servlet/Servlet.html" title="com.javax.servlet 中的接口"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?com/javax/servlet/RequestDispatcher.html" target="_top"><B>框架</B></A>
<A HREF="RequestDispatcher.html" target="_top"><B>无框架</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
摘要： 嵌套 | 字段 | 构造函数 | <A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息： 字段 | 构造函数 | <A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<!-- ======== START OF CLASS DATA ======== -->
<H2>
<FONT SIZE="-1">
com.javax.servlet</FONT>
<BR>
接口 RequestDispatcher</H2>
<HR>
<DL>
<DT><PRE>public interface <B>RequestDispatcher</B></DL>
</PRE>
<P>
<DL>
<DT><B>版本：</B></DT>
<DD>创建时间2007-11-7 下午04:17:30类说明 定义一个对象，从客户端接收请求，然后将它发给服务器的可用资源 （例如Servlet、CGI、HTML文件、JSP文件）。Servlet引擎创 建request dispatcher对象，用于封装由一个特定的URL定义的 服务器资源。这个接口是专用于封装Servlet的，但是一个Servlet 引擎可以创建request dispatcher对象用于封装任何类型的资源。 request dispatcher对象是由Servlet引擎建立的，而不是由 Servlet开发者建立的。</DD>
<DT><B>作者：</B></DT>
<DD>董利伟(翻译)</DD>
</DL>
<HR>
<P>
<!-- ========== METHOD SUMMARY =========== -->
<A NAME="method_summary"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
<B>方法摘要</B></FONT></TH>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/javax/servlet/RequestDispatcher.html#forward(com.javax.servlet.ServletRequest, com.javax.servlet.ServletResponse)">forward</A></B>(<A HREF="../../../com/javax/servlet/ServletRequest.html" title="com.javax.servlet 中的接口">ServletRequest</A> request,
<A HREF="../../../com/javax/servlet/ServletResponse.html" title="com.javax.servlet 中的接口">ServletResponse</A> response)</CODE>
<BR>
被用来从这个Servlet向其它服务器资源传递请求。</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE> void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../com/javax/servlet/RequestDispatcher.html#include(com.javax.servlet.ServletRequest, com.javax.servlet.ServletResponse)">include</A></B>(<A HREF="../../../com/javax/servlet/ServletRequest.html" title="com.javax.servlet 中的接口">ServletRequest</A> request,
<A HREF="../../../com/javax/servlet/ServletResponse.html" title="com.javax.servlet 中的接口">ServletResponse</A> response)</CODE>
<BR>
用来包括发送给其他服务器资源的响应的内容。</TD>
</TR>
</TABLE>
<P>
<!-- ============ METHOD DETAIL ========== -->
<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>方法详细信息</B></FONT></TH>
</TR>
</TABLE>
<A NAME="forward(com.javax.servlet.ServletRequest, com.javax.servlet.ServletResponse)"><!-- --></A><H3>
forward</H3>
<PRE>
void <B>forward</B>(<A HREF="../../../com/javax/servlet/ServletRequest.html" title="com.javax.servlet 中的接口">ServletRequest</A> request,
<A HREF="../../../com/javax/servlet/ServletResponse.html" title="com.javax.servlet 中的接口">ServletResponse</A> response)
throws <A HREF="../../../com/javax/servlet/ServletException.html" title="com.javax.servlet 中的类">ServletException</A>,
java.io.IOException</PRE>
<DL>
<DD>被用来从这个Servlet向其它服务器资源传递请求。 当一个Servlet对响应作了初步的处理，并要求其 它的对象对此作出响应时，可以使用这个方法。 当request对象被传递到目标对象时，请求的URL 路径和其他路径参数会被调整为反映目标对象的目 标URL路径。如果已经通过响应返回了一个 ServletOutputStream对象或 PrintWriter对象，这个方法将不能使用，否则， 这个方法会抛出一个IllegalStateException。
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>request</CODE> - <DD><CODE>response</CODE> -
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../com/javax/servlet/ServletException.html" title="com.javax.servlet 中的类">ServletException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>
<A NAME="include(com.javax.servlet.ServletRequest, com.javax.servlet.ServletResponse)"><!-- --></A><H3>
include</H3>
<PRE>
void <B>include</B>(<A HREF="../../../com/javax/servlet/ServletRequest.html" title="com.javax.servlet 中的接口">ServletRequest</A> request,
<A HREF="../../../com/javax/servlet/ServletResponse.html" title="com.javax.servlet 中的接口">ServletResponse</A> response)
throws <A HREF="../../../com/javax/servlet/ServletException.html" title="com.javax.servlet 中的类">ServletException</A>,
java.io.IOException</PRE>
<DL>
<DD>用来包括发送给其他服务器资源的响应的内容。 本质上来说，这个方法反映了服务器端的内容。 请求对象传到目标对象后会反映调用请求的请 求URL路径和路径信息。这个响应对象只能调 用这个Servlet的ServletOutputStream 对象和PrintWriter对象。 一个调用include的Servlet不能设置头域， 如果这个Servlet调用了必须设置头域的方法 （例如cookie），这个方法将不能保证正常使 用。作为一个Servlet开发者，你必须妥善地 解决那些可能直接存储头域的方法。例如，即 使你使用会话跟踪，为了保证session的正常 工作，你必须在一个调用include的Servlet 之外开始你的session
<P>
<DD><DL>
<DT><B>参数：</B><DD><CODE>request</CODE> - <DD><CODE>response</CODE> -
<DT><B>抛出：</B>
<DD><CODE><A HREF="../../../com/javax/servlet/ServletException.html" title="com.javax.servlet 中的类">ServletException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="跳过导航链接"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>概述</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>软件包</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>类</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/RequestDispatcher.html"><FONT CLASS="NavBarFont1"><B>使用</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>树</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>已过时</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>索引</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>帮助</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../com/javax/servlet/GenericServlet.html" title="com.javax.servlet 中的类"><B>上一个类</B></A>
<A HREF="../../../com/javax/servlet/Servlet.html" title="com.javax.servlet 中的接口"><B>下一个类</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../../index.html?com/javax/servlet/RequestDispatcher.html" target="_top"><B>框架</B></A>
<A HREF="RequestDispatcher.html" target="_top"><B>无框架</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../../allclasses-noframe.html"><B>所有类</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
<TR>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
摘要： 嵌套 | 字段 | 构造函数 | <A HREF="#method_summary">方法</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
详细信息： 字段 | 构造函数 | <A HREF="#method_detail">方法</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
</BODY>
</HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -