JSP九大内置对象详解
*JSP九大内置对象详解*
JSP内置对象(9个内置对象):
1.PageContext javax.servlet.jsp.PageContext JSP的页面容器
2.request javax.servlet.http.HttpServletrequest 获取用户的请求信息
3.response javax.servlet.http.HttpServletResponse 服务器向客户端的回应信息
4.session javax.servlet.http.HttpSession 用来保存每一个用户的信息
5.application javax.servlet.ServletContext 表示所有用户的共享信息
6.config javax.servlet.ServletConfig 服务器配置信息，可以取得初始化参数
7.out javax.servlet.jsp.jspWriter 页面输出
8.page java.lang.object)
9.exception java.lang.Throwable
四种属性范围:
page(pageContext):只在一个页面中保存属性。 跳转之后无效。
request:只在一次请求中有效，服务器跳转之后有效。 客户端跳无效
session:再一次会话中有效。服务器跳转、客户端跳转都有效。 网页关闭重新打开无效
application:在整个服务器上保存，所有用户都可使用。 重启服务器后无效
注意：如果设置过多的application属性范围会影响服务器性能。
pageContext.PAGE_SCOPE
pageContext.REQUEST_SCOPE
pageContext.SESSION_SCOPE
pageContext.APPLICATION_SCOPE
pageContext.setAttribute("name", "liuyang", pageContext.APPLICATION_SCOPE);
· Request常用的方法：
1.01 getParameter(String strTextName) 获取表单提交的信息。
String strName＝request.getParameter("name");
1.02 getProtocol() 获取客户使用的协议。
String strProtocol=request.getProtocol();
1.03 getServletPath() 获取客户提交信息的页面。
String strServlet=request.getServletPath();
1.04 getMethod() 获取客户提交信息的方式，get|post。
String strMethod = request.getMethod();
1.05 getHeade() 获取HTTP头文件中的accept、accept-encoding和Host的值。
String strHeader = request.getHeader("accept");
1.06 getRermoteAddr() 获取客户的IP地址。
String strIP = request.getRemoteAddr();
1.07 getRemoteHost() 获取客户机的名称。
String clientName = request.getRemoteHost();
1.08 getServerName() 获取服务器名称。
String serverName = request.getServerName();
1.09 getServerPort() 获取服务器的端口号。
int serverPort = request.getServerPort();
1.10 getParameterNames() 获取客户端提交的所有参数的名字。
Enumeration enum = request.getParameterNames(); while(enum.hasMoreElements()){ String s=(String)enum.nextElement(); out.println(s); }
1.11 getHeaderNames() 取出全部头信息。
<%
Enumeration enu = request.getHeaderNames();//取出全部头信息
while(enu.hasMoreElements()){
String name = (String)enu.nextElement();
String value = request.getHeader(name);
%>
<%=name %>--<%=value %>
<%
}
%>
1、request对象
request 对象是 javax.servlet.httpServletRequest类型的对象。 该对象代表了客户端的请求信息，主要用于接受通过HTTP协议传送到服务器的数据。（包括头信息、系统信息、请求方式以及请求参数等）。request对象的作用域为一次请求。
*2、response对象*
response 代表的是对客户端的响应，主要是将JSP容器处理过的对象传回到客户端。response对象也具有作用域，它只在JSP页面内有效。
*3、session对象*
session 对象是由服务器自动创建的与用户请求相关的对象。服务器为每个用户都生成一个session对象，用于保存该用户的信息，跟踪用户的操作状态。session对象内部使用Map类来保存数据，因此保存数据的格式为 “Key/value”。 session对象的value可以使复杂的对象类型，而不仅仅局限于字符串类型。
*4、application对象*
application 对象可将信息保存在服务器中，直到服务器关闭，否则application对象中保存的信息会在整个应用中都有效。与session对象相比，application对象生命周期更长，类似于系统的“全局变量”。
*5、out 对象*
out 对象用于在Web浏览器内输出信息，并且管理应用服务器上的输出缓冲区。在使用 out 对象输出数据时，可以对数据缓冲区进行操作，及时清除缓冲区中的残余数据，为其他的输出让出缓冲空间。待数据输出完毕后，要及时关闭输出流。
*6、pageContext 对象*
pageContext 对象的作用是取得任何范围的参数，通过它可以获取 JSP页面的out、request、reponse、session、application 等对象。pageContext对象的创建和初始化都是由容器来完成的，在JSP页面中可以直接使用 pageContext对象。
*7、config 对象*
config 对象的主要作用是取得服务器的配置信息。通过 pageConext对象的 getServletConfig() 方法可以获取一个config对象。当一个Servlet 初始化时，容器把某些信息通过 config对象传递给这个 Servlet。 开发者可以在web.xml 文件中为应用程序环境中的Servlet程序和JSP页面提供初始化参数。
*8、page 对象*
page 对象代表JSP本身，只有在JSP页面内才是合法的。 page隐含对象本质上包含当前 Servlet接口引用的变量，类似于Java编程中的 this 指针。
*9、exception 对象*
exception 对象的作用是显示异常信息，只有在包含 isErrorPage="true" 的页面中才可以被使用，在一般的JSP页面中使用该对象将无法编译JSP文件。excepation对象和Java的所有对象一样，都具有系统提供的继承结构。exception 对象几乎定义了所有异常情况。在Java程序中，可以使用try/catch关键字来处理异常情况； 如果在JSP页面中出现没有捕获到的异常，就会生成 exception 对象，并把 exception 对象传送到在page指令中设定的错误页面中，然后在错误页面中处理相应的 exception 对象。
JSP有九个内置对象（又叫隐含对象），不需要预先声明就可以在脚本代码和表达式中随意使用
JSP九大内置对象分为四类：
· 输入输出对象：out对象、response对象、request对象
· 通信控制对象：pageContext对象、session对象、application对象
· Servlet对象:page对象、config对象
· 错误处理对象：exception对象
九种对象简介：
\1. out对象：用于向客户端、浏览器输出数据。
\2. request对象：封装了来自客户端、浏览器的各种信息。
\3. response对象：封装了服务器的响应信息。
\4. exception对象：封装了jsp程序执行过程中发生的异常和错误信息。
\5. config对象：封装了应用程序的配置信息。
\6. page对象：指向了当前jsp程序本身。
\7. session对象：用来保存会话信息。也就是说，可以实现在同一用户的不同请求之间共享数
\8. application对象：代表了当前应用程序的上下文。可以在不同的用户之间共享信息。
\9. pageContext对象：提供了对jsp页面所有对象以及命名空间的访问。
*一.out对象*
out对象是一个输出流，用来向浏览器输出信息，除了输出各种信息外还负责对缓冲区进行管理。
out对象方法介绍：
| 方法名 | 说明 |
|---|---|
| print或println | 输出数据 |
| newLine | 输出换行字符 |
| flush | 输出缓冲区数据 |
| close | 关闭输出流 |
| clear | 清除缓冲区中数据,但不输出到客户端 |
| clearBuffer | 清除缓冲区中数据,输出到客户端 |
| getBufferSize | 获得缓冲区大小 |
| getRemaining | 获得缓冲区中没有被占用的空间 |
| isAutoFlush | 是否为自动输出 |
*二.request对象*
request对象封装了从客户端到服务器发出的请求信息。
request对象方法介绍：
| 方法名 | 说明 |
|---|---|
| isUserInRole | 判断认证后的用户是否属于某一成员组 |
| getAttribute | 获取指定属性的值,如该属性值不存在返回Null |
| getAttributeNames | 获取所有属性名的集合 |
| getCookies | 获取所有Cookie对象 |
| getCharacterEncoding | 获取请求的字符编码方式 |
| getContentLength | 返回请求正文的长度,如不确定返回-1 |
| getHeader | 获取指定名字报头值 |
| getHeaders | 获取指定名字报头的所有值,一个枚举 |
| getHeaderNames | 获取所有报头的名字,一个枚举 |
| getInputStream | 返回请求输入流,获取请求中的数据 |
| getMethod | 获取客户端向服务器端传送数据的方法 |
| getParameter | 获取指定名字参数值 |
| getParameterNames | 获取所有参数的名字,一个枚举 |
| getParameterValues | 获取指定名字参数的所有值 |
| getProtocol | 获取客户端向服务器端传送数据的协议名称 |
| getQueryString | 获取以get方法向服务器传送的查询字符串 |
| getRequestURI | 获取发出请求字符串的客户端地址 |
| getRemoteAddr | 获取客户端的IP地址 |
| getRemoteHost | 获取客户端的名字 |
| getSession | 获取和请求相关的会话 |
| getServerName | 获取服务器的名字 |
| getServerPath | 获取客户端请求文件的路径 |
| getServerPort | 获取服务器的端口号 |
| removeAttribute | 删除请求中的一个属性 |
| setAttribute | 设置指定名字参数值 |
request对象演示：
完成一个简单的用户注册信息界面，将注册信息发送到欢迎界面上。
用户注册界面表单设置：
用户注册信息处理界面使用getParameter方法将用户的表单信息提取出来
String name=request.getParameter("userName");
String[] skillArr=request.getParameterValues("skills");
将skillArr数组转换成字符串：
String skills="";
if (skillArr!=null&&skillArr.length>0){
for (String skill:skillArr
) {
skills=skills+skill+" ";
}
}
将数据使用setAttribute保存起来
request.setAttribute("userName",name);
request.setAttribute("skills",skills);
使用jsp的forword指令将页面跳转到welcome.jsp
<jsp:forward page="welcome.jsp"></jsp:forward>
setAttribute和getAttribute用于在web组件之间共享信息
getparameter方法用于接收服务器通过set和post方法传输的数据
注意没有setparameter方法
welcome.jsp页面配置：
<head> <title>技能展示界面</title> </head> <body>信息展示界面：
<%--<%=%>这是表达式<%%>这是jsp程序处理--%>
姓名：<%=request.getAttribute("userName")%>
技能：<%=request.getAttribute("skills")%>
</body>
*三.response对象*
response对象主要用于对客户端的请求进行回应。
以及处理http的连接信息，例如设置http文件头，设置cookie对象等。
response对象方法：
| 方法名 | 说明 |
|---|---|
| addCookie | 添加一个Cookie对象 |
| addHeader | 添加Http文件指定名字头信息 |
| containsHeader | 判断指定名字Http文件头信息是否存在 |
| encodeURL | 使用sessionid封装URL |
| flushBuffer | 强制把当前缓冲区内容发送到客户端 |
| getBufferSize | 返回缓冲区大小 |
| getOutputStream | 返回到客户端的输出流对象 |
| sendError | 向客户端发送错误信息 |
| sendRedirect | 把响应发送到另一个位置进行处理 |
| setContentType | 设置响应的MIME类型 |
| setHeader | 设置指定名字的Http文件头信息 |
*四.session对象*
session对象：是一个jsp内置对象，它在第一个jsp被装载时自动创建，完成会话期管理。从一个客户打开浏览器并连接到服务器开始，到客户关闭浏览器离 开这个服务器结束(或者超时)，被称为一个会话。当一个客户访问一个服务器时，可能会在这个服务器的几个页面之间切换，服务器应当通过某种办法知道这是一个客户，就需要创建session对象。
http是无状态的连接协议，需要使用session来存放用户每次的登陆信息
session对象方法：
| 方法名 | 说明 |
|---|---|
| getAttribute | 获取指定名字的属性 |
| getAttributeNames | 获取session中全部属性名字,一个枚举 |
| getCreationTime | 返回session的创建时间 |
| getId | 获取会话标识符 |
| getLastAccessedTime | 返回最后发送请求的时间 |
| getMaxInactiveInterval | 返回session对象的生存时间单位千分之一秒 |
| invalidate | 销毁session对象 |
| isNew | 每个请求是否会产生新的session对象 |
| removeAttribute | 删除指定名字的属性 |
| setAttribute | 设定指定名字的属性值 |
接下来通过一个登陆的小例子来演示下session对象的应用：
登陆表单设置：
登陆逻辑处理界面，使用getParameter获取到用户名和密码：
String userName=request.getParameter("userName");
String password=request.getParameter("password");
对用户名和密码进行判断：
if (userName!=null&&password!=null){
session.setAttribute("userName",userName);
response.setHeader("refresh","2;URL=welcome.jsp");
}
在欢迎界面使用getAttribute获取当前的用户名：
<%if(session.getAttribute("userName")!=null){%>
<%--getAttribute方法是使用指定的key获取session中的value值。获取到的是一个object对象
在使用的时候需要根据具体的类型进行类型转换。
这里取出的是一个字符串，直接调用会使用他的toString方法，因此不用进行转换--%>
欢迎 <%=session.getAttribute("userName")%>
<%}else{%>
请先登陆
<%}%>
判断session对象是否是新创建
<%if (session.isNew()){%>
欢迎新用户
<%}else{%>
欢迎老用户
<%}%>
在登出界面里清除session对象信息，并跳转到欢迎界面中去：
session.invalidate();//清除掉session对象
response.setHeader("refresh","2;URL=welcome.jsp");
*五.application对象*
application对象代表当前的应用程序。存在于服务器的内存空间中。
应用一旦启动便会自动生成一个application对象。如果应用没有被关闭，
此application对象便一直会存在。直到应用被关闭
application的生命周期比session更长。
应用：
为多个用户共享全局信息。比如当前的在线人数等。
application对象方法：
| 方法名 | 说明 |
|---|---|
| getAttribute | 获取应用对象中指定名字的属性值 |
| getAttributeNames | 获取应用对象中所有属性的名字,一个枚举 |
| getInitParameter | 返回应用对象中指定名字的初始参数值 |
| getServletInfo | 返回Servlet编译器中当前版本信息 |
| setAttribute | 设置应用对象中指定名字的属性值 |
可以使用application对象来实现页面访问次数记录的功能：
<%
Object obj=application.getAttribute("counter");
if (obj==null){
application.setAttribute("counter",new Integer(1));
out.println("该页面被访问了1次
");
}else {
int countValue=new Integer(obj.toString());
countValue++;
out.println("该页面被访问了"+countValue+"次
");
application.setAttribute("counter",countValue);//java会自动装箱
}
%>
*六.config对象*
config对象表示当前jsp程序的配置信息
一般项目中，jsp被用作模版技术，也就是位于表示层
而位于表示层的jsp文件一般是不需要配置信息的
所以此对象在jsp程序中其实很少使用
config对象是servletConfig类的一个实例。
config对象方法：
| 方法名 | 说明 |
|---|---|
| getServletContext | 返回所执行的Servlet的环境对象 |
| getServletName | 返回所执行的Servlet的名字 |
| getInitParameter | 返回指定名字的初始参数值 |
| getInitParameterNames | 返回该JSP中所有的初始参数名,一个枚举 |
*七.page对象*
page对象有点类似与java编程中的this指针，他指向了当前jsp页面本身。
page对象是java.lang.object类的一个实例
page对象拥有一个toString方法，下面是官方定义的方法介绍：
public String toString() {
return getClass().getName() + "@" + Integer.toHexString(hashCode());
}
包名+类名+@+hashcode值
page对象的方法：
| 方法名 | 说明 |
|---|---|
| toString | 将当前项目的信息打印出来 |
| getClass | 返回当前的object类 |
| hashCode | 返回page对象的hashCode值 |
| equals | 用于比较对象是否与当前对象相同 |
*八.exception对象*
exception对象表示jsp引擎在执行代码时抛出的异常
如果想要使用exception对象，那么需要配置编译指令的isErrorPage属性为true
即在页面指令中设置:<%@page isErrorPage=“true”%>
*九：pageContext对象*
pageContetx对象是jsp页面中所有对象功能的最大集成着。
使用他可以访问所有的jsp内置对象。
pageContext对象方法：
| 方法名 | 说明 |
|---|---|
| forward | 重定向到另一页面或Servlet组件 |
| getAttribute | 获取某范围中指定名字的属性值 |
| findAttribute | 按范围搜索指定名字的属性 |
| removeAttribute | 删除某范围中指定名字的属性 |
| setAttribute | 设定某范围中指定名字的属性值 |
| getException | 返回当前异常对象 |
| getRequest | 返回当前请求对象 |
| getResponse | 返回当前响应对象 |
| getServletConfig | 返回当前页面的ServletConfig对象 |
| getServletContext | 返回所有页面共享的ServletContext对象 |
| getSession | 返回当前页面的会话对象 |
• application: javax.servlet. ServletContext 的实例，该实例代表JSP 所属的Web 应用本身，可用于JSP 页面，或者Servlet 之间交换信息。
常用的方法有：
getAttribute(String attNarne) , setAttribute(String attNarne , String attValue) 和getInitPararneter(String paramNarne)等。
• config: javax.servlet. ServletConfig 的实例，该实例代表该JSP 的配置信息。事实上， JSP 页面通常无须配置，也就不存在配置信息。因此，该对象更多地在Servlet 中有效。
常用的方法有getInitPararneter(String paramNarne) 及getInitPararneternarnes() 等方法。
• exception: java.lang.Throwable 的实例，该实例代表其他页面中的异常和错误。只有当页面是错误处理页面，即编译指令page 的isErrorPage 属性为true 时，该对象才可以使用。
常用的方法有getMessageO和printStackTraceO等。
• out: javax.servlet.jsp.JspWriter 的实例，该实例代表JSP 页面的输出流，用于输出内容，形成HTML 页面。
常用方法：
out.print()
out.newLine()
out.close() :关闭输出流
• page: 代表该页面本身，通常没有太大用处。也就是Servlet 中的this ，其类型就是生成的Servlet
• pageContext: javax.servlet.jsp.PageContext 的实例，该对象代表该JSP 页面上下文，使用该对象可以访问页面中的共享数据。
常用的方法有getServletContext()和getServletConfig()等。
• request: javax.servlet. http:HttpServletRequest 的实例，该对象封装了一次请求，客户端的请求参数都被封装在该对象里。这是一个常用的对象，获取客户端请求参数必须使用该对象。
常用的方法有
getPararneter(String paramNarne), getPararneterValues(String paramName), setAttribute(String atttibuteName,Object attributeValue), getAttribute(String attributeName)和setCharacterEncoding(String env)等。
• response: javax.servlet.http.HttpServletResponse 的实例，代表服务器对客户端的响应。通常，也很少使用该对象直接响应，输出响应使用out 对象，而response 对象常用于重定向。
常用的方法有sendRedirect(j ava.lang.String location)等。
• session: javax.servlet.http.HttpSession 的实例，该对象代表一次会话。从客户端浏览器与站点建立连接起，开始会话，直到关闭浏览器时结束会话。
常用的方法有:getAttribute(String attName), setAttribute(String attName, String attValue)等。
① out - javax.servlet.jsp.jspWriter
out对象用于把结果输出到网页上。
详细方法：
1 . void clear() ;
清除输出缓冲区的内容，但是不输出到客户端。
2 . void clearBuffer() ;
清除输出缓冲区的内容，并输出到客户端。
3 . void close() ;
关闭输出流，清除所有内容。
4 . void flush() ;
输出缓冲区里面的数据。
5 . int getBufferSize() ;
获取以kb为单位的目前缓冲区大小。
6 . int getRemaining() ;
获取以kb为单位的缓冲区中未被占用的空间大小。
7 . boolean isAutoFlush() ;
是否自动刷新缓冲区。
8 . void newLine() ;
输出一个换行字符。
9 . void print( boolean b ) ;
void print( char c ) ;
void print( char [] s ) ;
void print( double d ) ;
void print( float f ) ;
void print( int i ) ;
void print( long l ) ;
void print( Object obj ) ;
void print( String s ) ;
将指定类型的数据输出到Http流，不换行。
10 . void println( boolean b ) ;
void println( char c ) ;
void println( char [] s ) ;
void println( double d ) ;
void println( float f ) ;
void println( int i ) ;
void println( long l ) ;
void println( Object obj ) ;
void println( String s ) ;
将指定类型的数据输出到Http流，并输出一个换行符。
11 . Appendable append( char c ) ;
Appendable append( CharSequence cxq, int start, int end ) ;
Appendable append( CharSequence cxq ) ;
将一个字符或者实现了CharSequence接口的对象添加到输出流的后面。
成员：
int DEFAULT_BUFFER = 0 - 缺省缓冲区大小
int NO_BUFFER = - 1 - writer是否处于缓冲输出状态
int UNBOUNDED_BUFFER = - 2 - 是否限制缓冲区大小
*② request - javax.servlet.http.HttpServletRequest*
request对象包含所有请求的信息，如请求的来源、标头、cookies和请求相关的参数值等。
方法：
1 . Object getAttribute( String name ) ;
返回由name指定的属性值，该属性不存在时返回null。
2 . Enumeration getAttributeNames() ;
返回request对象的所有属性名称的集合。
3 . String getAuthType() ;
返回用来保护servlet的认证方法的名称，未受保护时返回null。
4 . String getCharacterEncoding() ;
返回请求中的字符编码方法，可以在response对象中设置。
5 . int getContentLength() ;
返回请求的BODY的长度，不能确定长度时返回 -1。可以在response中设置。
6 . String getContentType() ;
返回在response中定义的内容类型。
7 . String getContentPath() ;
返回请求的路径。
8 . Cookie[] getCookies() ;
返回客户端所有的Cookie的数组。
9 . Enumeration getHeaderNames() ;
返回所有HTTP头的名称的集合。
10 . Enumeration getHeaders( String name ) ;
返回指定HTTP头的所有值的集合。
11 . String getHeader( String name ) ;
返回指定名称的HTTP头的信息。
12 . long getDateHeader( String name ) ;
返回指定名称的Data类型的HTTP头的信息。
13 . int getIntHeader( String name ) ;
返回指定名称的Int类型的HTTP头的信息。
14 . ServletInputStream getInputStream() ;
返回请求的输入流。
15 . Locale getLocale() ;
返回当前页的Locale对象，可以在response中设定。
16 . Enumeration getLocales() ;
返回请求中所有的Locale对象的集合。
17 . String getLocalName() ;
获取响应请求的服务器端主机名。
18 . String getLocalAddr() ;
获取响应请求的服务器端地址。
19 . int getLocalPort() ;
获取响应请求的服务器端端口
20 . String getMethod() ;
获取客户端向服务器端发送请求的方法(GET、POST)。
21 . String getParameter( String name ) ;
获取客户端发送给服务器端的参数值。
22 . Map getParameterMap() ;
该方法返回包含请求中所有参数的一个Map对象。
23 . Enumeration getParameterNames() ;
返回请求中所有参数的集合。
24 . String [] getParameterValues( String name ) ;
获得请求中指定参数的所有值。
25 . String getQueryString() ;
返回get方法传递的参数字符串，该方法不分解出单独的参数。
26 . String getPathInfo() ;
取出请求中处于ServletPath和QueryString之间的额外信息。
27 . String getPathTranslated() ;
返回用getPathInfo()方法取得的路径信息的实际路径。
28 . String getProtocol() ;
返回请求使用的协议。可以是HTTP1.1或者HTTP1.0。
29 . BufferedReader getReader() ;
返回请求的输入流对应的Reader对象，该方法和getInputStream()方法在一个页面中只能调用一个。
30 . String getRemoteAddr() ;
获取发出请求的客户端IP地址。
31 . String getRemoteHost() ;
获取发出请求的客户端主机名
32 . String getRemoteUser() ;
返回经过客户端验证的用户名，未经验证返回null。
33 . int getRemotePort() ;
返回发出请求的客户端主机端口。
34 . String getRealPath( String path ) ;
返回给定虚拟路径的物理路径。
35 . RequestDispatcher getRequestDispatcher( String path ) ;
按给定的路径生成资源转向处理适配器对象。
36 . String getRequestedSessionId() ;
返回请求的session的标识。
37 . String RequestURI() ;
返回发出请求的客户端地址，但是不包括请求的参数字符串。
38 . StringBuffer getRequestURI() ;
返回响应请求的服务器端地址
39 . String getScheme() ;
获取协议名称，缺省值为HTTP协议。
40 . String getServerName() ;
返回响应请求的服务器名称。
41 . String getServletPath() ;
获取客户端所请求的脚本文件的文件路径。
42 . int getServerPort() ;
获取响应请求的服务器端主机端口号。
43 . void removeAttribute( String name ) ;
在属性列表中删除指定名称的属性。
44 . void setAttribute( String name, Object value ) ;
在属性列表中添加 / 删除指定的属性。
45 . void setCharacterEncoding( String name ) ;
设置请求的字符编码格式。
46 . HttpSession getSession() ;
HttpSession getSession( boolean create ) ;
获取session，如果create为true，在无session的情况下创建一个。
47 . boolean isRequestedSessionIdFromCookie() ;
检查请求的会话ID是否为通过Cookie传入。
48 . boolean isRequestedSessionIdFromURL() ;
检查请求的会话ID是否为通过URL传入。
49 . boolean isRequestedSessionIdValid() ;
检查请求的会话ID是否仍然有效。
50 . boolean isSecure() ;
检查请求是否使用安全链接，如果HTTPS等。
51 . boolean isUserInRole( String role ) ;
检查已经通过验证的用户是否在是role所指定的角色。
52 . Principal getUserPrincipal() ;
返回包含用户登陆名的一个java.security.Principal对象。
成员：
String BASIC_AUTH = "BASIC" -
String CLIENT_CERT_AUTH = "CLIENT_CERT" -
String DIGEST_AUTH = "DIGEST" -
String FORM_AUTH = "FORM" -
*③ response - javax.servlet.http.HttpServletResponse*
response对象主要将JSP容器处理后的结果传回到客户端。
方法：
1 . void addCookie( Cookie cookie ) ;
添加一个Cookie对象，保存客户端信息。
2 . void addDateHeader( String name, long value ) ;
添加一个日期类型的HTTP头信息，覆盖同名的HTTP头信息。
3 . void addHeader( String name, String value ) ;
添加一个HTTP头，覆盖同名的旧HTTP头。
4 . void addIntHeader( String name, int value ) ;
添加一个整型的HTTP头，覆盖同名的旧HTTP头。
5 . boolean containsHeader( String name ) ;
判断指定的HTTP头是否存在。
6 . String encodeRedirectURL( String url ) ;
对sendRedirect()方法使用的URL进行编码。
7 . String encodeURL( String url ) ;
将URL予以编码，回传包含session ID的URL。
8 . void flushBuffer() ;
强制把当前缓冲区的内容发送到客户端。
9 . int getBufferSize() ;
取得以kb为单位的缓冲区大小。
10 . String getCharacterEncoding() ;
获取响应的字符编码格式。
11 . String getContentType() ;
获取响应的类型。
12 . Locale getLocale() ;
获取响应的Locale对象。
13 . ServletOutputStream getOutputStream() ;
返回客户端的输出流对象。
14 . PrintWriter getWriter() ;
获取输出流对应的writer对象。
15 . boolean isCommitted() ;
判断服务器端是否已经将数据输出到客户端。
16 . void reset() ;
清空buffer中的所有内容。
17 . void resetBuffer() ;
情况buffer中所有的内容，但是保留HTTP头和状态信息。
18 . void sendError( int xc, String msg ) ;
void sendError( int xc ) ;
发送错误，包括状态码和错误信息。
19 . void sendRedirect( String locationg ) ;
把响应发送到另外一个位置进行处理。
20 . void setBufferSize( int size ) ;
设置以kb为单位的缓冲区大小。
21 . void setCharacterEncoding( String charset ) ;
设置响应使用的字符编码格式。
22 . void setContentLength( int length ) ;
设置响应的BODY长度。
23 . void setContentType( String type ) ;
设置响应的类型。
24 . void setDateHeader( String name, long value ) ;
设置指定名称的Data类型的HTTP头的值。
25 . void setHeader( String name, String value ) ;
设置指定名称的HTTP头的值。
26 . void setIntHeader( String name, int value ) ;
设置指定名称的int类型的HTTP头的值。
27 . void setStatus( int xc ) ;
设置响应状态码，新值会覆盖当前值。
成员(HTTP状态码)：
int SC_CONTINUE = 100 int SC_SWITCHING_PROTOCOLS = 101
int SC_OK = 200 int SC_NON_AUTHORITATIVE_INFORMATION = 203
int SC_ACCEPTED = 202 int SC_CREATED = 201
int SC_NO_CONTENT = 204 int SC_RESET_CONTENT = 205
int SC_PARTIAL_CONTENT = 206 int SC_MULTIPLE_CHOICES = 300
int SC_MOVED_PERMANENTLY = 301 int SC_MOVED_TEMPORARILY = 302
int SC_FOUND = 302 int SC_SEE_OTHER = 303
int SC_NOT_MODIFIED = 304 int SC_USE_PROXY = 305
int SC_TEMPORARY_REDIRECT = 307 int SC_BAD_REQUEST = 400
int SC_UNAUTHORIZED = 401 int SC_PAYMENT_REQUIRED = 402
int SC_FORBIDDEN = 403 int SC_NOT_FOUND = 404
int SC_METHOD_NOT_ALLOWED = 405 int SC_NOT_ACCEPTABLE = 406
int SC_PROXY_AUTHENTICATION_REQUIRED = 407 int SC_REQUEST_TIMEOUT = 408
int SC_CONFLICT = 409 int SC_GONE = 410
int SC_LENGTH_REQUIRED = 411 int SC_PRECONDITION_FAILED = 412
int SC_REQUEST_ENTITY_TOO_LARGE = 413 int SC_REQUEST_URI_TOO_LONG = 414
int SC_UNSUPPORTED_MEDIA_TYPE = 415 int SC_REQUESTED_RANGE_NOT_SATISFIABLE = 416
int SC_EXPECTATION_FAILED = 417 int SC_INTERNAL_SERVER_ERROR = 500
int SC_NOT_IMPLEMENTED = 501 int SC_BAD_GATEWAY = 502
int SC_SERVICE_UNAVAILABLE = 503 int SC_GATEWAY_TIMEOUT = 504
int SC_HTTP_VERSION_NOT_SUPPORTED = 505
*④ session - javax.servlet.http.HttpSession*
session对象表示目前个别用户的会话状态，用来识别每个用户。
方法：
1 . Object getAttribute( String name ) ;
获取与指定名字相关联的session属性值。
2 . Enumeration getAttributeNames() ;
取得session内所有属性的集合。
3 . long getCreationTime() ;
返回session的创建时间，最小单位千分之一秒。
4 . String getId() ;
取得session标识。
5 . long getLastAccessedTime() ;
返回与当前session相关的客户端最后一次访问的时间，由1970 - 01 - 01算起，单位毫秒。
6 . int getMaxInactiveInterval( int interval ) ;
返回总时间，以秒为单位，表示session的有效时间(session不活动时间)。 -1为永不过期。
7 . ServletContext getServletContext() ;
返回一个该JSP页面对应的ServletContext对象实例。
8 . HttpSessionContext getSessionContext() ;
9 . Object getValue( String name ) ;
取得指定名称的session变量值，不推荐使用。
10 . String [] getValueNames() ;
取得所有session变量的名称的集合，不推荐使用。
11 . void invalidate() ;
销毁这个session对象。
12 . boolean isNew() ;
判断一个session是否由服务器产生，但是客户端并没有使用。
13 . void pubValue( String name, Object value ) ;
添加一个session变量，不推荐使用。
14 . void removeValue( String name ) ;
移除一个session变量的值，不推荐使用。
15 . void setAttribute( String name, String value ) ;
设置指定名称的session属性值。
16 . void setMaxInactiveInterval( int interval ) ;
设置session的有效期。
17 . void removeAttribute( String name ) ;
移除指定名称的session属性。
*⑤ pageContext - javax.servlet.jsp.PageContext*
pageContext对象存储本JSP页面相关信息，如属性、内建对象等。
方法：
1 . void setAttribute( String name, Object value, int scope ) ;
void setAttribute( String name, Object value ) ;
在指定的共享范围内设置属性。
2 . Object getAttribute( String name, int scope ) ;
Object getAttribute( String name ) ;
取得指定共享范围内以name为名字的属性值。
3 . Object findAttribute( String name ) ;
按页面、请求、会话和应用程序共享范围搜索已命名的属性。
4 . void removeAttribute( String name, int scope ) ;
void removeAttribute( String name ) ;
移除指定名称和共享范围的属性。
5 . void forward( String url ) ;
将页面导航到指定的URL。
6 . Enumeration getAttributeNamesScope( int scope ) ;
取得指定共享范围内的所有属性名称的集合。
7 . int getAttributeScope( String name ) ;
取得指定属性的共享范围。
8 . ErrorData getErrorDate() ;
取得页面的errorData对象。
9 . Exception getException() ;
取得页面的exception对象。
10 . ExpressionEvaluator getExpressionEvaluator() ;
取得页面的expressionEvaluator对象。
11 . JspWriter getOut() ;
取得页面的out对象。
12 . Object getPage() ;
取得页面的page对象。
13 . ServletRequest getRequest() ;
取得页面的request对象。
14 . ServletResponse getResponse() ;
取得页面的response对象。
15 . ServletConfig getConfig() ;
取得页面的config对象。
16 . ServletContext getServletContext() ;
取得页面的servletContext对象。
17 . HttpSession getSession() ;
取得页面的session对象。
18 . VariableResolver getVariableResolver() ;
取得页面的variableResolver对象。
19 . void include( String url, boolean flush ) ;
void include( String url ) ;
包含其他的资源，并指定是否自动刷新。
20 . void release() ;
重置pageContext内部状态，释放所有内部引用。
21 . void initialize( Servlet servlet, ServletRequest request, ServletResponse response,
String errorPageURL, boolean needSession, int bufferSize, boolean autoFlush ) ;
初始化未经初始化的pageContext对象。
22 . BodyContext pushBody() ;
BodyContext pushBody( Writer writer ) ;
保存当前的out对象，并更新pageContext中page范围内的out对象。
23 . JspWrite popBody() ;
取出由pushBody()方法保存的out对象。
24 . void handlePageException( Exception e ) ;
void handlePageException( Thrwoable t ) ;
成员：
int PAGE_SCOPE = 1 - 页面共享范围
int REQUEST_SCOPE = 2 - 请求共享范围
int SESSION_SCOPE = 3 - 会话共享范围
int APPLICATION_SCOPE = 4 - 应用程序共享范围
String PAGE = "javax.servlet.jsp.jspPage"
String PAGECONTEXT = "javax.servlet.jsp.jspPageContext"
String REQUEST = "javax.servlet.jsp.jspRequest"
String RESPONSE = "javax.servlet.jsp.jspResponse"
String CONFIG = "javax.servlet.jsp.jspConfig"
String SESSION = "javax.servlet.jsp.jspSession"
String OUT = "javax.servlet.jsp.jspOut"
String APPLICATION = "javax.servlet.jsp.jspApplication"
String EXCEPTION = "javax.servlet.jsp.jspException"
*⑥ application - javax.servlet.ServletContext*
application主要功用在于取得或更改Servlet的设定。
方法：
1 . Object getAttribute( String name ) ;
返回由name指定的application属性。
2 . Enumeration getAttributes() ;
返回所有的application属性。
3 . ServletContext getContext( String uripath ) ;
取得当前应用的ServletContext对象。
4 . String getInitParameter( String name ) ;
返回由name指定的application属性的初始值。
5 . Enumeration getInitParameters() ;
返回所有的application属性的初始值的集合。
6 . int getMajorVersion() ;
返回servlet容器支持的Servlet API的版本号。
7 . String getMimeType( String file ) ;
返回指定文件的类型，未知类型返回null。一般为 "text/html" 和 "image/gif" 。
8 . int getMinorVersion() ;
返回servlet容器支持的Servlet API的副版本号。
9 . String getRealPath( String path ) ;
返回给定虚拟路径所对应物理路径。
10 . RequestDispatcher getNamedDispatcher( String name ) ;
为指定名字的Servlet对象返回一个RequestDispatcher对象的实例。
11 . RequestDispatcher getRequestDispatcher( String path ) ;
返回一个RequestDispatcher对象的实例。
12 . URL getResource( String path ) ;
返回指定的资源路径对应的一个URL对象实例，参数要以 "/" 开头。
13 . InputStream getResourceAsStream( String path ) ;
返回一个由path指定位置的资源的InputStream对象实例。
14 . Set getResourcePaths( String path ) ;
返回存储在web - app中所有资源路径的集合。
15 . String getServerInfo() ;
取得应用服务器版本信息。
16 . Servlet getServlet( String name ) ;
在ServletContext中检索指定名称的servlet。
17 . Enumeration getServlets() ;
返回ServletContext中所有servlet的集合。
18 . String getServletContextName() ;
返回本web应用的名称。
19 . Enumeration getServletContextNames() ;
返回ServletContext中所有servlet的名称集合。
20 . void log( Exception ex, String msg ) ;
void log( String msg, Throwable t ) ;
void log( String msg ) ;
把指定的信息写入servlet log文件。
21 . void removeAttribute( String name ) ;
移除指定名称的application属性。
22 . void setAttribute( String name, Object value ) ;
设定指定的application属性的值。
*⑦ config - javax.servlet.ServletConfig*
config对象用来存放Servlet初始的数据结构。
方法：
1 . String getInitParameter( String name ) ;
返回名称为name的促使参数的值。
2 . Enumeration getInitParameters() ;
返回这个JSP所有的促使参数的名称集合。
3 . ServletContext getContext() ;
返回执行者的servlet上下文。
4 . String getServletName() ;
返回servlet的名称。
*⑧ exception - java.lang.Throwable*
错误对象，只有在JSP页面的page指令中指定isErrorPage = "true" 后，才可以在本页面使用exception对象。
方法：
1 . Throwable fillInStackTrace() ;
将当前stack信息记录到exception对象中。
2 . String getLocalizedMessage() ;
取得本地语系的错误提示信息。
3 . String getMessage()
取得错误提示信息。
4 . StackTrackElement[] getStackTrace() ;
返回对象中记录的call stack track信息。
5 . Throwable initCause( Throwable cause ) ;
将另外一个异常对象嵌套进当前异常对象中。
6 . Throwable getCause() ;
取出嵌套在当前异常对象中的异常。
7 . void printStackTrace() ;
void printStackTrace( printStream s ) ;
void printStackTrace( printWriter s ) ;
打印出Throwable及其call stack trace信息。
8 . void setStackTrace( StackTraceElement[] stackTrace )
设置对象的call stack trace信息。
*⑨ page - javax.servlet.jsp.HttpJspPage*
page对象代表JSP对象本身，或者说代表编译后的servlet对象，
可以用( (javax.servlet.jsp.HttpJspPage)page )来取用它的方法和属性。
JSP全名为Java Server Pages，中文名叫java服务器页面。
JSP中一共预先定义了9个这样的对象，分别为：request、response、session、application、out、pagecontext、config、page、exception
*1、request对象javax.servlet.http.HttpServletRequest*
request对象代表了客户端的请求信息，主要用于接受通过HTTP协议传送到服务器的数据。（包括头信息、系统信息、请求方式以及请求参数等）。request对 象的作用域为一次请求。
当Request对象获取客户提交的汉字字符时，会出现乱码问题，必须进行特殊处理。首先，将获取的字符串用ISO-8859－1进行编码，并将编码存发岛一个字节数组中，然后再将这个数组转化为字符串对象如下
Request常用的方法：getParameter(String strTextName) 获取表单提交的信息.
getProtocol() 获取客户使用的协议。
String strProtocol=request.getProtocol();
getServletPath() 获取客户提交信息的页面。String strServlet=request.getServletPath();
getMethod() 获取客户提交信息的方式 String strMethod=request.getMethod();
getHeader() 获取HTTP头文件中的accept,accept-encoding和Host的值,String strHeader=request.getHeader();
getRermoteAddr() 获取客户的IP地址。String strIP=request.getRemoteAddr();
getRemoteHost() 获取客户机的名称。String clientName=request.getRemoteHost();
getServerName() 获取服务器名称。 String serverName=request.getServerName();
getServerPort() 获取服务器的端口号。 int serverPort=request.getServerPort();
getParameterNames() 获取客户端提交的所有参数的名字。
Enumeration enum = request.getParameterNames();while(enum.hasMoreElements())
{
Strings(String)enum.nextElement();
out.println(s);
}
· 1
· 2
· 3
· 4
· 5
· 6
*2、response对象 javax.servlet.http.HttpServletResponse*
response 代表的是对客户端的响应，主要是将JSP容器处理过的对象传回到客户端。response对象也具有作用域，它只在JSP页面内有效。
具有动态响应contentType属性,当一个用户访问一个JSP页面时，如果该页面用page指令设置页面的contentType属性是text/html，那么JSP引擎将按照这个属性值做出反应。
如果要动态改变这换个属性值来响应客户，就需要使用Response对象的setContentType(String s)方法来改变contentType的属性值。
response.setContentType(String s); 参数s可取text/html,application/x-msexcel,application/msword等。
在某些情况下，当响应客户时，需要将客户重新引导至另一个页面，可以使用Response的sendRedirect(URL)方法实现客户的重定向。
例如response.sendRedirect(index.jsp);
*3、session对象 javax.servlet.http.HttpSession*
Session对象是一个JSP内置对象，它在第一个JSP页面被装载时自动创建，完成会话期管理。从一个客户打开浏览器并连接到服务器开始，到客户关闭浏览器离开这个服务器结束，被称为一个会话。当一个客户访问一个服务器时，可能会在这个服务器的几个页面之间切换，服务器应当通过某种办法知道这是一个客户，就需要Session对象。
当一个客户首次访问服务器上的一个JSP页面时，JSP引擎产生一个Session对象，同时分配一个String类型的ID号，JSP引擎同时将这换个ID号发送到客户端，存放在Cookie中，这样Session对象，直到客户关闭浏览器后，服务器端该客户的Session对象才取消，并且和客户的会话对应关系消失。当客户重新打开浏览器再连接到该服务器时，服务器为该客户再创建一个新的Session对象。
session 对象是由服务器自动创建的与用户请求相关的对象。服务器为每个用户都生成一个session对象，用于保存该用户的信息，跟踪用户的操作状态。
session对象内部使用Map类来保存数据，因此保存数据的格式为 “Key/value”。 session对象的value可以使复杂的对象类型，而不仅仅局限于字符串类型。
public String getId()：获取Session对象编号。
public void setAttribute(String key,Object obj)：将参数Object指定的对象obj添加到Session对象中，并为添加的对象指定一个索引关键字。
public Object getAttribute(String key)：获取Session对象中含有关键字的对象。
public Boolean isNew()：判断是否是一个新的客户。
*4、application对象javax.servlet.ServletContext*
application 对象可将信息保存在服务器中，直到服务器关闭，否则application对象中保存的信息会在整个应用中都有效。与session对象相比，application对象生命周期更长，类似于系统的“全局变量”。
服务器启动后就产生了这个Application对象，当客户再所访问的网站的各个页面之间浏览时，这个Application对象都是同一个，直到服务器关闭。但是与Session对象不同的时，所有客户的Application对象都时同一个，即所有客户共享这个内置的Application对象。
setAttribute(String key,Object obj)：将参数Object指定的对象obj添加到Application对象中，并为添加的对象指定一个索引关键字。
getAttribute(String key)：获取Application对象中含有关键字的对象。
*5、out 对象javax.servlet.jsp.jspWriter*
out 对象用于在Web浏览器内输出信息，并且管理应用服务器上的输出缓冲区。在使用 out 对象输出数据时，可以对数据缓冲区进行操作，及时清除缓冲区中的残余数据，为其他的输出让出缓冲空间。待数据输出完毕后，要及时关闭输出流。
Out对象时一个输出流，用来向客户端输出数据。Out对象用于各种数据的输出。其常用方法如下。
out.print()：输出各种类型数据。
out.newLine()：输出一个换行符。
out.close()：关闭流。
*6、pageContext 对象javax.servlet.jsp.PageContext*
pageContext 对象的作用是取得任何范围的参数，通过它可以获取 JSP页面的out、request、reponse、session、application 等对象。
pageContext对象的创建和初始化都是由容器来完成的，在JSP页面中可以直接使用 pageContext对象。
page 对象代表JSP本身，只有在JSP页面内才是合法的。 page隐含对象本质上包含当前 Servlet接口引用的变量，类似于Java编程中的 this 指针。
*7、config 对象javax.servlet.ServletConfig*
config 对象的主要作用是取得服务器的配置信息。通过 pageConext对象的 getServletConfig() 方法可以获取一个config对象。当一个Servlet 初始化时，容器把某些信息通过 config对象传递给这个 Servlet。开发者可以在web.xml 文件中为应用程序环境中的Servlet程序和JSP页面提供初始化参数。
*8 cookie 对象*
Cookie是Web服务器保存在用户硬盘上的一段文本。Cookie允许一个Web站点在用户电脑上保存信息并且随后再取回它。举例来说，一个Web站点可能会为每一个访问者产生一个唯一的ID，然后以Cookie文件的形式保存在每个用户的机器上。
创建一个Cookie对象 调用Cookie对象的构造函数就可以创建Cookie对象。Cookie对象的构造函数有两个字符串参数：Cookie名字和Cookie值。
例如：Cookie c = new Cookie(username”,john”); 将Cookie对象传送到客户端。
JSP中，如果要将封装好的Cookie对象传送到客户端，可使用Response对象的addCookie()方法。
例如：response.addCookie(c)，读取保存到客户端的Cookie。
使用Request对象的getCookie()方法，执行时将所有客户端传来的Cookie对象以数组的形式排列，如果要取出符合需要的Cookie对象，就需要循环比较数组内每个对象的关键字。设置Cookie对象的有效时间，用Cookie对象的setMaxAge()方法便可以设置Cookie对象的有效时间，
例如：Cookie c = newCookie(username”,”john”);c.setMaxAge(3600);
Cookie对象的典型应用时用来统计网站的访问人数。由于代理服务器、缓存等的使用，唯一能帮助网站精确统计来访人数的方法就是为每个访问者建立一个唯一ID。使用Cookie，网站可以完成以下工作:
测定多少人访问过。测定访问者有多少是新用户（即第一次来访），多少是老用户。
测定一个用户多久访问一次网站。当一个用户第一次访问时，网站在数据库中建立一个新的ID，并把ID通过Cookie传送给用户。用户再次来访时，网站把该用户ID对应的计数器加1，得到用户的来访次数。
*9、exception 对象java.lang.Throwable*
exception 对象的作用是显示异常信息，只有在包含 isErrorPage=”true” 的页面中才可以被使用，在一般的JSP页面中使用该对象将无法编译JSP文件。
excepation对象和Java的所有对象一样，都具有系统提供的继承 结构。
exception 对象几乎定义了所有异常情况。在Java程序中，可以使用try/catch关键字来处理异常情况； 如果在JSP页面中出现没有捕获到的异常，就会生成 exception 对象，并把 exception 对象传送到在page指令中设定的错误页面中，然后在错误页面中处理相应的 exception 对象。
