JavaWeb之JSP指令

 

要点

 

JSP指令简介 

page指令 

include指令 

 

JSP指令简介 

 

JSP指令（directive）是为JSP引擎而设计的，它们并不直接产生任何可见输出，而只是告诉引擎如何处理JSP页面中的其余部分。

JSP指令的基本语法格式：

<%@ 指令 属性名="值" %>

举例：<%@ page contentType="text/html;charset=gb2312"%>

注意：属性名部分是大小写敏感的

在目前的JSP 2.0中，定义了page、include和taglib这三种指令，每种指令中又都定义了一些各自的属性。

如果要在一个JSP页面中设置同一条指令的多个属性，可以使用多条指令语句单独设置每个属性，也可以使用同一条指令语句设置该指令的多个属性。 

第一种方式：

<%@ page contentType="text/html;charset=gb2312"%>

<%@ page import="java.util.Date"%>

第二种方式：

<%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%> 

 

 

Page指令 

 

page指令用于定义JSP页面的各种属性，无论page指令出现在JSP页面中的什么地方，它作用的都是整个JSP页面，为了保持程序的可读性和遵循良好的编程习惯，page指令最好是放在整个JSP页面的起始位置。 

JSP 2.0规范中定义的page指令的完整语法：

<%@ page 

[ language="java" ]  

[ extends="package.class" ]  

[ import="{package.class | package.*}, ..." ]  

[ session="true | false" ] 

[ buffer="none | 8kb | sizekb" ] 

[ autoFlush="true | false" ] 

[ isThreadSafe="true | false" ] 

[ info="text" ] 

[ errorPage="relative_url" ] 

[ isErrorPage="true | false" ] 

[ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ] 

[ pageEncoding="characterSet | ISO-8859-1" ] 

[ isELIgnored="true | false" ] 

%>

 

language属性指定当前页面可用的脚本语言，只有一个可用值，无实质意义的参数

extends属性当前jsp被翻译成servlet后可以继承那个类，很少用到

import属性导入类到当前页面，只有导入的类才可以使用，否则报错。jsp页面会自动导入一些常用的类。

session属性当前的jsp页面是否允许使用session

errorPage属性指定如果当前页面出错时，展示给用户的页面。

errorPage属性的设置值必须使用相对路径，如果以“/”开头，表示相对于当前WEB应用程序的根目录（注意不是站点根目录），否则，表示相对于当前页面。

可以在web.xml文件中使用<error-page>元素为整个WEB应用程序设置错误处理页面，其中的<exception-type>子元素指定异常类的完全限定名，<location>元素指定以“/”开头的错误处理页面的路径。 

如果设置了某个JSP页面的errorPage属性，那么在web.xml文件中设置的错误处理将不对该页面起作用。

 

JSP引擎会根据page指令的contentType属性生成相应的调用ServletResponse.setContentType方法的语句。

page指令的contentType属性还具有说明JSP源文件的字符编码的作用。

 

重点要点

 

1. JSP 指令: JSP指令（directive）是为JSP引擎而设计的, 

它们并不直接产生任何可见输出, 而只是告诉引擎如何处理JSP页面中的其余部分。

 

2. 在目前的JSP 2.0中，定义了page、include 和 taglib这三种指令

 

3. page 指令:

 

1). page指令用于定义JSP页面的各种属性, 无论page指令出现在JSP页面中的什么地方, 

它作用的都是整个JSP页面, 为了保持程序的可读性和遵循良好的编程习惯, page指令最好是放在整个JSP页面的起始位置。 

 

2). page 指令常用的属性: 

 

①. import 属性: 指定当前 JSP 页面对应的 Servlet 需要导入的类. 

<%@page import="java.text.DateFormat"%>

 

②. session 属性: 取值为 true 或 false, 指定当前页面的 session 隐藏变量是否可用, 也可以说访问当前页面时是否一定要生成 HttpSession

对象. 

<%@ page session="false" %> 

 

③. errorPage 和 isErrorPage: 

> errorPage 指定若当前页面出现错误的实际响应页面时什么. 其中 / 表示的是当前 WEB 应用的根目录. 

<%@ page errorPage="/error.jsp" %> 

 

> 在响应 error.jsp 时, JSP 引擎使用的请求转发的方式. 

 

> isErrorPage 指定当前页面是否为错误处理页面, 可以说明当前页面是否可以使用 exception 隐藏变量. 需要注意的是: 若指定 

isErrorPage="true", 并使用 exception 的方法了, 一般不建议能够直接访问该页面. 

 

> 如何使客户不能直接访问某一个页面呢 ? 对于 Tomcat 服务器而言, WEB-INF 下的文件是不能通过在浏览器中直接输入地址的方式

来访问的. 但通过请求的转发是可以的!

 

> 还可以在 web.xml 文件中配置错误页面: 

 

<error-page>

  <!-- 指定出错的代码: 404 没有指定的资源, 500 内部错误. -->

  <error-code>404</error-code>

  <!-- 指定响应页面的位置 -->

  <location>/WEB-INF/error.jsp</location>

