概述

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>

navfooter中间就是页面的主体内容。在在很多情况下,可能只有个别页面(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动作的特点,可以归纳出他们的使用场景:

  1. 引入静态内容(例如HTML中<head>部分的静态资源,页面底部信息)时,使用包含指令
  2. 引入动态内容(特别是需要参数化渲染的页面)时使用jsp:include动作

例子:侧边栏用户信息片段

在博客系统文章列表页面,右侧包含了当前博客的用户信息:

Clipboard Image.png

同样,在创建文章页面,也有类似的片段,它包含的是当前用户的信息:

Clipboard Image.png

二者的片段内容非常相似,都是将一个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>

登录发表评论 注册

反馈意见