JSP内置对象

原文链接：http://edu.codepub.com/2009/1018/16461.php

一、request对象

request对象是javax.servlet.http.HttpServletRequest接口实现类的一个实例，它代表着一个HTTP请求。

（javax.servlet.http.HttpServletRequest 接口扩展了javax.servlet.http.HttpServletRequest接口。）

 

object A      getAttribute(String name) 返回指定属性的属性值

Enumeration  getAttributeNames() 返回所有可用属性名的枚举

String        getCharacterEncoding() 返回字符编码方式

String        setCharacterEncoding() 设置字符编码方式

int         getContentLength() 返回请求体的长度（以字节数）

String       getContentType() 得到请求体的MIME类型

ServletInputStream getInputStream() 得到请求体中一行的二进制流

String B     getParameter(String name) 返回name指定参数的参数值

Enumeration  getParameterNames() 返回可用参数名的枚举

String[]      getParameterValues(String name) 返回包含参数name的所有值的数组10  String      getProtocol() 返回请求用的协议类型及版本号

String      getScheme() 返回请求用的计划名,如:http.https及ftp等

String      getServerName() 返回接受请求的服务器主机名

int         getServerPort() 返回服务器接受此请求所用的端口号

BufferedReader getReader() 返回解码过了的请求体

String      getRemoteAddr() 返回发送此请求的客户端IP地址

String      getRemoteHost() 返回发送此请求的客户端主机名

void        setAttribute(String key,Object obj) 设置属性的属性值

String      getRealPath(String path) 返回一虚拟路径的真实路径

String      getRequestURI()  返回文件的名称

String      getRequestURL()  返回全部的URL

String       getHeader（String n）指定请求报头名称的报头内容

 

二、response对象

response对象是javax.servlet.http.HttpServletResponse接口实现类的一个实例，它代表着一个HTTP响应。(javax.servlet.http.HttpServletResponse实现了javax.servlet.ServletResponse)

 

1 String getCharacterEncoding() 返回响应用的是何种字符编码

 

2 ServletOutputStream getOutputStream() 返回响应的一个二进制输出流

 

3 PrintWriter getWriter() 返回可以向客户端输出字符的一个对象

 

4 void setContentLength(int len) 设置响应头长度

 

5 void setContentType(String type) 设置响应的MIME类型

response.setContentType("text/html;charset=gb2312");

 

6 sendRedirect(java.lang.String location) 重新定向客户端的请求

三、session对象

session对象指的是客户端与服务器的一次会话，从客户连到服务器的一个WebApplication开始，直到客户端与服务器断开连接为止。它是HttpSession类的实例.

 

1 long getCreationTime() 返回SESSION创建时间

 

2 public String getId() 返回SESSION创建时JSP引擎为它设的惟一ID号

 

3 long getLastAccessedTime() 返回此SESSION里客户端最近一次请求时间

 

4 int getMaxInactiveInterval() 返回两次请求间隔多长时间此SESSION被取消(ms)

 

5 String[] getValueNames() 返回一个包含此SESSION中所有可用属性的数组

 

6 void invalidate() 取消SESSION，使SESSION不可用

 

7 boolean isNew() 返回服务器创建的一个SESSION,客户端是否已经加入

 

8 void removeValue(String name) 删除SESSION中指定的属性

 

9 void setMaxInactiveInterval() 设置两次请求间隔多长时间此SESSION被取消(ms)

四、application对象

application对象实现了用户间数据的共享，可存放全局变量。它开始于服务器的启动，直到服务器的关闭，在此期间，此对象将一直存在；这样在用户的前后连接或不同用户之间的连接中，可以对此对象的同一属性进行操作；在任何地方对此对象属性的操作，都将影响到其他用户对此的访问。服务器的启动和关闭决定了application对象的生命。它是ServletContext类的实例。

 

1 Object getAttribute(String name) 返回给定名的属性值

 

2 Enumeration getAttributeNames() 返回所有可用属性名的枚举

 

3 void setAttribute(String name,Object obj) 设定属性的属性值

 

4 void removeAttribute(String name) 删除一属性及其属性值

 

5 String getServerInfo() 返回JSP(SERVLET)引擎名及版本号

 

6 String getRealPath(String path) 返回一虚拟路径的真实路径

 

7 ServletContext getContext(String uripath) 返回指定WebApplication的application对象

 

8 String getMimeType(String file) 返回指定文件的MIME类型

 

9 URL getResource(String path) 返回指定资源(文件及目录)的URL路径

 

10 InputStream getResourceAsStream(String path) 返回指定资源的输入流

 

