JavaServletAPI中文说明文档(2)计算机等级考试

文章作者 100test 发表时间 2010:01:10 11:35:48
来源 100Test.Com百考试题网

　　12、log

　　public void log(String msg).

　　public void log(String msg, Throwable t).

　　public void log(Exception exception, String msg). // 这种用法将被取消

　　写指定的信息到一个Servlet环境对象的log文件中。被写入的log文件由Servlet引擎指定，但是通常这是一个事件log。当这个方法被一个异常调用时，log中将包括堆栈跟踪。

　　13、setAttribute

　　public void setAttribute(String name, Object o).

　　给予Servlet环境对象中你所指定的对象一个名称。

　　14、removeAttribute

　　public void removeAttribute(String name).

　　从指定的Servlet环境对象中删除一个属性。

　　注：以下几个方法将被取消

　　15、getServlet

　　public Servlet getServlet(String name) throws ServletException.

　　最初用来返回一个指定名称的Servlet，如果没找到就返回一个空值。如果这个Servlet能够返回，这就意味着它已经被初始化，而且已经可以接受 service请求。这是一个危险的方法。当调用这个方法时，可能并不知道Servlet的状态，这就可能导致有关服务器状态的问题。而允许一个 Servlet访问其他Servlet的这个方法也同样的危险。

　　现在这个方法返回一个空值，为了保持和以前版本的兼容性，现在这个方法还没有被取消。在以后的API版本中，该方法将被取消。

　　16、getServletNames

　　public Enumeration getServletNames().

　　最初用来返回一个String对象的列表，该列表表示了在这个Servlet环境下所有已知的Servlet对象名。这个列表总是包含这个Servlet自身。

　　基于与上一个方法同样的理由，这也是一个危险的方法。

　　现在这个方法返回一个空的列表。为了保持和以前版本的兼容性，现在这个方法还没有被取消。在以后的API版本中，该方法将被取消。

　　17、getServlets

　　public Enumeration getServlets().

　　最初用来返回在这个Servelet环境下所有已知的Servlet对象的列表。这个列表总是包含这个Servlet自身。

　　基于与getServlet方法同样的理由，这也是一个危险的方法。

　　现在这个方法返回一个空的列表。为了保持和以前版本的兼容性，现在这个方法还没有被取消。在以后的API版本中，该方法将被取消。

　　五、ServletRequest接口

　　定义

　　public interface ServletRequest

　　定义一个Servlet引擎产生的对象，通过这个对象，Servlet可以获得客户端请求的数据。这个对象通过读取请求体的数据提供包括参数的名称、值和属性以及输入流的所有数据。

　　方法

　　1、getAttribute

　　public Object getAttribute(String name).

　　返回请求中指定属性的值，如果这个属性不存在，就返回一个空值。这个方法允许访问一些不提供给这个接口中其他方法的请求信息以及其他Servlet放置在这个请求对象内的数据。

　　2、getAttributeNames

　　public Enumeration getAttributeNames().

　　返回包含在这个请求中的所有属性名的列表。

　　3、getCharacterEncoding

　　public String getCharacterEncoding().

　　返回请求中输入内容的字符编码类型，如果没有定义字符编码类型就返回空值。

　　4、getContentLength

　　public int getContentLength().

　　请求内容的长度，如果长度未知就返回-1。

　　5、getContentType

　　public String getContentType().

　　返回请求数据体的MIME类型，如果类型未知返回空值。

　　6、getInputStream

　　public ServletInputStream getInputStream() throws IOException.

　　返回一个输入流用来从请求体读取二进制数据。如果在此之前已经通过getReader方法获得了要读取的结果，这个方法会抛出一个IllegalStateException。

　　7、getParameter

　　public String getParameter(String name).

　　以一个String返回指定的参数的值，如果这个参数不存在返回空值。例如，在一个HTTP Servlet中，这个方法会返回一个指定的查询语句产生的参数的值或一个被提交的表单中的参数值。如果一个参数名对应着几个参数值，这个方法只能返回通过getParameterValues方法返回的数组中的第一个值。因此，如果这个参数有（或者可能有）多个值，你只能使用 getParameterValues方法。