JSP Элементы действий
В отличие от элементов директив JSP, элементы действий JSP вступают в силу на этапе обработки запроса. Элементы действий JSP записываются с использованием синтаксиса XML.
Используя действия JSP, можно динамически вставлять файлы, повторно использовать компоненты JavaBean, перенаправлять пользователей на другую страницу и генерировать HTML-код для плагинов Java.
У элементов действий есть только один синтаксис, соответствующий стандарту XML:
<jsp:action_name attribute="value" />
Элементы действий — это в основном предопределённые функции. Спецификация JSP определяет ряд стандартных действий, которые используют JSP в качестве префикса. Доступные стандартные элементы действий приведены ниже:
| Синтаксис | Описание |
|---|---|
| jsp:include | Включает файл при запросе страницы. |
| jsp:useBean | Находит или создает экземпляр JavaBean. |
| jsp:setProperty | Устанавливает свойства JavaBean. |
| jsp:getProperty | Выводит свойство JavaBean. |
| jsp:forward | Перенаправляет запрос на новую страницу. |
| jsp:plugin | Генерирует теги OBJECT или EMBED для Java-плагинов в зависимости от типа браузера. |
| jsp:element | Определяет динамические XML-элементы |
| jsp:attribute | Задает атрибуты динамически определяемых XML-элементов. |
| jsp:body | Задает содержимое динамически определяемых XML-элементов. |
| jsp:text | Использует шаблоны для записи текста на страницах и в документах JSP. |
Общие атрибуты
Все элементы действий имеют два атрибута: атрибут id и атрибут scope.
- атрибут id:
Атрибут id — это уникальный идентификатор элемента действия, на который можно ссылаться на страницах JSP. Значение id, созданное элементом действия, можно получить через PageContext.
- атрибут scope:
Этот атрибут используется для определения жизненного цикла элемента действия. Атрибут id и атрибут scope напрямую связаны; атрибут scope определяет время жизни связанного объекта id. Атрибут scope имеет четыре возможных значения: (a) page, (b) request, (c) session и (d) application.
Элемент действия <jsp:include>
Элемент действия <jsp:include> используется для включения статических и динамических файлов. Это действие вставляет указанный файл в создаваемую страницу. Формат синтаксиса следующий:
<jsp:include page="相对 URL 地址" flush="true" />
Ранее мы представили директиву include, которая включает файлы, когда JSP-файл преобразуется в Servlet. В отличие от неё, действие jsp:include здесь отличается; оно вставляет файлы, когда страница запрашивается.
Ниже приведён список атрибутов, связанных с действием include.
| Attribute | Описание |
|---|---|
| page | Относительный URL-адрес, который должен быть включён в страницу. |
| flush | Логический атрибут, определяющий, следует ли очищать буфер перед включением ресурса. |
Пример
Ниже мы определяем два файлаdate.jspиmain.jsp, код выглядит следующим образом:
Код файла date.jsp:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<p>
今天的日期是: <%= (new java.util.Date()).toLocaleString()%>
</p>
Код файла main.jsp:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<h2>include 动作实例</h2>
<jsp:include page="date.jsp" flush="true" />
</body>
</html>
Теперь поместите два указанных выше файла в корневой каталог сервера и обратитесь к файлу main.jsp. Отображаемый результат выглядит следующим образом:
include 动作实例 今天的日期是: 2016-6-25 14:08:17
Элемент действия <jsp:useBean>
jsp:useBeanЭто действие используется для загрузки JavaBean, который будет использоваться на странице JSP.
Эта возможность очень полезна, поскольку позволяет нам использовать преимущества повторного использования Java-компонентов.
Простейший синтаксис действия jsp:useBean:
<jsp:useBean id="name" class="package.class" />
После загрузки класса мы можем изменять и получать свойства bean-компонента с помощью действий jsp:setProperty и jsp:getProperty.
Ниже приведён список атрибутов, относящихся к действию useBean.
| Attribute | Описание |
|---|---|
| класс | Указывает полное имя пакета Bean-компонента. |
| type | Указывает тип переменной, которая будет ссылаться на этот объект. |
| beanName | Указывает имя Bean-компонента с помощью метода instantiate() класса java.beans.Beans. |
Прежде чем приводить конкретные примеры, давайте сначала рассмотрим элементы действий jsp:setProperty и jsp:getProperty:
<jsp:setProperty> — элемент действия
jsp:setProperty используется для установки свойств уже созданного экземпляра Bean-объекта. Есть два варианта использования. Во-первых, можно использовать jsp:setProperty вне (после) элемента jsp:useBean, как показано ниже:
<jsp:useBean id="myName" ... /> ... <jsp:setProperty name="myName" property="someProperty" .../>
В этом случае, независимо от того, находит ли jsp:useBean существующий Bean или создаёт новый экземпляр Bean, jsp:setProperty будет выполнен. Второй вариант использования — разместить jsp:setProperty внутри элемента jsp:useBean, как показано ниже:
<jsp:useBean id="myName" ... > ... <jsp:setProperty name="myName" property="someProperty" .../> </jsp:useBean>
В этом случае jsp:setProperty выполняется только при создании нового экземпляра Bean; если используется существующий экземпляр, jsp:setProperty не выполняется.
Действие jsp:setProperty имеет следующие четыре атрибута, как показано в таблице ниже:
| Attribute | Описание |
|---|---|
| name | Атрибут name является обязательным. Он указывает, свойства какого Bean должны быть установлены. |
| property | Атрибут property является обязательным. Он указывает, какое свойство нужно установить. Есть особый случай использования: если значение property равно "*", это означает, что все параметры запроса, имена которых совпадают с именами свойств Bean, будут переданы соответствующим методам-установщикам свойств. |
| value | Атрибут value является необязательным. Этот атрибут используется для указания значения свойства Bean. Строковые данные будут автоматически преобразованы в числовые типы, а также типы boolean, Boolean, byte, Byte, char, Character в целевом классе через стандартный метод valueOf. Например, значения свойств типов boolean и Boolean (такие как "true") преобразуются с помощью Boolean.valueOf, а значения свойств типов int и Integer (такие как "42") преобразуются с помощью Integer.valueOf. value и param нельзя использовать одновременно, но можно использовать любой из них. |
| param | Атрибут param является необязательным. Он указывает, какой параметр запроса использовать в качестве значения свойства Bean. Если в текущем запросе нет параметра, ничего не делается; система не будет передавать null методу-установщику свойства Bean. Поэтому вы можете позволить Bean предоставлять собственные значения свойств по умолчанию и изменять значения по умолчанию только тогда, когда параметр запроса явно задаёт новое значение. |
Элемент действия <jsp:getProperty>
Действие jsp:getProperty извлекает значение указанного свойства Bean, преобразует его в строку и затем выводит. Формат синтаксиса следующий:
<jsp:useBean id="myName" ... /> ... <jsp:getProperty name="myName" property="someProperty" .../>
В следующей таблице перечислены атрибуты, связанные с getProperty:
| Attribute | Описание |
|---|---|
| name | Имя свойства Bean, которое требуется извлечь. Bean должен быть уже определён. |
| property | Указывает значение свойства Bean, которое должно быть извлечено. |
Пример
В следующем примере мы используем Bean:
package com.example.main;
public class TestBean {
private String message = "Example";
public String getMessage() {
return(message);
}
public void setMessage(String message) {
this.message = message;
}
}
Скомпилируйте приведённый выше файл примера TestBean.java:
$ javac TestBean.java
После компиляции в текущем каталоге будет создан файлTestBean.class. Скопируйте этот файл в каталогWebContent/WEB-INF/classes/com/example/mainтекущего JSP-проекта (путь пакета com/example/main, создайте его вручную, если он не существует).
Ниже показана схема структуры каталогов в Eclipse:

