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> и неиспользованием этого элемента действия.

Другие расширения