概述
JSP指令
在JSP中,指令(directive)控制JSP编译器生成Servlet的行为,它能够设置JSP页面相关的属性以及控制生成HTML内容。之前我们已经接触过不少指令,例如:
<%@ page import="java.util.*" %>
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
指令以<%@ directive attribute="value" %>
的形式存在于JSP源文件中,其中directive
可以是三种类型之一:
- 页面指令
page
——定义页面的属性,例如使用哪种语言(language
属性)、页面的contentType
以及编码方式(encoding
)、导入哪些包(import
) - 包含指令
include
——告知JSP编译器把另外一个文件内容完全包含至当前JSP文件中。效果就好像被包含文件的内容直接被粘贴到当前文件中一样,和C语言的预处理器非常类似。 - 标签库指令
taglib
——标签库指令描述了要使用的JSP标签库。该指令需要指定一个前缀prefix(和C++的命名空间很类似)和标签库的描述URI。JSTL是Java EE规范中定义的标准标签库,它需要通过标签库指令引用后才能在JSP文件中使用。
JSP动作
JSP动作(Action)是在JSP执行处理阶段完成特定功能的标签,和JSP指令元素不同的是,它是在请求处理阶段执行的,而指令则是在编译阶段被执行。利用JSP动作可以动态地包含其他文件、重定向页面等等,其中最常用的当属<jsp:include>
,它与包含指令的区别将会在下文提及。
JSP包含指令
包含指令能够把另外一个文件内容完全包含至当前JSP文件中,这是一种非常常用的组织页面的方式。在大多数网站中,不同的页面之中一定会存在公共的部分,例如博客系统的导航栏、底部版权声明。如果在每一个JSP页面中都重复的编写一次显然是不可取的,那么通过JSP的包含指令将这些公共的内容抽取在单独的JSP文件中,既减少了重复代码的数量,也提高了页面文件的维护性——只需要修改一处地方即可让所有包含它的页面生效。
使用包含指令非常的简单,以博客底部版权声明为例,将页面中导航栏部分提取到一个单独的nav.jsp
中:
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core"%>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions"%>
<nav class="navbar navbar-inverse navbar-fixed-top">
...
</nav>
在需要引用它的JSP文件中,通过include
指令引入:
<%@include file="nav.jsp" %>
这里file
属性的值是相对于当前文件的相对路径,一般来说我们会将这些公共的JSP文件单独放在一个目录中。
同样的道理,<head>
标签中的各类静态资源定义、底部页面版权信息声明也可以抽取到公共文件中,那么对于任意一个页面,它的结构是固定的:
<%@page import="java.util.ArrayList"%>
<%@page import="java.util.List"%>
<%@ page language="java" contentType="text/html; charset=utf-8" pageEncoding="utf-8"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
<%@ taglib prefix="fn" uri="http://java.sun.com/jsp/jstl/functions" %>
<html>
<head>
<%@include file="common/head.jsp" %>
</head>
<body>
<%@include file="common/nav.jsp" %>
<%@include file="common/footer.jsp" %>
</body>
</html>
在nav
和footer
中间就是页面的主体内容。在在很多情况下,可能只有个别页面(2-3个)存在公共的内容,这种情况下也需要将他们抽取出来。
jsp:include
动作
jsp:include
是JSP内置的一个动作标签,和JSP的包含指令很类似,它的作用同样是将其他JSP文件的内容包含至当前页面:
<jsp:include page="common/head.jsp" />
和包含指令不同的是,jsp:include
在每次请求当前JSP文件的时候,才将目标JSP文件包含进来(而包含指令则是在编译时)。它还能够支持动态的引入:
<jsp:include page="file_name">
<jsp:param name="parameter_name" value="parameter_value" />
</jsp:include>
通过jsp:param
标签,可以将某个参数传给目标JSP文件。在目标JSP文件中,parameter_name
变量就可以像普通上下文中的变量一样被使用:${parameter_name}
。
由于这样的动态支持,jsp:include
动作能够支持更加灵活的场景,这是包含指令所不能做到的。针对包含指令和jsp:include
动作的特点,可以归纳出他们的使用场景:
- 引入静态内容(例如HTML中
<head>
部分的静态资源,页面底部信息)时,使用包含指令 - 引入动态内容(特别是需要参数化渲染的页面)时使用
jsp:include动作
例子:侧边栏用户信息片段
在博客系统文章列表页面,右侧包含了当前博客的用户信息:
同样,在创建文章页面,也有类似的片段,它包含的是当前用户的信息:
二者的片段内容非常相似,都是将一个User
对象渲染成同样的HTML片段,那么可以将这一部分公共内容抽取至JSP中:
<div class="sidebar-module sidebar-module-inset">
<div class="avatar">
<img class="img-circle img-rounded img-thumbnail avatar" src="${user.avatar}">
<div>
<h4>${user.title}</h4>
</div>
</div>
<p>${user.description}</p>
</div>
在博客列表页面,当前博客的拥有者信息是存放在user
变量中:
<jsp:include page="common/userInfo.jsp">
<jsp:param name="user" value="${user}" />
</jsp:include>
而在创建博文页面,当前用户信息存放在Session中:
<jsp:include page="common/userInfo.jsp">
<jsp:param name="user" value="${sessionScope.user}" />
</jsp:include>
更多文章请访问天码营网站