Ниже приведен очень простой пример, функция которого — загрузить Bean, а затем установить/прочитать его свойство message.
Теперь давайте вызовем этот Bean в файле main.jsp:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<h2>Jsp 使用 JavaBean 实例</h2>
<jsp:useBean id="test" class="com.example.main.TestBean" />
<jsp:setProperty name="test"
property="message"
value="Example..." />
<p>输出信息....</p>
<jsp:getProperty name="test" property="message" />
</body>
</html>
Откройте через браузер, выполните вышеуказанный файл, и вывод будет следующим:

<jsp:forward> Элемент действия
Действие jsp:forward пересылает запрос на другую страницу. Тег jsp:forward имеет только один атрибут — page. Формат синтаксиса следующий:
<jsp:forward page="相对 URL 地址" />
Ниже перечислены атрибуты, связанные с forward:
| Attribute | Описание |
|---|---|
| page | Атрибут page содержит относительный URL. Значение page можно задать напрямую или вычислить динамически во время запроса. Это может быть JSP-страница или Java Servlet. |
Пример
В следующем примере мы используем два файла: date.jsp и main.jsp.
Код файла date.jsp выглядит следующим образом:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<p>
今天的日期是: <%= (new java.util.Date()).toLocaleString()%>
</p>
Код файла main.jsp:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<h2>forward 动作实例</h2>
<jsp:forward page="date.jsp" />
</body>
</html>
Теперь поместите два указанных выше файла в корневой каталог сервера и обратитесь к файлу main.jsp. Отображаемый результат выглядит следующим образом:
今天的日期是: 2016-6-25 14:37:25
Элемент действия <jsp:plugin>
Действие jsp:plugin используется для вставки элементов или EMBED, необходимых для запуска Java-апплетов через плагин Java, в зависимости от типа браузера.
Если требуемый плагин отсутствует, он загружает плагин, а затем выполняет Java-компонент. Java-компонент может быть апплетом или JavaBean.
Действие plugin имеет несколько атрибутов, соответствующих HTML-элементам для форматирования Java-компонента. Элемент param можно использовать для передачи параметров апплету или бину.
Ниже приведён типичный пример использования элемента действия plugin:
<jsp:plugin type="applet" codebase="dirname" code="MyApplet.class"
width="60" height="80">
<jsp:param name="fontcolor" value="red" />
<jsp:param name="background" value="black" />
<jsp:fallback>
Unable to initialize Java Plugin
</jsp:fallback>
</jsp:plugin>
Если вам интересно, вы можете попробовать использовать апплет для проверки элемента действия jsp:plugin. Элемент <fallback> — это новый элемент, который отправляет пользователю сообщение об ошибке при сбое компонента.
Элементы действия <jsp:element>, <jsp:attribute>, <jsp:body>
Элементы действия <jsp:element>, <jsp:attribute> и <jsp:body> динамически определяют XML-элементы. Динамичность очень важна: это означает, что XML-элементы динамически генерируются во время компиляции, а не статически.
В следующем примере динамически определяются XML-элементы:
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Example(example.com)</title>
</head>
<body>
<jsp:element name="xmlElement">
<jsp:attribute name="xmlElementAttr">
属性值
</jsp:attribute>
<jsp:body>
XML 元素的主体
</jsp:body>
</jsp:element>
</body>
</html>
Когда браузер открывает следующую страницу, результат вывода будет следующим:
Элемент действия <jsp:text>
Элемент действия <jsp:text> позволяет использовать текстовые шаблоны в JSP-страницах и документах. Синтаксис имеет следующий вид:
<jsp:text>模板数据</jsp:text>
Приведённый выше текстовый шаблон не может содержать повторяющиеся элементы, только текст и EL-выражения (примечание: EL-выражения будут рассмотрены в следующих главах). Обратите внимание, что в XML-файлах нельзя использовать выражения вроде ${whatever > 0}, поскольку символ > недопустим. Можно использовать выражение ${whatever gt 0} или значение, встроенное в секцию CDATA.
<jsp:text><![CDATA[<br>]]></jsp:text>
Если вам нужно объявить DOCTYPE в XHTML, необходимо использовать элемент действия <jsp:text>. Пример:
<jsp:text><![CDATA[<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"DTD/xhtml1-strict.dtd">]]>
</jsp:text>
<head><title>jsp:text action</title></head>
<body>
<books><book><jsp:text>
Welcome to JSP Programming
</jsp:text></book></books>
</body>
</html>
Для приведённого выше примера вы можете попробовать разницу между использованием <jsp:text> и неиспользованием этого элемента действия.
Другие расширения