JSP指令、标签以及中文乱码

一、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" ]
%>

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

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

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

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

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

三、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

四、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

　　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>标签来传递多个参数。

五、jsp中文乱码

　　JSP程序存在有与Servlet程序完全相同的中文乱码问题：

　　①输出响应正文时出现的中文乱码问题
　　②读取浏览器传递的参数信息时出现的中文乱码问题
　　④JSP引擎将JSP页面翻译成Servlet源文件时也可能导致中文乱码问题

　　JSP引擎将JSP源文件翻译成的Servlet源文件默认采用UTF-8编码，而JSP开发人员可以采用各种字符集编码来编写JSP源文件，因此，JSP引擎将JSP源文件翻译成Servlet源文件时，需要进行字符编码转换。

　　如果JSP文件中没有说明它采用的字符集编码，JSP引擎将把它当作默认的ISO8859-1字符集编码处理。

　　如何解决JSP引擎翻译JSP页面时的中文乱码问题？

　　通过page指令的contentType属性说明JSP源文件的字符集编码
　　page指令的pageEncoding属性说明JSP源文件的字符集编码
在部署描述符中说明一组JSP源文件的字符集编码
<jsp-config>
   <jsp-property-group>
       <url-pattern>/jsp/*</url-pattern>
       <page-encoding>GB2312</page-encoding>
   </jsp-property-group>
</jsp-config>

　　导致中文乱码的可能原因：

　　Servlet程序从请求消息中获取请求参数和从数据库、文件、键盘等外设中读取一个字符串时都要将底层的字节流转换成字符串，但转换过程中指定的字符集编码与外设所输入内容的字符集编码不一致。如果某个第三方API将底层设备中的字节流数据总是按ISO8859-1转换成字符串返回，那么，对于底层设备中的GB2312编码的中文字符来说，返回的将不是其正确的Unicode码，这时候可以通过如下语句来解决：
　　strNew = new String(strOld.getBytes("ISO8859-1"),"GB2312");

　　Servlet程序将字符串输出到浏览器、屏幕、文件和数据库时都要将字符串转换成底层的字节流，但转换过程中指定的字符集编码与外设所能显示的字符集编码不一致。

　　JSP引擎将JSP源文件翻译成Servlet源文件时，其选择的字符集编码与JSP源文件实际使用的字符集编码不一致。

　　JSP引擎编译由JSP源文件翻译成的Servlet 源文件时，其选择的字符集编码与Servlet 源文件的字符集编码不一致。

　　诊断方法：使用System.out.println语句在命令行窗口中打印出现乱码的字符串，跟踪某个中文字符在JSP页面运行过程中的每个阶段的编码值

如果，您对我的这篇博文有什么疑问，欢迎评论区留言，大家互相讨论学习。
如果，您认为阅读这篇博客让您有些收获，不妨点击一下右下角的【推荐】。
如果，您希望更容易地发现我的新博客，不妨点击一下左下角的【关注我】。
如果，您对我的博文感兴趣，可以关注我的后续博客，我是【AlbertRui】。

转载请注明出处和链接地址，欢迎转载，谢谢！