ServletRequest接口的主要方法
(2013-04-27 09:19:54) 标签: itservletservletrequest接口主要方法 | 分类: JAVA编程 |
定义一个Servlet引擎产生的对象,通过这个对象,Servlet可以获得客户端请求的数据。这个对象通过读取请求体的数据提供包括参数的名称、值和属性以及输入流的所有数据。
1.1 getAttribute()方法
public Object getAttribute(String name);
返回请求中指定属性的值,如果这个属性不存在,就返回一个空值。这个方法允许访问一些不提供给这个接口中其他方法的请求信息以及其他Servlet放置在这个请求对象内的数据。
1.2 getAttributeNames()方法
public Enumeration getAttributeNames();
返回包含在这个请求中的所有属性名的列表。
1.3 getCharacterEncoding()方法
public String getCharacterEncoding();
返回请求中输入内容的字符编码类型,如果没有定义字符编码类型就返回空值。
1.4 getContentLength()方法
public int getContentLength();
请求内容的长度,如果长度未知就返回-1。
1.5 getContentType()方法
public String getContentType();
返回请求数据体的MIME类型,如果类型未知返回空值。
1.6 getInputStream()方法
public ServletInputStream getInputStream() throws IOException;
返回一个输入流用来从请求体读取二进制数据。如果在此之前已经通过getReader方法获得了要读取的结果,这个方法会抛出一个IllegalStateException。
1.7 getParameter()方法
public String getParameter(String name);
以一个String返回指定的参数的值,如果这个参数不存在返回空值。例如,在一个HTTP Servlet中,这个方法会返回一个指定的查询语句产生的参数的值或一个被提交的表单中的参数值。如果一个参数名对应着几个参数值,这个方法只能返回通过getParameterValues方法返回的数组中的第一个值。因此,如果这个参数有(或者可能有)多个值,你只能使用getParameterValues方法。
1.8 getParameterNames()方法
public Enumeration getParameterNames();
返回所有参数名的String对象列表,如果没有输入参数,该方法返回一个空值。
1.9 getParameterValues()方法
public String[] getParameterValues(String name);
通过一个String对象的数组返回指定参数的值,如果这个参数不存在,该方法返回一个空值。
1.10 getProtocol()方法
public String getProtocol();
返回这个请求所用的协议,其形式是协议/主版本号.次版本号。例如对于一个HTTP1.0的请求,该方法返回HTTP/1.0。
1.11 getReader()方法
public BufferedReader getReader() throws IOException;
这个方法返回一个buffered reader用来读取请求体的实体,其编码方式依照请求数据的编码方式。如果这个请求的输入流已经被getInputStream调用获得,这个方法会抛出一个IllegalStateException。
1.12 getRemoteAddr()方法
public String getRemoteAddr();
返回发送请求者的IP地址。
1.13 getRemoteHost()方法
public String getRemoteHost();
返回发送请求者的主机名称。如果引擎不能或者选择不解析主机名(为了改善性能),这个方法会直接返回IP地址。
1.14 getScheme()方法
public String getScheme();
返回请求所使用的URL的模式。例如,对于一个HTTP请求,这个模式就是http。
1.15 getServerName()方法
public String getServerName();
返回接收请求的服务器的主机名。
1.16 getServerPort()方法
public int getServerPort();
返回接收请求的端口号。
1.17 setAttribute()方法
public void setAttribute(String name, Object object);
这个方法在请求中添加一个属性,这个属性可以被其他可以访问这个请求对象的对象(例如一个嵌套的Servlet)使用。
注:以下方法将被取消
1.18 getRealPath()方法
public String getRealPath(String path);
返回与虚拟路径相对应的真实路径,如果因为某种原因,这一过程不能进行,该方法将返回一个空值。
这个方法和ServletContext接口中的getRealPath方法重复。在2.1版中,ServletContext接口将阐明一个Servlet所能用的所有的路径的映射。该方法执行的结果将会与ServletContext中getRealPath方法的结果完全一样。