1.接口 RequestDispatcher
类说明 定义一个对象,从客户端接收请求,然后将它发给服务器的可用资源 (例如Servlet、CGI、HTML文件、JSP文件)。Servlet引擎创 建request dispatcher对象,用于封装由一个特定的URL定义的 服务器资源。这个接口是专用于封装Servlet的,但是一个Servlet 引擎可以创建request dispatcher对象用于封装任何类型的资源。 request dispatcher对象是由Servlet引擎建立的,而不是由 Servlet开发者建立的。
forward
void forward(ServletRequest request,
ServletResponse response)
throws ServletException,
java.io.IOException
- 被用来从这个Servlet向其它服务器资源传递请求。 当一个Servlet对响应作了初步的处理,并要求其 它的对象对此作出响应时,可以使用这个方法。 当request对象被传递到目标对象时,请求的URL 路径和其他路径参数会被调整为反映目标对象的目 标URL路径。如果已经通过响应返回了一个 ServletOutputStream对象或 PrintWriter对象,这个方法将不能使用,否则, 这个方法会抛出一个IllegalStateException。
- 参数:
-
request
- -
response
- - 抛出:
ServletException
java.io.IOException
include
void include(ServletRequest request,
ServletResponse response)
throws ServletException,
java.io.IOException
- 用来包括发送给其他服务器资源的响应的内容。 本质上来说,这个方法反映了服务器端的内容。 请求对象传到目标对象后会反映调用请求的请 求URL路径和路径信息。这个响应对象只能调 用这个Servlet的ServletOutputStream 对象和PrintWriter对象。 一个调用include的Servlet不能设置头域, 如果这个Servlet调用了必须设置头域的方法 (例如cookie),这个方法将不能保证正常使 用。作为一个Servlet开发者,你必须妥善地 解决那些可能直接存储头域的方法。例如,即 使你使用会话跟踪,为了保证session的正常 工作,你必须在一个调用include的Servlet 之外开始你的session
-
- 参数:
-
request
- -
response
- - 抛出:
ServletException
java.io.IOException
2.接口 Servlet
类说明 这个接口定义了一个Servlet:一个在Web服务器上继承了这个功能的Java类。
init
void init(ServletConfig config)
throws ServletException
- Servlet引擎会在Servlet实例化之后,置入服务之前精确地调用init方法。 在调用service方法之前,init方法必须成功退出。如果init方法抛出一个 ServletException,你不能将这个Servlet置入服务中,如果init方法在 超时范围内没完成,我们也可以假定这个Servlet是不具备功能的,也不能置 入服务中。
-
- 参数:
-
config
- - 抛出:
ServletException
service
void service(ServletRequest request,
ServletResponse response)
throws ServletException,
java.io.IOException
- Servlet引擎调用这个方法以允许Servlet响应请求。这个方法在Servlet 未成功初始化之前无法调用。在Servlet被初始化之前,Servlet引擎能够 *未决的请求。在一个Servlet对象被卸载后,直到一个新的Servelt被 初始化,Servlet引擎不能调用这个方法
-
- 参数:
-
request
- -
response
- - 抛出:
ServletException
java.io.IOException
destroy
void destroy()
- 当一个Servlet被从服务中去除时,Servlet引擎调用这个方法。在这个对 象的service方法所有线程未全部退出或者没被引擎认为发生超时操作时, destroy方法不能被调用。
-
getServletConfig
ServletConfig getServletConfig()
- 返回一个ServletConfig对象,作为一个Servlet的开发者,你应该通过 init方法存储ServletConfig对象以便这个方法能返回这个对象。为了你 的便利,GenericServlet在执行这个接口时,已经这样做了。
-
- 返回:
getServletInfo
java.lang.String getServletInfo()
- 允许Servlet向主机的Servlet运行者提供有关它本身的信息。返回的字符 串应该是纯文本格式而不应有任何标志(例如HTML,XML等)。
-
- 返回:
3.接口 ServletConfig
类说明 这个接口定义了一个对象,通过这个对象,Servlet引擎配置 一个Servlet并且允许Servlet获得一个有关它的 ServletContext接口的说明。每一个ServletConfig对象对 应着一个唯一的Servlet。
getInitParameter
java.lang.String getInitParameter(java.lang.String name)
- 这个方法返回一个包含Servlet指定的初始化参数的String。 如果这个参数不存在,返加空值。
-
- 参数:
-
name
- - 返回:
getInitParameterNames
java.util.Enumeration getInitParameterNames()
- 这个方法返回一个列表String对象,该对象包括Servlet的 所有初始化参数名。如果Servlet没有初始化参数, getInitParameterNames返回一个空的列表。
-
- 返回:
getServletContext
ServletContext getServletContext()
- 返回这个Servlet的ServletContext对象。
3.接口 ServletConfig
类说明 这个接口定义了一个对象,通过这个对象,Servlet引擎配置一个Servlet并且允许Servlet获得一个有关它的 ServletContext接口的说明。每一个ServletConfig对象对应着一个唯一的Servlet。
getInitParameter
java.lang.String getInitParameter(java.lang.String name)
- 这个方法返回一个包含Servlet指定的初始化参数的String。 如果这个参数不存在,返加空值。
-
- 参数:
-
name
- - 返回:
getInitParameterNames
java.util.Enumeration getInitParameterNames()
- 这个方法返回一个列表String对象,该对象包括Servlet的 所有初始化参数名。如果Servlet没有初始化参数, getInitParameterNames返回一个空的列表。
-
- 返回:
getServletContext
ServletContext getServletContext()
- 返回这个Servlet的ServletContext对象。
-
- 返回: