[原创]java WEB学习笔记16：JSP指令(page,include)，JSP标签(forwar,include,param)

本博客为原创：综合尚硅谷（http://www.atguigu.com）的系统教程（深表感谢）和网络上的现有资源(博客，文档，图书等)，资源的出处我会标明

本博客的目的：①总结自己的学习过程，相当于学习笔记 ②将自己的经验分享给大家，相互学习，互相交流，不可商用

内容难免出现问题，欢迎指正，交流，探讨，可以留言，也可以通过以下方式联系。

本人互联网技术爱好者，互联网技术发烧友

微博：伊直都在0221

QQ：951226918

-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

1. JSP指令简介

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

　　2）JSP指令的基本语法格式：　　<%@ 指令属性名="值" %>

　　　　举例：<%@ page contentType="text/html;charset=gb2312"%> 注意：属性名部分是大小写敏感的

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

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

　　第一种方式： <%@ page contentType="text/html;charset=gb2312"%> <%@ page import="java.util.Date"%>

　　第二种方式： <%@ page contentType="text/html;charset=gb2312" import="java.util.Date"%>

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

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

　　　　<%@ page

　　　　 [ language="java" ] 设置语言，目前唯一的值就是java

　　　　 [ extends="package.class" ] 当前的JSP在服务器中翻译成的Servlet源文件后所要集成的哪个类(基本没意义)

　　　* [ import="{package.class | package.*}, ..." ] 所需要导入的包

　　　* [ session="true | false" ] 当前的JSP是否允许使用session，通常为 true

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

[ autoFlush="true | false" ]

　　　　 [ isThreadSafe="true | false" ]

[ info="text" ]

　　　* [ errorPage="relative_url" ] 指定一个错误页面，如果当前页面出错了，JSP 会把errorPage 页面当做响应的页面,内部是一个转发的机制，即地址栏为第一次请求的页面地址

　　　* [ isErrorPage="true | false" ] 指定当前页面是否为错误处理页面，同时说明页面是否可以使用 Exception 对象；若为true，可以使用exception 的方法，一般不建议能够直接访问该页面。

　　　　　如果使客户不能直接访问某一个页面？对于tomcat服务器而言，WEB-INF 下的文件是不能通过在浏览器中直接输入地址的方式来访问的。但通过请求的转发是可以的。

　　 * [ contentType="mimeType [ ;charset=characterSet ]" | "text/html ; charset=ISO-8859-1" ] 指定当前JSP 页面的响应类型。实际在jsp 翻译为Servlet之后，调用response.setContenType("text/html;charset=UTF-8);

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

　　 * [ pageEncoding="characterSet | ISO-8859-1" ] 设置页面的编码格式

　　 * [ isELIgnored="true | false" ] 指定当前JSP页面是否可以使用 EL 表达式，通常取值为 true

注意：①JSP引擎会根据page指令的contentType属性生成相应的调用ServletResponse.setContentType方法的语句。 page指令的contentType属性还具有说明JSP源文件的字符编码的作用

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

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

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

 <!-- 配置错误页面 -->
     <error-page>
         <!-- 指定出错的代码：404没有指定的资源，500内部错误 -->
         <error-code>500</error-code>
         <!-- 指定响应页面的位置 -->
         <location>/WIN-INF/error.jsp</location>
     </error-page>
 
     <error-page>
         <!-- 指定异常的类型 -->
         <exception-type>java.lang.exception</exception-type>
         <location>/WEB-INF/error.jsp</location>
     </error-page>

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

　　语法:　　<%@ include file="relativeURL"%> 其中的file属性用于指定被引入文件的相对路径

注意：

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

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

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

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

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

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

4.JSP标签

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

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

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

　　4）<jsp:include>标签，<jsp:forward>标签，<jsp:param>标签

①<jsp:include>标签

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

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

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

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

　　3> <jsp:include> 与静态包含的区别：（了解）

　　　　I. 动态引入生成了两个Servlet 源文件，通过命令方法的方式把目标页面包含进来。org.apche.jasper.runtime.JspRuntimeLibrary.include(request, response, "xx.jsp", out, false);

　　　　而静态包含只产生了一个Servlet 源文件;

　　　　II. <jsp:include>标签是在当前JSP页面的执行期间插入被引入资源的输出内容，当前JSP页面与被动态引入的资源是两个彼此独立的执行实体，被动态引入的资源必须是一个能独立被WEB容器调用和执行的资源;

　　　　　include 指令只能引入遵循JSP格式的文件，被引入文件与当前JSP文件共同合被翻译成一个Servlet的源文件;

②<jsp:forward>标签

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

　　2> 语法： <jsp:forward page="relativeURL | <%=expression%>" />

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

　　3> <jsp:forward>标签，等同于request.getRequestDispacher().foward(); 但是标签可以通过 <jsp:param> 子标签配置参数

     <jsp:forward page="xx.jsp">
             <jsp:param value="jason" name="user"/>
         </jsp:forward> 
 
         <%
             request.getRequestDispatcher("xx.jsp").forward(request, response);
         %>

③ <jsp:param>标签

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

　　2> 语法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>

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