九大内置对象

内置对象

类型

说明

作用域

request

javax.servlet.ServletRequest

请求对象——在 一次请求/一个Request请求周期 中传递数据，请求结束后，数据不可访问，用于页面之间的值的传递

用户请求期

response

javax.servlet.SrvletResponse

响应对象——用来响应客户端请求并向客户端输出信息

页面执行期

out

javax.servlet.jsp.JspWriter

输出对象——表示输出流，该流将作为请求的响应发送到客户端

页面执行期

session

javax.servlet.http.HttpSession

会话对象——在一个session会话周期中，用于存储有关用户会话的所有信息

会话周期

application

javax.servlet.ServletContext

应用程序对象——用于实现用户之间的数据共享，负责提供应用程序在服务器中运行时的一些全局信息

整个程序运行期

pageContext

javax.servlet.jsp.PageContext

页面上下文对象——此对象提供所有四个作用域层次的属性查询和修改能力，它也提供了转发请求到其它资源和包含其他资源的方法

页面执行期

page

javax.lang.Object

页面对象——只在当前JSP页面内有效，提供对网页上定义的所有对象的访问，其表示的就是页面本身

页面执行期

config

javax.servlet.ServletConfig

配置对象——是ServletConfig的实例，代理当前jsp页面配置，提供配置信息

页面执行期

Execpiton

javax.lang.Throwable

例外对象——此对象指JSP文件运行时所产生的例外对象，也就是JSP引擎在执行代码时抛出的异常，此对象不能在一般JSP文件中直接使用，而只能在使用了“<%@ page isErrorPage="true"%>”的JSP文件中使用，也就是说只有在page指令中具有属性isErrorPage="true"时才有效

页面执行期

out 对象方法

返回类型

方法名称

说明

void

clear()

清除输出缓冲区的内容，但是不输出到客户端

void

clearBuffer()

清除输出缓冲区的内容，并输出到客户端

void

close()

关闭输出流，清除所有内容

void

flush()

输出缓冲区里面的数据

int

getBufferSize()

获取以kb为单位的目前缓冲区大小

int

getRemaining()

获取以kb为单位的缓冲区中未被占用的空间大小

boolean

isAutoFlush()

是否自动刷新缓冲区

void

newLine()

输出一个换行字符

void

print(Object)

将指定类型的数据输出到Http流，不换行

void

println(Object)

将指定类型的数据输出到Http流，并输出一个换行符

Appendable

append(char c | CharSequence cxq, int start, int end | CharSequence cxq )

将一个字符或者实现了CharSequence接口的对象添加到输出流的后面

request 对象方法

返回类型

方法名称

说明

Object

getAttribute(String name)

返回由name指定的属性值，该属性不存在时返回null

Enumeration

getAttributeNames()

返回request对象的所有属性名称的集合

String

getAuthType()

返回用来保护servlet的认证方法的名称，未受保护时返回null

String

getCharacterEncoding()

返回请求中的字符编码方法，可以在response对象中设置

int

getContentLength()

返回请求的BODY的长度，不能确定长度时返回-1。可以在response中设置

String

getContentType()

返回在response中定义的内容类型

String

getContentPath()

返回请求的路径

Cookie[]

getCookies()

返回客户端所有的Cookie的数组

Enumeration

getHeaderNames()

返回所有HTTP头的名称的集合

Enumeration

getHeaders(String name)

返回指定HTTP头的所有值的集合

String

getHeader(String name)

返回指定名称的HTTP头的信息

long

getDateHeader(String name)

返回指定名称的Data类型的HTTP头的信息

int

getIntHeader(String name)

返回指定名称的Int类型的HTTP头的信息

ServletInputStream

getInputStream()

返回请求的输入流

Locale

getLocale()

返回当前页的Locale对象(此对象有两个方法，分别是getDisplayCountry和getDisplayLanguage)，可以在response中设定

Enumeration

getLocales()

返回请求中所有的Locale对象的集合

String

getLocalName()

获取响应请求的服务器端主机名

String

getLocalAddr()

获取响应请求的服务器端地址

int

getLocalPort()

获取响应请求的服务器端端口

String

getMethod()

获取客户端向服务器端发送请求的方法(GET、POST)

String

getParameter(String name)

获取客户端发送给服务器端的参数值

Map

getParameterMap()

该方法返回包含请求中所有参数的一个Map对象

Enumeration

getParameterNames()

返回请求中所有参数的集合

String[]