</error-page>

 

<error-page>

  <!-- 指定异常的类型 -->

  <exception-type>java.lang.ArithmeticException</exception-type>

  <location>/WEB-INF/error.jsp</location>

</error-page>

 

④. contentType: 指定当前 JSP 页面的响应类型. 实际调用的是 response.setContentType("text/html; charset=UTF-8");

通常情况下, 对于 JSP 页面而言其取值均为 text/html; charset=UTF-8. charset 指定返回的页面的字符编码是什么. 通常取值为 UTF-8

 

⑤. pageEncoding: 指定当前 JSP 页面的字符编码. 通常情况下该值和 contentType 中的 charset 一致. 

 

⑥. isELIgnored: 指定当前 JSP 页面是否可以使用 EL 表达式. 通常取值为 false. 

 

include指令 

 

include指令用于通知JSP引擎在翻译当前JSP页面时将其他文件中的内容合并进当前JSP页面转换成的Servlet源文件中，这种在源文件级别进行引入的方式称之为静态引入，当前JSP页面与静态引入的页面紧密结合为一个Servlet。

语法：

<%@ include file="relativeURL"%>

其中的file属性用于指定被引入文件的相对路径。  

细节：

被引入的文件必须遵循JSP语法，其中的内容可以包含静态HTML、JSP脚本元素、JSP指令和JSP行为元素等普通JSP页面所具有的一切内容。  

被引入的文件可以使用任意的扩展名，即使其扩展名是html，JSP引擎也会按照处理jsp页面的方式处理它里面的内容，为了见明知意，JSP规范建议使用.jspf（JSP fragments）作为静态引入文件的扩展名。 

在将JSP文件翻译成Servlet源文件时，JSP引擎将合并被引入的文件与当前JSP页面中的指令元素（设置pageEncoding属性的page指令除外），所以，除了import和pageEncoding属性之外，page指令的其他属性不能在这两个页面中有不同的设置值。 

 

细节：

除了指令元素之外，被引入的文件中的其他元素都被转换成相应的Java源代码，然后插入进当前JSP页面所翻译成的Servlet源文件中，插入位置与include指令在当前JSP页面中的位置保持一致。  

引入文件与被引入文件是在被JSP引擎翻译成Servlet的过程中进行合并，而不是先合并源文件后再对合并的结果进行翻译。当前JSP页面的源文件与被引入文件的源文件可以采用不同的字符集编码，即使在一个页面中使用page指令的pageEncoding或contentType属性指定了其源文件的字符集编码，在另外一个页面中还需要用page指令的pageEncoding或contentType属性指定其源文件所使用的字符集 。 

Tomcat 5.x在访问JSP页面时，可以检测它所引入的其他文件是否发生了修改，如果发生了修改，则重新编译当前JSP页面

file属性的设置值必须使用相对路径，如果以“/”开头，表示相对于当前WEB应用程序的根目录（注意不是站点根目录），否则，表示相对于当前文件。

 

 

假设myweb应用程序的根目录下有一个a.jsp文件，其一般的访问路径形式为：

http://localhost:8080/myweb/a.jsp

在a.jsp页面中使用了如下语句引入b.jspf文件：

<%@ include file=“b.jspf”%>

请问：这时候JSP引擎调用的b.jspf文件的完整URL路径为什么？

如果将a.jsp页面映射为如下地址：

http://localhost:8080/myweb/dir1/a.html

请问：这时候JSP引擎调用的b.jspf文件的完整URL路径为：

http://localhost:8080/myweb/b.jspf

http://localhost:8080/myweb/dir1/b.jspf

 

重点要点

 

3. include 指令: <%@ include file="b.jsp" %>

 

1). include 指令用于通知 JSP 引擎在翻译当前 JSP 页面时将其他文件中的内容合并进当前 JSP 页面转换成的 Servlet 源文件中,

这种在源文件级别进行引入的方式称之为静态引入, 当前JSP页面与静态引入的页面紧密结合为一个Servlet。

 

2). file属性的设置值必须使用相对路径

 

3). 如果以 / 开头，表示相对于当前WEB应用程序的根目录（注意不是站点根目录），否则，表示相对于当前文件。

 

4. jsp:incluce 标签:

 

1). <jsp:include page="b.jsp"></jsp:include>

 

2). 动态引入: 并不是像 include 指令生成一个 Servlet 源文件, 而是生成两个 Servlet 源文件, 然后通过一个方法的方式把目标页面包含

进来. 

 

org.apache.jasper.runtime.JspRuntimeLibrary.include(request, response, "b.jsp", out, false);

 

5. jsp:forward:

 

1).

 

<jsp:forward page="/include/b.jsp"></jsp:forward>   

 

相当于. 

 

<% 

request.getRequestDispatcher("/include/b.jsp").forward(request, response);

%>

 

2). 但使用 jsp:forward 可以使用 jsp:param 子标签向 b.jsp 传入一些参数. 同样 jsp:include 也可以使用 jsp:param 子标签. 

 

