JSP的三大指令

痛定思痛。 2021-06-24 16:12 557阅读 0赞

# JSP指令 #

JSP指令的格式：`<%@指令名 attr1=”” attr2=”” %>`，一般都会把JSP指令放到JSP文件的最上方，但这不是必须的。  
在一个.jsp页面里，可以有0~N个指令的定义。  
JSP中有三大指令：page、include、taglib，最为常用，也最为复杂的就是page指令了。

## 1. page指令 ##

page指令是最为常用的指定，也是属性最多的属性！  
page指令没有必须属性，都是可选属性。例如<%@page %>，没有给出任何属性也是可以的！  
在JSP页面中，任何指令都可以重复出现！  
`<%@ page language=”java”%>`  
`<%@ page import=”java.util.*”%>`  
`<%@ page pageEncoding=”utf-8”%>`  
上面这样也是可以的。

### ① pageEncoding和contentType ###

**pageEncoding指定当前JSP页面的编码。** 这个编码是给服务器看的，服务器需要知道当前JSP使用的编码，不然服务器无法正确把JSP编译成java文件。所以这个编码只需要与真实的页面编码一致即可。*在MyEclipse中，在JSP文件上点击右键，选择属性就可以看到当前JSP页面的编码了。*  
**contentType属性与response.setContentType()方法的作用相同。** 它会完成两项工作，一是设置响应字符流的编码，二是设置content-type响应头。例如：`<%@ contentType=”text/html;charset=utf-8”%>`，就相当于编译生成的.java文件中的`response.setContentType(“text/html;charset=utf-8”)`。

要注意的一点是，当pageEncoding和contentType只出现一个时，那么另一个的值与出现的值相同：

*  当设置了pageEncoding，而没设置contentType时： contentType的默认值为pageEncoding的值；
 *  当设置了contentType，而没设置pageEncoding时： pageEncoding的默认值与contentType相同；

但是如果两个都不出现，那么两个属性的值都是ISO-8859-1。所以我们至少设置它们两个其中一个。

### ② import ###

import是page指令中一个很特别的属性。  
**import属性值对应.java文件中的import语句。**  
import属性值可以使逗号：  
`<%@page import=”java.net.*,java.util.*,java.sql.*”%>`

import属性是唯一可以重复出现的属性：  
`<%@page import=”java.util.*” import=”java.net.*” import=”java.sql.*”%>`  
但是，我们一般会使用多个page指令来导入多个包：

<%@ page import="java.util.*"%>
    <%@ page import="java.net.*"%>
    <%@ page import="java.text.*"%>

### ③ errorPage和isErrorPage ###

**使用page指令的`errorPage`来指定错误页。** 我们知道，在一个JSP页面出错后，Tomcat会响应给用户错误信息（500）。如果你不希望Tomcat给用户输出错误信息，那么可以使用page指令的`errorPage`来指定错误页！也就是自定义错误页面，例如：`<%@ page errorPage=”xxx.jsp”%>`。这时，在当前JSP页面出现错误时，会请求转发到xxx.jsp页面。  
**`isErrorPage`的作用呢，我们看下面这个例子。**

我们举一个例子：  
a.jsp:

<%@ page errorPage="b.jsp"%>
    <%
    	if (true) { 
    		throw new Exception("hahahahah~");
    	}
    %>

我们在a.jsp中设置了错误页面为b.jsp。  
b.jsp:

我们访问a.jsp试一下：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70]  
这里，a.jsp抛出异常后，请求转发到b.jsp。因为是请求转发，在浏览器中的地址栏中还是a.jsp。而且在客户端浏览器中收到的响应码是200，表示请求成功，这太奇怪了，不符合我们正常的逻辑。

这个时候，如果我们希望客户端收到500状态码，我们就要指定b.jsp为错误页面，也就是用`isErrorPage`。格外注意的一点是，当isErrorPage为true时，说明当前JSP为错误页面，即专门处理错误的页面。那么这个页面中就可以使用一个内置对象exception了。其他页面是不能使用这个内置对象的。  
例如b.jsp我们可以添加一些代码：

