JSP - 9大内置对象及其API

内置对象：不需要预先声明就可以在脚本代码和表达式中随意使用，有以下特点

1.由JSP规范提供，不用编写者实例化

2.提供Web容器实现和管理

3.所有JSP页面均可用

4.只有在脚本元素的表达式或者代码中才可使用(<%=使用内置对象%>或<%使用内置对象%>)

输入输出对象：request，response，out

通信控制对象：pageContext，session，application

Servlet对象：page，config

错误处理对象：exception

1. request - 请求对象 javax.servlet.httpServletRequest

request 对象是 javax.servlet.httpServletRequest类的实例，该对象代表了客户端的请求信息，主要用于接受通过HTTP协议传送到服务器的数据。（包括头信息、系统信息、请求方式以及请求参数等）。

request对象的作用域为一次请求，发送请求时，该对象创建，一次请求结束后即销毁(一次请求，产生一个request对象)

该对象封装了用户提交信息，通过调用该对象相应的方法以获取封装的信息，使用该对象，可以获取用户提交的信息。

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

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

3 String[] getParameterValues(String name) 返回包含参数name的所有值的数组

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

5 object getAttribute(String name) 返回指定属性的属性值(即setAttribute中参数key的值)

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

7 String getProtocol() 返回请求用的协议类型及版本号

8 String getServerName() 返回接受请求的服务器�*�

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

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

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

12 String getRemoteHost() 返回发送此请求的客户端�*�

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

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

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

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

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

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

2. response - 响应对象 javax.servlet.http.HttpServletResponse

response代表的是对客户端的响应，主要是将JSP容器处理过的对象传回给客户端

对客户端请求做出动态响应，向客户端发送数据，响应客户端请求时建立，响应结束时销毁(一次响应，产生一个response对象)

动态响应contentType属性:

当一个用户访问了一个jsp页面时，如果该页面用page指令设置页面的contentType属性为text/html，那么jsp引擎将按照这个属性值做出反应。如果要动态改变这个属性值来响应客户，就需要使用Response对象

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

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

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

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

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

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

3. session - 会话对象 javax.servlet.http.HttpSession

在页面的page指令加上session="true" 或缺省 情况下以及在servlet中使用request.getSession();的方式进行创建。超时或服务停止时，session结束。(一个用户对应一个session对象)

什么是session对象？——它是一个jsp内置对象，它在第一个jsp被装载时自动创建，完成会话期管理。从一个客户打开浏览器并连接到服务器开始，到客户关闭浏览器离   开这个服务器结束(或者超时)，被称为一个会话。当一个客户访问一个服务器时，可能会在这个服务器的几个页面之间切换，服务器应当通过某种办法知道这是一个客户，就需要创建session对象

session对象的ID——当一个客户首次访问服务器上的一个jsp页面时，jsp引擎会产生一个session对象，同时分配一个String类型的的ID号，jsp引擎同时将这个ID号发送到客户端，存放在cookie中，这样，session对象直到客户关闭浏览器后，服务器端，该客户的session对象才会消失，会并，和客户的会话对应关系消失。当客户重新打开浏览器再连接到该服务器时，服务器为该客户再创建一个新的session对象

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)

4. application - 应用程序对象 javax.servlet.ServletContext

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 int getMajorVersion() 返回服务器支持的Servlet API的最大版本号

9 int getMinorVersion() 返回服务器支持的Servlet API的最大版本号

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

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

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

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

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

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

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

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

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

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

5. out - 数据流对象 javax.servlet.jsp.jspWriter

out对象是 javax.servlet.jsp.JspWriter 类的实例，用来在response对象中写入内容，输出到页面中

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

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

3 void flush() 清空流

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

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

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

7 void close() 关闭输出流

6. pageContext - 页面上下文对象 javax.servlet.jsp.PageContext

pageContext对象提供了对JSP页面内所有的对象及名字空间的访问，也就是说他可以访问到本页所在的Session，也可以取本页面所在的application的某一属性值，他相当于页面中所有功能的集大成者，它的本类名也叫pageContext

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) 在当前位置包含另一文件

7.config - 配置对象 javax.servlet.ServletConfig

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

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

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

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

8. page - 当前JSP页面对象 java.lang.object

page对象就是指向当前JSP页面本身，类似类中的this关键字，对象就是页面实例的引用。它可以被看做是整个JSP页面的代表，它是java.lang.Object类的实例

1 class getClass 返回此Object的类

2 int hashCode() 返回此Object的hash码

3 boolean equals(Object obj) 判断此Object是否与指定的Object对象相等

4 void copy(Object obj) 把此Object拷贝到指定的Object对象中

5 Object clone() 克隆此Object对象

6 String toString() 把此Object对象转换成String类的对象

7 void notify() 唤醒一个等待的线程

8 void notifyAll() 唤醒所有等待的线程

9 void wait(int timeout) 使一个线程处于等待直到timeout结束或被唤醒

10 void wait() 使一个线程处于等待直到被唤醒

11 void enterMonitor() 对Object加锁

12 void exitMonitor() 对Object*

9. exception - 例外对象 java.lang.Throwable

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

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

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

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

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