11 RequestDispatcher getRequestDispatcher(String uripath) 返回指定资源的RequestDispatcher对象

 

12 Servlet getServlet(String name) 返回指定名的Servlet

 

13 Enumeration getServlets() 返回所有Servlet的枚举

 

14 Enumeration getServletNames() 返回所有Servlet名的枚举

 

15 void log(String msg) 把指定消息写入Servlet的日志文件

 

16 void log(Exception exception,String msg) 把指定异常的栈轨迹及错误消息写入Servlet的日志文件

 

17 void log(String msg,Throwable throwable) 把栈轨迹及给出的Throwable异常的说明信息 写入Servlet的日志文件

五、out对象

out对象是JspWriter类的实例,是向客户端输出内容常用的对象

1 void clear() 清除缓冲区的内容

2 void clearBuffer() 清除缓冲区的当前内容

3 void flush() 清空流

4 int getBufferSize() 返回缓冲区以字节数的大小，如不设缓冲区则为0

5 int getRemaining() 返回缓冲区还剩余多少可用

6 boolean isAutoFlush() 返回缓冲区满时，是自动清空还是抛出异常

7 void close() 关闭输出流

六、page对象

page对象是jsp页面实现类的一个实例，它在页面被解释的时候自动创建。在jsp页面中page与this是相同的，都是指向当前JSP页面本身，有点象类中的this指针，它是java.lang.Object类的实例

七、exception对象

exception对象是一个例外对象，当一个页面在运行过程中发生了例外，就产生这个对象。如果一个JSP页面要应用此对象，就必须把isErrorPage设为true，否则无法编译。他实际上是java.lang.Throwable的对象

 

1 String getMessage() 返回描述异常的消息

 

2 String toString() 返回关于异常的简短描述消息

 

3 void printStackTrace() 显示异常及其栈轨迹

 

4 Throwable FillInStackTrace() 重写异常的执行栈轨迹

八、pageContext对象

pageContext对象是javax.servlet.jsp.PageContext类的一个实例，它代表着jsp页面的上下文环境，用来存储和访问jsp页面中所具有page作用域的对象。也就是说，它可以访问到本页所在的SESSION，也可以取本页面所在的application的某一属性值。pageContext对象的作用域为page，也就是说它只能在与其关联的jsp页面内被访问，而不能在其他地方访问。

 

1 JspWriter getOut() 返回当前客户端响应被使用的JspWriter流(out)

 

2 HttpSession getSession() 返回当前页中的HttpSession对象(session)

 

3 Object getPage() 返回当前页的Object对象(page)

 

4 ServletRequest getRequest() 返回当前页的ServletRequest对象(request)

 

5 ServletResponse getResponse() 返回当前页的ServletResponse对象(response)

 

6 Exception getException() 返回当前页的Exception对象(exception)

 

7 ServletConfig getServletConfig() 返回当前页的ServletConfig对象(config)

 

8 ServletContext getServletContext() 返回当前页的ServletContext对象(application)

 

9 void setAttribute(String name,Object attribute) 设置属性及属性值

 

10 void setAttribute(String name,Object obj,int scope) 在指定范围内设置属性及属性值

 

11 public Object getAttribute(String name) 取属性的值

 

12 Object getAttribute(String name,int scope) 在指定范围内取属性的值

 

13 public Object findAttribute(String name) 寻找一属性,返回起属性值或NULL

 

14 void removeAttribute(String name) 删除某属性

 

15 void removeAttribute(String name,int scope) 在指定范围删除某属性

 

16 int getAttributeScope(String name) 返回某属性的作用范围

 

17 Enumeration getAttributeNamesInScope(int scope) 返回指定范围内可用的属性名枚举

 

18 void release() 释放pageContext所占用的资源

 

19 void forward(String relativeUrlPath) 使当前页面重导到另一页面

 

20 void include(String relativeUrlPath) 在当前位置包含另一文件

 

例如：

request设定的值：<%=pageContext.getRequest().getAttribute("name")%>

 

九、config对象

config对象是在一个Servlet初始化时，JSP引擎向它传递信息用的，此信息包括Servlet初始化时所要用到的参数（通过属性名和属性值构成）以及服务器的有关信息（通过传递一个ServletContext对象）

 

1 ServletContext getServletContext() 返回含有服务器相关信息的ServletContext对象

 

2 String getInitParameter(String name) 返回初始化参数的值

 

3 Enumeration getInitParameterNames() 返回Servlet初始化所需所有参数的枚举

 

10. this对象 相当于pageContext对象