<%@ page isErrorPage="true" %> 
    <%=exception.getMessage()%>

这个时候我们在访问a.jsp：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 1]

#### 补充：web.xml中配置错误页面 ####

我们在这里补充一点。不只可以通过JSP的page指令来配置错误页面，还可以在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>

**`<error-page>`有两种使用方式：**  
①`<error-code>`和`<location>`子元素；  
②`<exception-type>`和`<location>`子元素。

**其中`<error-code>`是指定响应码；`<location>`指定转发的页面；`<exception-type>`是指定抛出的异常类型。**  
在上例中：  
当出现404时，会跳转到error404.jsp页面；  
当出现RuntimeException异常时，会跳转到error.jsp页面；  
当出现非RuntimeException的异常时，会跳转到error500.jsp页面。  
　　  
***这种方式会在控制台看到异常信息！而使用page指令时不会在控制台打印异常信息。***

### ④ autFlush 和 buffer ###

`buffer`表示当前JSP的输出流（out隐藏对象）的缓冲区大小，**默认为8kb**。

`autoFlush`表示在out对象的缓冲区满时如何处理。  
当autoFlush为true时，表示缓冲区满时把缓冲区数据输出到客户端；  
当autoFlush为false时，表示缓冲区满时，抛出异常。  
**autoFlush的默认值为true**。

这两个属性一般我们也不会去特意设置，都是保留默认值！

### ⑤ isELIgnored ###

page指令的`isELIgnored`属性表示当前JSP页面是否忽略EL表达式，默认值为false，表示不忽略，即支持。

### ⑥ 其他的几个属性 ###

*  `language`：指定当前jsp编译后的语言类型，默认值为Java。但是，到现在JSP也只能转换成Java代码。（ ￣□￣ ）
 *  `info`：JSP说明性信息；
 *  `isThreadSafe`：当前的jsp是否支持并发访问。默认为false。为true时，JSP生成的Servlet会去实现一个过时的标记接口SingleThreadModel，这时JSP就只能处理单线程的访问；
 *  `session`：默认为true，表示当前JSP页面可以使用session对象，如果为false表示当前JSP页面就没有session对象；
 *  `extends`：指定当前JSP页面生成的Servlet的父类。让jsp生成的servlet继承指定的类。

这些属性几乎都没用。o(╥﹏╥)o

## 2. include指令 ##

include指令表示静态包含，即目的是把多个JSP合并成一个JSP文件。  
include指令只有一个属性：file，指定要包含的页面，例如：`<%@include file="b.jsp"%>`。  
静态包含：例如，当hel.jsp页面包含了lo.jsp页面后，在编译hel.jsp页面时，需要把hel.jsp和lo.jsp页面合并成一个文件，然后再编译成Servlet（Java文件）。

**我们做一个实例：**  
hel.jsp：

<%
    	String name = "veeja";
    %>
    <%@include file="lo.jsp"%>

lo.jsp：

<%
    	out.print("my name is " + name);
    %>

这时我们在浏览器访问hel.jsp：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 2]  
很明显，在lo.jsp中在使用name变量，而这个变量在hel.jsp中定义的，所以只有这两个JSP文件合并后才能使用。通过include指定完成对它们的合并。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 3]

## 3. tablib指令 ##

这个指令需要在学习了自定义标签后才会使用。  
在JSP页面中使用第三方的标签库时，需要使用taglib指令来“导包”。例如：  
`<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>`  
其中prefix表示标签的前缀，这个名称我们可以自己定义。  
uri是由第三方标签库定义的，所以你需要知道第三方定义的uri。

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

END.

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70]: /images/20210615/f4382588f1c741dc966cf499057ee5de.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 1]: /images/20210615/4418c6e04b5947bf900c1cf539e8463b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 2]: /images/20210615/c9aecf8f9728442395baa33f4bec8194.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3UwMTQ1NjUxMjc_size_16_color_FFFFFF_t_70 3]: /images/20210615/a29ad3e74c484ae9bcfd71592bbf1902.png