<jsp:forward page="/include/b.jsp">

<jsp:param value="abcd" name="username"/>

</jsp:forward>

 

OR

 

<jsp:include page="/include/b.jsp">

<jsp:param value="abcd" name="username"/>

</jsp:include>

 

在  b.jsp 页面可以通过 request.getParameter("username") 获取到传入的请求参数. 

 

JSP标签

 

JSP还提供了一种称之为Action的元素，在JSP页面中使用Action元素可以完成各种通用的JSP页面功能，也可以实现一些处理复杂业务逻辑的专用功能。 

Action元素采用XML元素的语法格式，即每个Action元素在JSP页面中都以XML标签的形式出现。

JSP规范中定义了一些标准的Action元素，这些元素的标签名都以jsp作为前缀，并且全部采用小写，例如，<jsp:include>、<jsp:forward>等等。  

 

<jsp:include>标签

<jsp:include>标签用于把另外一个资源的输出内容插入进当前JSP页面的输出内容之中，这种在JSP页面执行时的引入方式称之为动态引入。

语法：

<jsp:include page="relativeURL | <%=expression%>" flush="true|false" />

 

page属性用于指定被引入资源的相对路径，它也可以通过执行一个表达式来获得。

flush属性指定在插入其他资源的输出内容时，是否先将当前JSP页面的已输出的内容刷新到客户端。  

 

<jsp:include>标签与include指令的比较 

 

<jsp:include>标签是在当前JSP页面的执行期间插入被引入资源的输出内容，当前JSP页面与被动态引入的资源是两个彼此独立的执行实体，被动态引入的资源必须是一个能独立被WEB容器调用和执行的资源。include指令只能引入遵循JSP格式的文件，被引入文件与当前JSP文件共同合被翻译成一个Servlet的源文件。 

使用<jsp:include>标签和include指令都可以把一个页面的内容分成多个组件来生成，开发者不必再把页眉和页脚部分的相同HTML代码复制到每个JSP文件中，从而可以更轻松地完成维护工作，但是都应注意最终的输出结果内容应遵循HTML语法结构，例如，如果当前页面产生了<html>、</html>、<body>、</body>等标记，那么在被引入文件中就不能再输出<html>、</html>、<body>、</body>等标记。 

<jsp:include>标签对JSP引擎翻译JSP页面的过程不起作用，它是在JSP页面的执行期间才被调用，因此不会影响两个页面的编译。由于include指令是在JSP引擎翻译JSP页面的过程中被解释处理的，所以它对JSP引擎翻译JSP页面的过程起作用，如果多个JSP页面中都要用到一些相同的声明，那么就可以把这些声明语句放在一个单独的文件中编写，然后在每个JSP页面中使用include指令将那个文件包含进来。 

 

 

<jsp:include>标签使用page属性指定被引入资源的相对路径，而include指令使用file属性指定被引入资源的相对路径。

假设myweb应用程序的根目录下有一个a.jsp文件，其一般的访问路径形式为：

http://localhost:8080/myweb/a.jsp

在a.jsp页面中使用了如下语句引入b.jsp文件：

<jsp:include page=“b.jsp" />

请问：这时候JSP引擎调用的b.jsp文件的完整URL路径为什么？

如果将a.jsp页面映射为如下地址：

http://localhost:8080/myweb/dir1/a.html

请问：这时候JSP引擎调用的b.jsp文件的完整URL路径为：

http://localhost:8080/myweb/b.jspf

http://localhost:8080/myweb/dir1/b.jspf

 

 

 

 

<jsp:forward>标签 

 

<jsp:forward>标签用于把请求转发给另外一个资源。

语法：

<jsp:forward page="relativeURL | <%=expression%>" /> 

page属性用于指定请求转发到的资源的相对路径，它也可以通过执行一个表达式来获得。

 

 

RequestDispatcher.forward方法、PageContext.forward方法、<jsp:forward>标

签的区别

调用RequestDispatcher.forward方法的JSP脚本代码的前后不能有JSP模版内容。

调用PageContext.forward方法的JSP脚本代码的后面不能有JSP模版内容。

<Jsp:forward>标签的前后都能有JSP模版内容。

 

 

 

<jsp:param>标签  

 

当使用<jsp:include>和<jsp:forward>标签引入或将请求转发给的资源是一个能动态执行的程序时，例如Servlet和JSP页面，那么，还可以使用<jsp:param>标签向这个程序传递参数信息。

语法1：

<jsp:include page="relativeURL | <%=expression%>">

<jsp:param name="parameterName" value="parameterValue|<%= expression %>" />

</jsp:include>

语法2：

<jsp:forward page="relativeURL | <%=expression%>">

<jsp:param name="parameterName" value="parameterValue|<%= expression %>" />

</jsp:include>

<jsp:param>标签的name属性用于指定参数名，value属性用于指定参数值。在<jsp:include>和<jsp:forward>标签中可以使用多个<jsp:param>标签来传递多个参数。