首页 > java > jsp > > 正文

jsp page指令详解

发布人:zhoulujun@live.cn    点击:

page java lang Object  对应this关键字。JSP网页本身,page对象是当前页面转换后的Servlet类的实例。从转换后的Servlet类的代码中,可以看到这种关系:Object page = this;在JSP页面中,很少使用page对象

一、JSP 指令

JSP 指令(directive)影响由 JSP 页面生成的 servlet 的整体结构。下面的模板给出指令的两种可能形式。属性值两边的双引号可以替换为单引号,但引号标记不能完全省略。如果要在属性值中使用引号,则要在它们之前添加反斜杠,' 使用 \'," 使用 \"

<% directive attribute="value" %>
   <% directive attribute1="value1"
   attribute2="value2"
   ......
   attribute3="value3" %>

在 JSP 中,主要有3种类型的指令:page,include 和 taglib。page 指令允许通过类的导入、servlet 超类的定制、内容类型的设置、以及诸如此类的事物来控制 servlet 的结构。page 指令可以放在文档中的任何地方。第二个指令,include 允许在 JSP 文件转换到 servlet 时,将一个文件插入到 JSP 页面中。include 指令应该放 置在文档中希望插入文件的地方。第三个指令,taglib,定义自 定义的标记标签。

二、JSP page 指令

page 指令可以定义下面这些大小写敏感的属性(大致按照使用的频率列出):import、contentType、pageEncoding、session、isELIgnored(只限 JSP 2.0)、buffer、autoFlush、info、errorPage、isErrorPage、isThreadSafe、language 和 extends。

page常用指令表

属性

定义

language=”ScriptLanguage”

指定JSP Container用什么语言来编译,目前只支持JAVA语言。默认为JAVA

extends=”className”

定义此JSP网页产生的Servlet是继承哪个

import=”importList”

定义此JSP网页要使用哪些Java API

session=”true|false”

决定此页面是否使用session对象。默认为true

buffer=”none|size in kb”

决定输出流(Input stream)是否又缓冲区。默认为8kb

autoFlush=”true|false”

决定输出流的缓冲区慢了后是否需要自动清除,缓冲区慢了后会产生异常错误(Exception).默认为true

isThreadSafe=”true|false”

是否支持线程。默认为true

errorPage=”url”

如果此页发生异常,网页会重新指向一个url

isErrorPage=”true|false”

表示此页面是否为错误处理页面。默认为false

contentType=”text/html;charset=gb2312”

表示MIME类型和JSP的编码方式。笔者使用例左

pageEncoding=”ISO-8859-1”

编码方式。(笔者已经加入使用的编码)

isELLgnored=”true|false”

表示是否在此JSP页面中EL表达式。true则忽略,反之false则支持。默认为false

page指令是针对当前页面的指令,常用的page指令有8个:


1.<%@page language="java"%>设置jsp中用到的语言,用到的是java,也是目前唯一有效的设定


2.<%@page extends="mypackage.myclass"%>设置目前jsp要继承的父类,一般不需要设置,在默认情况下,jsp页面默认的父类是HttpJspBase。


3.<%@page import="java.sql.*"% > jsp页面所用到的类


4.<%@page errorPage="error.jsp"%> 设置该jsp页面出现异常时所要转到的页面,如果没设定,容器将使用当前的页面显示错误信息


5.<%@page isErrorPage="true"%> 设置该jsp页面是否作为错误显示页面,默认是false,如果设置为true,容器则会在当前页面生成一个exception对象,和4拍配使用


6.<%@page contentType="text/html;charset=gb2312"%> 设置页面文件格式和编码方式


7.<%@page isThreadSafe="true"% > 设置容器以多线程还是单线程运行该jsp页面,默认是true,是多线程。设置为false,则以单线程的方式运行该jsp页面


8.<%@page session="true"% > 设置该jsp页面是否可以用到session对象(jsp内置对象,为web容器创建),默认是true,能用到session.设置为false,则用不到

2.response对象 

response对象包含了响应客户请求的有关信息,但在JSP中很少直接用到它。它是HttpServletResponse类的实例。


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对象 

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) 



4.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() 关闭输出流 



5.page对象 

page对象就是指向当前JSP页面本身,有点象类中的this指针,它是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开锁



6.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 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的日志文件 