getParameterValues(String name)

获得请求中指定参数的所有值

String

getQueryString()

返回get方法传递的参数字符串，该方法不分解出单独的参数

String

getPathInfo()

取出请求中处于ServletPath和QueryString之间的额外信息

String

getPathTranslated()

返回用getPathInfo()方法取得的路径信息的实际路径

String

getProtocol()

返回请求使用的协议。可以是HTTP1.1或者HTTP1.0

BufferedReader

getReader()

返回请求的输入流对应的Reader对象，该方法和getInputStream()方法在一个页面中只能调用一个

String

getRemoteAddr()

获取发出请求的客户端ip地址

String

getRemoteHost()

获取发出请求的客户端主机名

String

getRemoteUser()

返回经过客户端验证的用户名，未经验证返回null

int

getRemotePort()

返回发出请求的客户端主机端口

String

getRealPath(String path)

返回给定虚拟路径的物理路径

RequestDispatcher

getRequestDispatcher(String path)

按给定的路径生成资源转向处理适配器对象(转发)

String

getRequestedSessionId()

返回请求的session的标识

String

RequestURI()

返回发出请求的客户端地址，但是不包括请求的参数字符串

StringBuffer

getRequestURI()

返回响应请求的服务器端地址

String

getScheme()

获取协议名称，缺省值为HTTP协议

String

getServerName()

返回响应请求的服务器名称

String

getServletPath()

获取客户端所请求的脚本文件的文件路径

int

getServerPort()

获取响应请求的服务器端主机端口号

void

removeAttribute(String name)

在属性列表中删除指定名称的属性

void

setAttribute(String name, Object value)

在属性列表中添加/删除指定的属性

void

setCharacterEncoding(String charset)

设置请求的字符编码格式

HttpSession

getSession() | getSession(boolean create)

获取session，如果create为true，在无session的情况下创建一个

boolean

isRequestedSessionIdFromCookie()

检查请求的会话ID是否为通过Cookie传入

boolean

isRequestedSessionIdFromURL()

检查请求的会话ID是否为通过URL传入

boolean

isRequestedSessionIdValid()

检查请求的会话ID是否仍然有效

boolean

isSecure()

检查请求是否使用安全链接，如果HTTPS等

boolean

isUserInRole(String role)

检查已经通过验证的用户是否在是role所指定的角色

Principal

getUserPrincipal()

返回包含用户登陆名的一个java.security.Principal对象

response 对象方法

返回类型

方法名称

说明

void

addCookie(Cookie cookie)

添加一个Cookie对象，保存客户端信息

void

addDateHeader(String name, long value)

添加一个日期类型的HTTP头信息，覆盖同名的HTTP头信息

void

addHeader(String name, String value)

添加一个HTTP头，覆盖同名的旧HTTP头

void

addIntHeader(String name, int value)

添加一个整型的HTTP头，覆盖同名的旧HTTP头

boolean

containsHeader(String name)

判断指定的HTTP头是否存在

String

encodeRedirectURL(String url)

对sendRedirect()方法使用的URL进行编码

String

encodeURL(String url)

将URL予以编码，回传包含session ID的URL

void

flushBuffer()

强制把当前缓冲区的内容发送到客户端

int

getBufferSize()

取得以kb为单位的缓冲区大小

String

getCharacterEncoding()

获取响应的字符编码格式

String

getContentType()

获取响应的类型

Locale

getLocale()

获取响应的Locale对象

ServletOutputStream

getOutputStream()

返回客户端的输出流对象

PrintWriter

getWriter()

获取输出流对应的writer对象

boolean

isCommitted()

判断服务器端是否已经将数据输出到客户端

void

reset()

清空buffer中的所有内容

void

sendError(int xc | int xc, String msg)

发送错误，包括状态码和错误信息

void

sendRedirect(String locationg)

把响应发送到另外一个位置进行处理(转发)

void

setBufferSize(int size)

设置以kb为单位的缓冲区大小

void

setCharacterEncoding(String charset)

设置响应使用的字符编码格式

void

setContentLength(int length)

设置响应的BODY长度

void

setContentType(String type)

设置响应的类型

void

setDateHeader(String name, long value)

设置指定名称的Data类型的HTTP头的值

void

setHeader(String name, String value)

设置指定名称的HTTP头的值

void

setIntHeader(String name, int value)

设置指定名称的int类型的HTTP头的值

void

setStatus(int xc)

设置响应状态码，新值会覆盖当前值