JSP指令概述
JSP指令的格式:<%@指令名 attr1=”” attr2=”” %>,一般都会把JSP指令放到JSP文件的最上方,但这不是必须的。
JSP中的指令共有三个:page、taglib、include。最常用的是page指令和taglib。
一.page指令
- page指令
page指令是最为常用的指定,也是属性最多的属性!
page指令没有必须属性,都是可选属性。例如<%@page %>,没有给出任何属性也是可以的!
在JSP页面中,任何指令都可以重复出现!
<%@ page language=”java”%>
<%@ page import=”java.util.*”%>
<%@ page pageEncoding=”utf-8”%>
这也是可以的! - page指令的pageEncoding和contentType(重点)
pageEncoding指定当前JSP页面的编码!这个编码是给服务器看的,服务器需要知道当前JSP使用的编码,不然服务器无法正确把JSP编译成java文件。所以这个编码只需要与真实的页面编码一致即可!在MyEclipse中,在JSP文件上点击右键,选择属性就可以看到当前JSP页面的编码了。
contentType属性与response.setContentType()方法的作用相同!它会完成两项工作,一是设置响应字符流的编码,二是设置content-type响应头。例如:<%@ page contentType=”text/html;charset=utf-8”%>,它会使“真身”中出现response.setContentType(“text/html;charset=utf-8”)。
无论是page指令的pageEncoding还是contentType,它们的默认值都是ISO-8859-1,我们知道ISO-8859-1是无法显示中文的,所以JSP页面中存在中文的话,一定要设置这两个属性。
其实pageEncoding和contentType这两个属性的关系很“暧昧”:
1.当设置了pageEncoding,而没设置contentType时: contentType的默认值为pageEncoding;
2.当设置了contentType,而没设置pageEncoding时: pageEncoding的默认值与contentType;
也就是说,当pageEncoding和contentType只出现一个时,那么另一个的值与出现的值相同。如果两个都不出现,那么两个属性的值都是ISO-8859-1。所以通过我们至少设置它们两个其中一个! - page指令的import属性
import是page指令中一个很特别的属性!
import属性值对应“真身”中的import语句。
import属性值可以使逗号:<%@page import=”java.net.* ,java.util.* ,java.sql.*”%>
import属性是可以重复出现的:
<%@page import=”java.util.* ” import=”java.net.* ” import=”java.sql.*”%>
然而,pageEncoding这个属性不能够重复出现,不管是在一条page指令中还是在多条page指令中,只要其中一条page指令出现过了,另外一条page指令就不能够再出现pageEncoding,不管属性值是否相同。(我现在只检查了pageEncoding不能够重复出现,其它的page属性我没有检查,不检查的原因是个人感觉没有必要,因为你是不会犯这种低级错误的。常常我们设置了的就不会去重复设置了,除了import导包外。)
然而,我们一般会使用多个page指令来导入多个包:
<%@ page import=”java.util.*”%>
<%@ page import=”java.net.*”%>
<%@ page import=”java.text.*”%> - page指令的errorPage和isErrorPage
我们知道,在一个JSP页面出错后,Tomcat会响应给用户错误信息(500页面)!如果你不希望Tomcat给用户输出错误信息,那么可以使用page指令的errorPage来指定错误页!也就是自定义错误页面,例如:<%@page errorPage=”xxx.jsp”%>。这时,在当前JSP页面出现错误时,会请求转发到xxx.jsp页面。浏览器地址栏是不会变化的。并且转发是留消息头而不留消息体即当前页面输出的内容是不会在错误页面出现的。
a.jsp:
<%@ page import="java.util.*" pageEncoding="UTF-8"%>
<%@ page errorPage="b.jsp" %>
<%
if(true)
throw new Exception("哈哈~");
%>
b.jsp:
<%@ page pageEncoding="UTF-8"%>
<html>
<body>
<h1>出错啦!</h1>
</body>
</html>
在上面代码中,a.jsp抛出异常后,会请求转发到b.jsp。在浏览器的地址栏中还是a.jsp,因为是请求转发!
而且客户端浏览器收到的响应码为200,表示请求成功!如果希望客户端得到500,那么需要指定b.jsp为错误页面(page添加属性为:isErrorPage=”true”)。
<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<%@ page isErrorPage="true" %>
<html>
<body>
<h1>出错啦!</h1>
<%=exception.getMessage() %>
</body>
<!-- 设置b.jsp页面为错误页,在错误页中就可以使用exception隐藏对象了。-->
<!-- 注意:一旦转发到错误页,那么Tomcat会把状态码设置为500,而不在是200了。-->
</html>
注意,当isErrorPage为true时,说明当前JSP为错误页面,即专门处理错误的页面。那么这个页面中就可以使用一个内置对象exception了。其他页面是不能使用这个内置对象的!
温馨提示:IE会在状态码为500时,并且响应正文的长度小于等于512B时不给予显示!而是显示“网站无法显示该页面”字样。这时你只需要添加一些响应内容即可,例如上例中的b.jsp中我给出一些内容,IE就可以正常显示了!
5.web.xml中配置错误页面
不只可以通过JSP的page指令来配置错误页面,还可以在web.xml文件中指定错误页面。这种方式其实与page指令无关.在WEB-INF的web.xml中配置。
<error-page>
<error-code>404</error-code>
<location>/error404.jsp</location>
</error-page>
<error-page>
<error-code>500</error-code>
<location>/error500.jsp</location>
</error-page>
<error-page>
<exception-type>java.lang.RuntimeException</exception-type>
<location>/error.jsp</location><!--如果没有配置这个<error-page>,在抛出RuntimeException时会转发到error500.jsp页面。即匹配响应码500-->
</error-page>
<error-page>有两种使用方式:
- <error-code>和<location>子元素;
- <exception-type>和<location>子元素;
- 其中<error-code>是指定响应码;<location>指定转发的页面;<exception-type>是指定抛出的异常类型。
在上例中:
- 当出现404时,会跳转到error404.jsp页面;
- 当出现RuntimeException异常时,会跳转到error.jsp页面;
- 当出现非RuntimeException的异常时,会跳转到error500.jsp页面。
- 即当jsp发生错误时,处理错误页面的配置越详细就会让那个配置页面处理这个异常。也就是当出现非RuntimeException的异常时,会跳转到error500.jsp页面。有点像深度搜索。
- 注意:如果想要用这种配置WEB-INF/web.xml的方法捕获Servlet的异常,就不要用try-catch来处理异常,要直接抛出,否则在当前项目的WEB-INF/web.xml中配置的错误处理是捕获不到的。
这种方式会在控制台看到异常信息!而使用page指令时不会在控制台打印异常信息。
6.page指令的autFlush和buffer
- buffer表示当前JSP的输出流(out隐藏对象)的缓冲区大小,默认为8kb。
- authFlush表示在out对象的缓冲区满时如何处理!当authFlush为true时,表示缓冲区满时把缓冲区数据输出到客户端;当authFlush为false时,表示缓冲区满时,抛出异常。authFlush的默认值为true。
- 这两个属性一般我们也不会去特意设置,都是保留默认值!
7.page指令的isELIgnored
- page指令的isElIgnored属性表示当前JSP页面是否忽略EL表达式,默认值为false,表示不忽略(即支持)。
8.page指令的其他属性
- language:只能是Java,这个属性可以看出JSP最初设计时的野心!希望JSP可以转换成其他语言!但是,到现在JSP也只能转换成Java代码;
- info:JSP说明性信息;
- isThreadSafe:默认为false,为true时,JSP生成的Servlet会去实现一个过时的标记接口SingleThreadModel,这时JSP就只能处理单线程的访问;
- session:默认为true,表示当前JSP页面可以使用session对象,如果为false表示当前JSP页面不能使用session对象;
- extends:指定当前JSP页面生成的Servlet的父类;
9.<jsp-config>(了解)
在web.xml页面中配置也可以完成很多page指定的功能!
<jsp-config>
<jsp-property-group>
<url-pattern>*.jsp</url-pattern> //对所有jsp进行配置
<el-ignored>true</el-ignored> //忽略EL表达式
<page-encoding>UTF-8</page-encoding> //指定页面编码为utf-8
<scripting-invalid>true</scripting-invalid>//禁用Java脚本!如果在JSP页面中使用了Java脚本就会抛出异常。
</jsp-property-group>
</jsp-config>
二.include指令
include指令表示静态包含!即目的是把多个JSP合并成一个JSP文件!
include指令只有一个属性:file,指定要包含的页面,例如:<%@include file=”b.jsp”%>。
静态包含:当hel.jsp页面包含了lo.jsp页面后,在编译hel.jsp页面时,需要把hel.jsp和lo.jsp页面合并成一个文件,然后再编译成Servlet(Java文件)。
很明显,在ol.jsp中在使用username变量,而这个变量在hel.jsp中定义的,所以只有这两个JSP文件合并后才能使用。通过include指定完成对它们的合并!
三.taglib指令
这个指令需要在学习了自定义标签后才会使用,现在只能做了了解而已!
在JSP页面中使用第三方的标签库时,需要使用taglib指令来“导包”。例如:
<%@ taglib prefix=”c” uri=”http://java.sun.com/jsp/jstl/core” %>
其中prefix表示标签的前缀,这个名称可以随便起。uri是由第三方标签库定义的,所以你需要知道第三方定义的uri。当然uri也可以是绝对路径!