7.exception对象 

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



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

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

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

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


  

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

  

  

9.config对象 

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



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

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

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


jsp中四种属性范围


jsp中有9个内置对象,其中pageContext,request,session,application可以做一个好似容器的东西来用,向容器里放东西,使用setAttribute(String name,Object value),取得可用getAttribute(String name).


其中pageContext.setAttribute(String name,Object value)设置后,只可在当页面取得,无论采取什么样的跳转都不会取到值


request.setAttribute(String name,Object value)设置后,用服务器端跳转的方式可取到值


session.setAttribute(String name,Object value)设置后,无论采用什么样的跳转都可以取到值、


application.setAttribute(String name,Object value)设置后,在整个的应用中都可以取得,不关闭服务器,容器的东西会一直存在.



jsp中两种跳转的区别


在jsp中有两种跳转,客户端跳转和服务器端跳转,,他们之间存在下面4点的区别:


1.<jsp:forward page=""/>做为服务器端跳转,跳转后地址栏地址是当前地址,而不是目的页面。而response.sensRediresct("")作为客户端跳转地址栏会变成目的页面的地址.


2.客户端跳转当程序执行到此句时,是所有代码执行完成后再执行跳转动作,也就是说其后的代码有被执行的机会,而服务器端的跳转是强硬的,执行到此句时,强制跳转,不执行其后的代码。


3.从传递参数的角度上看,客服端跳转可以通过地址重写的方式传递参数,如response.sendRedirect(*.jsp?ref=pokoo&ref2=pokoo2).而服务器的跳转可以采用<jsp:param name="ref" value="pokoo"/>来传递参数。


4.jsp中有四种属性保存范围,如在当前资源中在request中保存了属性,那么客户端的跳转到目的页是拿不到,request容器里的东西的,而服务器端的跳转可以取道.


下面说说自己理解的jsp中四种属性保存范围和jsp中的9个内置对象,和jstl标签库,和简单的jsp标签的开发


在servlet中不能有<jsp:forward page=""/>,那服务器跳转是用 RequestDispatcher rd=request.getRequestDispatcher("*.jsp"); rd.forward(request,response);


@include和jsp:include的区别

<%@include file=""% > 该指令可以把其他文件包含到jsp页面里来,这个文件可以是普通文件,也可以是jsp文件,与之类似功能<jsp:include page=""/>.


前一种指令是先将被包含文件的内容包含进来,然后再进行处理,在jsp页面显示.本身该jsp标签应该有<html>标记,那么被包含文件就不能存在这个标记,否侧就出错.


一句话:先包含后处理


而后一种指令相反,它是先处理,再将被包含文件的显示部分包含进来,都有<html>就不会出错.


一句话:先处理后包含


如使用第二种可以向被包含页面传递参数,被包含页面必须为动态页面,


<jsp:include page="*.jsp">


<jsp:param name="ref1" value="value1"/>


</jsp:include>


被包含页面可以用request取得参数


jsp中的taglib指



<%@taglib uri="tagLibraryURI" prefix="tagPrefix"%>


该指令的作用是命名标记库,jsp2.0有一套标准的标记库---jstl.使用标记库可以使jsp中的script代码减少,毕竟从MVC设计理念来讲,jsp只起到显示的作用,应最大限度的减少script代码.


关于jstl的用法以及如何进行标签库的简单开发本博客jsp分类可以找到。

2.1 import 属性

使用 page 指令的 import 属性指定 JSP 页面转换成的 servlet 应该输入的包。在 JSP 中,包是绝对必需的。原因是,如果没有使用包,系统则认为所引用的类与当前类在同一个包中。例如,假定一个 JSP 页面包含下面的 scriptlet:

<% Test t=new Test(); %>

在此,如果 Test 在某个输入包中,则没有歧义。但是,如果 Test 不在包中,或者页面没有明确地导入 Test 所属的包,那么系统将会认为 Test 就在这个自动生成的 servlet 所在的包中。但问题是自动生成的 servlet 所在的包是未知的!服务器在创建 servlet 时,常常会根据 JSP 页面所在的目录来决定它的包。别的服务器可能使用其他不同的方式。因此,不能指望不使用包的类能够正常工作。对于 bean 也同样如此,因为 bean 不过是遵循某些简单命名约定和结构约定的类。

 默认情况下,servlet 导入 java.lang.*、javax.servlet.*、javax.servlet.jsp.*、javax.servlet.http.*,也许还包括一些服务器特有的包。编写 JSP 代码时,绝不要依靠任何自动导入的服务器特有类。这样做会使得代码不可移植。

使用 import 属性时,可以采用下面两种形式:

<%@ page import="package.class" %>
   <%@ page import="package.class1, ..., package.classN" %>

例如,下面的指令表示 java.util 包和 cn.foololdfat 包中的所有类在使用时无需给出明确的包标识符:

<%@ page import="java.uti1.*, cn.foololdfat.*" %>

 import 是 page 的属性中惟一允许在同一文档中多次出现的属性。尽管 page 指令可以出现在文档中的任何地方,但一般不是将 import 语句放在文档顶部附近,就是放在相应的包首次使用之前。

2.2 contentType 和 pageEncoding 属性

 contentType 属性设置 Content-Type 响应报头,标明即将发送到客户程序的文档的 MIME 类型。有关MIME 类型的更多信息,参见Java Web 开发 (5) HTTP 响应报头

使用 contentType 属性时,可以采用下面两种形式:

<%@ page contentType="MIME-TYPE" %>
   <%@ page contentType="MIME-Type; charset=Character-Set" %>

例如,指令

<%@ page contentType="application/vnd.ms-excel" %>

和下面的 scriptlet 所起到的作用基木相同

<% responce.setContentType("application/vnd.ms-excel"); %>

两种形式的第一点不同是,response.setContentType 使用明确的 Java 代码(这是一些开发人员力图避免使用的方式),而 page 指令只用到 JSP 语法。第二点不同是,指令被特殊处理,它们不是在出现的位置直接成为 _jspService 代码。这意味着 response.setContentType 能够有条件地调用,而 page 指令不能。条件性地设置内容的类型主要用在同一内容能够以多种不同的形式进行显示的情况下。

 不同于常规 servlet (默认的 MIME 类型为 text/plain),JSP 页面的默认 MIME 类型是 text/html (默认字符集为 ISO-8859-1)。因此,如果 JSP 页曲以 Latin 字符集输出 HTML则根本无需使用 contentType,如果希望同时更改内容的类型和字符集,可以使用下面的语句:

<%@ page contentType="someMimeType; charset=someCharacterSet" %>

但是,如果只想更改字符集,使用 pageEncoding 属性更为简单。例如,中文 JSP 页面可以使用下面的语句:

<%@ page pageEncoding="GBK" %>

可考虑将Java Web 开发 (5) HTTP 响应报头中生成 Excel 表格的例子用 JSP 实现,以体会 contentType 的作用。

2.3 session 属性

session 属性控制页面是否参与 HTTP 会话。使用这个属性时,可以采用下面两种形式:

<%@ page session="true" %> <%--Default--%>
   <%@ page session="false" %>

true 值(默认)表示,如果存在已有会话,则预定义变量 session (类型为HttpSession)应该绑定到现有的会话;否则,创建新的会话并将其绑定到 session。false 值表示不自动创建会话,在 JSP 页面转换成 servlet 时,对变量 session 的访问会导致错误。

对于高流量的网站,使用 session="false" 可以节省大量的服务器内存。但要注意,session="false" 并不禁用会话跟踪,它只是阻止 JSP 页面为那些尚不拥有会话的用户创建新的会话。由于会话是针对用户,不是针对贞面,所以,关闭某个页面的会话跟踪没有任何益处,除非有可能在同一客户会话中访问到的相关页面都关闭会话跟踪。

2.4 isELIgnored 属性

isELIgnored 属性控制的是:忽略(true)JSP 2.0 表达式语言(EL),还是进行正常的求值(false)。这是 JSP 2.0 新引入的属性;在只支持 JSP 1.2 及早期版本的服务器中,使用这项属性是不合法的。这个属性的默认值依赖于 Web 应用所使用的 web.xml 的版本。如果 web.xml 指定 servlet 2.3(对应JSP 1.2)或更早版本,默认值为 true(但变更默认值依旧是合法的,JSP 2.0 兼容的服务器中都允许使用这项属性,不管 web.xml 的版本如何)。如果    web.xml 指定 servlet 2.4(对应 JSP 2.0)或之后的版本,那么默认值为false。使用这个属性时,可以采用下面两种形式:

<%@ page isELIgnored="false" %>
   <%@ page isELIgnored="true" %>

2.5 buffer 和 autoFlush 属性

buffer 属性指定 out 变量(类型为 JspWriter )使用的缓冲区的大小。使用这个属性时,可以采用下面两种形式:

<%@ page buffer="sizekb" %>
   <%@ page buffer="none" %>

服务器实际使用的缓冲区可能比指定的更大,但不会小于指定的大小。例如,<%@ page buffer="32kb" %> 表示应该对文档的内容进行缓存,除非累积至少为32KB、页面完成或明确地对输出执行清空(例如使用 response. flushBuffer),否则不将文档发送给客户。

默认的缓冲区大小与服务器相关,但至少8KB。如果要将缓冲功能关闭,应该十分小心:这样做要求设置报头或状态代码的 JSP 元素都要出现在文件的顶部,位于任何 HTML 内容之前。另一方面,有时输出内容的每一行都需要较长的生成时间,此时禁用缓冲或使用小缓冲区会更有效率;这样,用户能够在每一行生成之后立即看到它们,而不是等待更长的时间看到成组的行。

 autoFlush 属性控制当缓冲区充满之后,是应该自动清空输出缓冲区(默认),还是在缓冲区溢出后抛出一个异常(autoFlush="false")。使用这个属性时,可以采用下面两种形式:

<%@ page autoFlush="true" %> <%--Default--%>
   <%@ page autoFlush="false" %>

在 buffer="none" 时,false 值是不合法的。如果客户程序是常规的 Web 浏览器,那么 autoFlush="false" 的使用极为罕见。但是,如果客户程序是定制应用程序,可能希望确保应用程序要么接收到完整的消息,要么根本没有消息。false 值还可以用来捕获产生过多数据的数据库查询,但是,一般说来,将这些逻辑放在数据访问代码中(而非表示代码)要更好一些。

2.6 info 属性

info 属性定义一个可以在 servlet 中通过 getServletInfo 方法获取的字符串,使用 info 属性时,采用下面的形式:

<%@ page info="Some Message" %>

2.7 errorPage 和 isErrorPage 属性

errorPage 属性用来指定一个 JSP 页面,由该页面来处理当前页面中抛出但未被捕获的任何异常(即类型为 Throwable 的对象)。它的应用方式如下:

<%@ page errorPaqe="Relative URL" %>

指定的错误页面可以通过 exception 变量访问抛出的异常。

isErrorPage 属性表示当前页是否可以作为其他 JSP 页面的错误页面。使用 isErrorPage 属性时,可以采用下面两种形式:

<%@ page isErrorPage="true" %>
   <%@ page isErrorPage="false" %> <%--Default--%>

2.8 isThreadSafe 属性

 isThreadSafe 属性控制由 JSP 页面生成的 servlet 是允许并行访问(默认),还是同一时间不允许多个请求访问单个 servlet 实例(isThreadSafe="false")。使用 isThreadSafe 属性时,可以采用下面两种形式:

<%@ page isThreadSafe="true" %> <%--Default--%>
   <%@page isThreadSafe="false" %>

遗憾的是,阻止并发访问的标准机制是实现 SingleThreadModel接口。尽管在早期推荐使用 SingleThreadModel 和 isThreadSafe="false",但最近的经验表明 SingleThreadModel 的设计很差,使得它基本土毫无用处。因而,应该避免使用 isThreadSafe,采用显式的同步措施取而代之。

2.9 extends 属性

extends 属性指定 JSP 页面所生成的 servlet 的超类(superclass )。它采用下面的形式:

<%@ page extends="package.class" %>

这个属性一般为开发人员或提供商保留,由他们对页面的运作方式做出根本性的改变(如添加个性化特性)。一般人应该避免使用这个属性,除非引用由服务器提供商专为这种目的提供的类。

2.10 language 属性

从某种角度讲,language 属性的作用是指定页面使用的脚本语言,如下所示:

<%@ page language="java" %>

就现在来说,由于 Java 既是默认选择,也是惟一合法的选择,所以没必要再去关心这个属性。


参考文章:http://blog.csdn.net/microfhu/article/details/6944368