П риложение 6
STRUTS
Проект Struts был запущен в мае 2000 г. К. Макклэнаном (Craig R. McClanahan) для обеспечения возможности разработки приложений с архитектурой, базирующейся на парадигме Model/View/Controller. В июле 2001 г. был выпущен первый релиз Struts 1.0. Struts является частью проекта Jakarta, поддерживаемого Apache Software Foundation. Цель проекта Jakarta Struts – разработка среды с открытым кодом для создания Web-приложений с помощью технологий Java Servlet and JSP.
Шаблон проектирования MVC (Model-View-Controller)
При использовании шаблона MVC поток выполнения приложения всегда обязан проходить через контроллер приложения. Контроллер направляет запросы – в данном случае HTTP(S)-запросы – к соответствующему обработчику. Обработчики запроса связаны с бизнес-моделью, и в итоге каждый разработчик приложения должен только обеспечить взаимодействие между запросом и бизнес-моделью. В результате реакции системы на запрос вызывается соответствующая JSP-страница, выполняющая в данной схеме роль представления.
В результате модель отделена от представления, и все связывающие их команды проходят через контроллер приложения. Приложение, соответствующее этим принципам, становится более понятным с точки зрения разработки, поддержки и совершенствования, а отдельные его части довольно легко могут быть использованы повторно.
Состав Struts
Согласно шаблону Model/View/Controller, Struts имеет три основных компонента: сервлет-контроллер, который входит в Struts, JSP-страницы и бизнес-логику приложения.
Загрузить последнюю версию struts-2.0.9-bin.zip можно по адресу:
http://struts.apache.org
Три основных класса, задействованные при обработке запроса:
org.apache.struts.action.ActionServlet – класс, связывающий между собой все части MVC-шаблона;
org.apache.struts.action.Action – класс-обработчик запроса;
org.apache.struts.action.ActionForm – класс, предназначенный для получения данных, которые приходят с клиентской стороны? либо для их отображения в браузере пользователя.
Запрос к серверу обрабатывается классом-контроллером ActionServlet в соответствии с настройками в файле web.xml. Запрос на сервер выполняет пользователь нажатием кнопки Submit, введением URL в поле браузера, вызовом submit-формы на JavaScript и пр. Во время инициализации главный контроллер считывает (parse) конфигурационный файл struts-config.xml, который однозначно определяет все соответствия и альтернативы для всех запросов данного приложения и упаковывает их в объект класса
org.apache.struts.action.ActionMapping.
Для запроса контроллер находит соответствующие ему ActionForm- и Action-классы. Первым создается ActionForm, если такой объект еще не создавался и не находится ни в одной из областей видимости (сессия, запрос). Далее поля объекта ActionForm заполняются данными, которые пришли с запросом, т.е. для каждого параметра, содержащегося в запросе, вызывается соответствующий set-метод. Например, если в запросе есть параметр login=goch, то в ActionForm будет вызван метод setLogin() с передачей значения параметра. В Struts существует возможность заполнения структуры объектов. Пусть в ActionForm с помощью методов setCompany() и getCompany() передается объект класса Company, полем которого является коллекция объектов типа Employee, для каждого из которых определено поле типа Address. Тогда для заполнения поля адреса одного из работников достаточно присутствия параметра company.employees[n].address.phone, что приведет к последовательному вызову следующих методов:
getCompany().getEmployees().getItem(n).getAddress().setPhone().
Заполнив форму данными, сервлет-контроллер Struts направляет HTTP-запрос к соответствующему запрашиваемому URL-наследнику класса Action.
Создается только один экземпляр Action для всех пользователей, поэтому глобальные переменные должны быть синхронизированы либо ограничены в использовании, передавая в метод execute() заполненный объект ActionForm и ActionMapping. Класс Action отвечает за вызов Model и перенаправление к необходимому элементу View в зависимости от результата действия.
Модель инкапсулирует бизнес-логику приложения. Управление обычно передается обратно через контроллер соответствующему представлению, этот вызов соответствует запросу JSP-страницы. Перенаправление осуществляется путем обращения к набору соответствий (mappings) между бизнес-моделью и представлением. Предложенная схема обеспечивает слабое связывание (Low Coupling) между представлением и бизнес-моделью, что делает разработку и поддержку приложения значительно проще.
JSP-страница представления состоит, как правило, из статического HTML-кода, а также из динамического содержания, основанного на инициализации в запросе специальных тегов действий (action tags). Среда Struts включает большой и разнообразный набор стандартных тегов действий, назначение которых описано в спецификации Struts. Кроме того, существует стандартное средство для определения своих собственных тегов.
Простое приложение
Приведенный в главе «Java Server Pages» пример распределенного приложения входа в систему с проверкой логина и пароля можно легко переписать с использованием технологии Struts. Следует обратить внимание на то, что использование технологии Struts упрощает организацию приложения, поэтому диаграмма классов будет выглядеть проще.
Рис. 1. Диаграмма взаимодествия классов и JSP в Struts-приложении.
/* пример # 1: Action класс : LoginAction.java */
package by.bsu.famcs.jspservlet;
import java.io.IOException;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.apache.struts.action.Action;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionForward;
import org.apache.struts.action.ActionMapping;
import org.apache.struts.action.ActionMessage;
import org.apache.struts.action.ActionMessages;
public class LoginAction extends Action {
public ActionForward execute(ActionMapping mapping,
ActionForm form, HttpServletRequest request, HttpServletResponse response)
throws IOException, ServletException {
ActionMessages errors = new ActionMessages();
LoginForm actionForm = (LoginForm)form;
String login = actionForm.getLogin();
String password = actionForm.getPassword();
if (login != null && password != null) {
if (LoginLogic.checkLogin(login, password)) {
return mapping.findForward("success");
} else {
errors.add(ActionMessages.GLOBAL_MESSAGE,
new ActionMessage("error.login.incorrectLoginOrPassword"));
saveErrors(request, errors);
}
}
//загрузка формы для логина
return mapping.findForward("loginAgain");
}
}
Класс LoginForm, объект которого представляет форму, соответствующую странице ввода логина и пароля, выглядит следующим образом:
/* пример # 2: класс хранения информации, передаваемой из login.jsp :
LoginForm.java */
package by.bsu.famcs.jspservlet;
import javax.servlet.http.HttpServletRequest;
import org.apache.struts.action.ActionForm;
import org.apache.struts.action.ActionMapping;
public class LoginForm extends ActionForm {
private String login;
private String password;
//очищение полей формы
public void reset(ActionMapping mapping,
HttpServletRequest request) {
super.reset(mapping, request);
this.password = null;
}
public String getLogin() {
return login;
}
public String getPassword() {
return password;
}
public void setLogin(String login) {
this.login = login;
}
public void setPassword(String password) {
this.password = password;
}
}
Класс LoginLogic, представляющий бизнес-логику, не был изменен. Его необходимо перенести в соответствующую папку данного проекта Struts. Класс ConfigurationManagerизменился в сторону уменьшения атрибутов, так как часть информации хранится теперь в struts-config.xml.
/*пример # 3: служебный класс, извлекающий из файла config.properties информацию о драйвере и расположении БД : ConfigurationManager.java */
package by.bsu.famcs.jspservlet.manager;
import java.util.ResourceBundle;
public class ConfigurationManager {
private static ConfigurationManager instance;
private ResourceBundle resourceBundle;
private static final String BUNDLE_NAME = "config";
public static final String DATABASE_DRIVER_NAME = "DATABASE_DRIVER_NAME";
public static final String DATABASE_URL = "DATABASE_URL";
public static ConfigurationManager getInstance() {
if (instance == null) {
instance = new ConfigurationManager();
instance.resourceBundle =
ResourceBundle.getBundle(BUNDLE_NAME);
}
return instance;
}
public String getProperty(String key) {
return (String)resourceBundle.getObject(key);
}
}
Далее приведено содержимое файла config.properties:
###############################
## Application configuration ##
###############################
DATABASE_DRIVER_NAME=com.mysql.jdbc.Driver
DATABASE_URL=jdbc:mysql://localhost:3306/db1?user=
root&password=pass
JSP-страницы были изменены следующим образом:
<%--пример # 4: стартовая страница в оформлении Struts :index.jsp --%>
<%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
Transitional//EN">
<html><head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>Index JSP</title>
</head>
<body>
<a href="login.do">Controller</a>
</body></html>
<%--пример # 5: страница запроса логина и пароля :login.jsp --%>
<%@ page language="java" contentType="text/html;
charset=ISO-8859-1" pageEncoding="ISO-8859-1"%>
<%-- Подключение библиотек тегов Struts--%>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
Transitional//EN">
<html:html locale="true">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<%-- вывод сообщения из .properties проекта --%>
<title><bean:message key="jsp.login.title"/></title>
<%-- генерируется тег <base> с атрибутом href, в котором будет URL текущего application. При этом все относительные ссылки на странице ответа отсчитываются от этого значения
--%>
<html:base />
</head>
<body>
<h3><bean:message key="jsp.login.header"/></h3>
<hr/><%-- форма для логина --%>
<html:form action="/login" method="POST">
<bean:message key="jsp.login.field.login"/>:<br>
<%-- текстовое поле для имени пользователя --%>
<html:text property="login"/><br>
<bean:message key="jsp.login.field.password"/>:<br>
<%-- текстовое поле для пароля пользователя --%>
<html:password property="password"
redisplay="false"/><br>
<html:submit><bean:message
key="jsp.Login.button.submit"/> </html:submit>
</html:form>
<%-- пользовательский тег для отображения ошибок списком, открывающие/закрывающие значения которого берутся из файла ресурсов --%>
<html:errors/>
<hr/>
</body>
</html:html>
Следует обратить внимание на пользовательские теги вида
<bean:message key="jsp.login.header"/>,
которые выводят текст, предварительно размещенный в специальном файле ApplicationResources.properties. В этом файле хранятся все статические текстовые данные, которые извлекаются по ключу, указанному в свойстве пользовательского тега key. Например, в LoginAction при создании объектов ошибок в их конструкторе был указан ключ, по которому в этом файле берется текст ошибки:
errors.add(ActionMessages.GLOBAL_MESSAGE,
new ActionMessage("error.login.incorrectLoginOrPassword"));
Для данного приложения файл ресурсов может быть создан в виде:
# пример # 6: файл ресурсов : ApplicationResources.properties
# header и footer, которые будут использоваться для
# обрамления ошибок, выдаваемых тегом <errors/>.
errors.header=<ul>
errors.footer=</ul>
errors.prefix=<li>
errors.suffix=</li>
# разметка для элемента списка ошибок из <errors/>,
# который указывает, что логин или пароль неверны.
error.login.incorrectLoginOrPassword=<li>incorrect login or password</li>
# текстовая информация на login.jsp
jsp.login.title=Login
jsp.login.header=Login
jsp.login.field.login=Login
jsp.login.field.password=Password
jsp.login.button.submit=Enter
# текстовая информация на main.jsp
jsp.main.title=Welcome
jsp.main.header=Welcome
jsp.main.hello=Hello
# текстовая информация на error.jsp
jsp.error.title=Error
jsp.error.header=Error
jsp.error.returnToLogin=Return to login page
Имя и месторасположение этого файла настраиваются в struts-config.xml, который является основным конфигурационным файлом для приложения, построенного на основе Struts.
пример # 7: конфигурация action, forward, resource и т.д. : struts-config.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE struts-config PUBLIC "-//Apache
Software Foundation//DTD Struts Configuration 1.2//EN"
"http://jakarta.apache.org/struts/dtds/struts-config_1_2.dtd">
<struts-config>
<data-sources>
<!--источники данных к БД. Как правило, это организация пула соединений. Пример приведен в конце раздела-->
</data-sources>
<!-- ========== Form Bean Definitions -->
<form-beans>
<form-bean name="loginForm"
type="by.bsu.famcs.jspservlet.LoginForm" />
</form-beans>
<!-- ============== Global Exception Definitions (если есть)-->
<global-exceptions>
</global-exceptions>
<!-- ============== Global Forward Definitions(если есть) -->
<global-forwards>
</global-forwards>
<!-- =============== Action Mapping Definitions -->
<action-mappings>
<!-- Action для процесса логина -->
<action name="loginForm"
path="/login"
scope="request" <!—- Задается область видимости формы. Часто необходимо, чтобы форма лежала в сессии, а не в запросе. -->
type="by.bsu.famcs.jspservlet.LoginAction"
validate="false">
<!-- форварды на JSP, доступные из данного action -->
<forward name="againlogin" path="/WEB-INF/jsp/login.jsp" />
<forward name="success" path="/WEB-INF/jsp/main.jsp" />
</action>
</action-mappings>
<!-- =================== Message Resources Definitions -->
<!-- имя файла ресурсов .properties, в котором будет храниться вся статическая текстовая информация для приложения. Путь берется относительно папки classes. -->
<message-resources parameter=
"resources.ApplicationResources"/>
</struts-config>
В теге <action> при помощи параметра path со значением /login связываются страница JSP и класс ActionForm, ей соответствующий. Это значение указывается в login.jsp в теге FORM ACTION. Далее прописывается путь к сервлету, в который и будет передана вся информация, извлеченная из запроса. В теге <forward> размещаются имена, в частности success и login, ассоциированные с путями вызова страниц /jsp/login.jsp и /jsp /main.jsp соответственно. Указанные имена передаются в метод findForward() класса ActionMapping в качестве параметра при различных вариантах завершения работы сервлета.
Файл web.xml в проекте также обязательно присутствует и должен указывать на месторасположение главного сервлета ActionServlet и файла struts-config.xml, а также указывать servlet-mapping для контроллера.
пример # 8: конфигурационный файл приложения : web.xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app id="WebApp">
<display-name>Study</display-name>
<!-- настройка стандартного контроллера Struts – сервлета ActionServlet -->
<servlet>
<servlet-name>action</servlet-name>
<servlet-class>
org.apache.struts.action.ActionServlet</servlet-class>
<!-- месторасположение основного настроечного файла Struts – struts-config.xml -->
<init-param>
<param-name>config</param-name>
<param-value>WEB-INF/struts-config.xml</param-value>
</init-param>
<init-param>
<param-name>debug</param-name>
<param-value>2</param-value>
</init-param>
<init-param>
<param-name>detail</param-name>
<param-value>2</param-value>
</init-param>
<init-param>
<param-name>validate</param-name>
<param-value>true</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<!-- соответствие (mapping) для стратсовского контроллера, указывающее, что контроллер будет вызываться, если адрес заканчивается на .do -->
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<!-- подключение стандартных struts-ских библиотек пользовательских тегов (библиотек может быть больше для поздних версий) -->
<taglib>
<taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>
<taglib-location>/WEB-INF/struts-bean.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>/WEB-INF/struts-html.tld</taglib-uri>
<taglib-location>/WEB-INF/struts-html.tld</taglib-location>
</taglib>
<taglib>
<taglib-uri>/WEB-INF/struts-logic.tld</taglib-uri>
<taglib-location>/WEB-INF/struts-logic.tld</taglib-location>
</taglib>
</web-app>
Чтобы получить пул соединений, в приложении следует заполнить datasource в struts-config.xml, следующим образом:
пример # 9: организация пула соединений : data-sources
<data-sources>
<data-source type="org.apache.commons.dbcp.BasicDataSource">
<set-property
property="driverClassName"
value="com.mysql.jdbc.Driver" />
<set-property
property="url"
value="jdbc:mysql://localhost/имя_бд" />
<set-property
property="username"
value="root" />
<set-property
property="password"
value="pass" />
<set-property
property="maxActive"
value="10" />
<set-property
property="maxWait"
value="5000" />
<set-property
property="defaultAutoCommit"
value="false" />
<set-property
property="defaultReadOnly"
value="false" />
</data-source>
</data-sources>
Получить данный пул из класса, реализующего org.apache.struts.action.Action, можно с помощью метода getDataSource(HttpServletRequest request)).
Оставшиеся JSP-страницы были изменены несущественно:
<%-- пример # 10: страница, вызываемая после прохождения идентификации : main.jsp --%>
<%@ page errorPage="error.jsp" %>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<html:html locale="true">
<head>
<title><bean:message key="jsp.main.title"/></title>
<html:base/>
</head>
<body>
<h3><bean:message key="jsp.main.header"/></h3>
<hr/>
<bean:message key="jsp.main.hello"/>,
<bean:write name="loginForm" property="login"/>
<hr/>
<a href="login.do"><bean:message
key="jsp.error.returnToLogin"/></a>
<html:errors/>
</body>
</html:html>
Страница ошибок, к которой осуществляется переход в случае возникновения исключений, модернизирована следующим образом:
<%--пример # 11: страница, вызываемая при ошибке : error.jsp --%>
<%@ page isErrorPage="true" %>
<%@ taglib uri="/WEB-INF/struts-bean.tld" prefix="bean" %>
<%@ taglib uri="/WEB-INF/struts-html.tld" prefix="html" %>
<html:html locale="true">
<head>
<title><bean:message key="jsp.error.title"/></title>
<html:base/>
</head>
<body>
<h3><bean:message key="jsp.error.header"/></h3>
<hr>
<%=(exception != null)? exception.toString() :
"unknown error"%>
<hr>
<a href="login.do"><bean:message key="jsp.error.returnToLogin"/></a>
</body>
</html:html>
Кроме того, чтобы использовать технологию Struts, необходимо подключить struts.jar с Java-кодом движка и библиотеки пользовательских тегов:
struts-bean.tld
struts-html.tld
struts-logic.tld
Чтобы запустить проект, следует вызвать из браузера:
http://localhost:8080/StrutsProject
Наследники Action
Существуют альтернативы классу Action, наследуемые от Action и облегчающие задачу разработчика.
Класс Action объявляеет только метод execute() и ранее использовался в виде ответа на одно действие пользователя, что увеличивало количество классов приложения и усложняло его поддержку.
Класс DispatchAction позволяет объединить несколько методов работы с одним модулем в одном классе и вызывать их в зависимости от значения параметра запроса. Например, для работы с модулем User класс UserDispatchAction мог бы содержать методы save(), delete(), list() и другие.
Параметр, значение которого будет использовано для вызова метода, описывается в struts-config.xml в описании action.
<action path="/ModuleAction"
type="com.struts.ModuleDispatchAction"
parameter="method"
...
</action>
В коде JSP теперь требуется расставить линки с параметром method, значение которого должно соответствовать методу, вызываемому в подклассе.
Например:
<a href="ModuleAction.do?method=edit&id=1>Edit</a>
<a href="ModuleAction.do?method=view&id=1>View</a>
Далее осталось реализовать методы в ModuleDispatchAction. Если параметр не содержит значения, то вызовется метод unspecified() данного класса. Так же можно реализовать метод cancelled(), который будет вызываться при использовании кнопки <html:cancel/>.
import org.apache.struts.actions.DispatchAction;
public class ModuleDispatchAction extends DispatchAction{
public ActionForward edit(ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws IOException,
ServletException {
// код для обработки
}
public ActionForward view(...)
throws IOException, ServletException {
// код для обработки
}
...
public ActionForward unspecified(...)
throws IOException, ServletException {
mapping.findForward("methodNotFound");
}
public ActionForward cancelled(ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException {
mapping.findForward("cancelPage");
}
}
Класс LookupDispatchAction является наследником от DispatchAction. В отличие от предыдущего класса, который в основном используется через использование линков на View, данный класс применяется если форма должна иметь несколько различных кнопок для выполнения запроса на сервер.
Пусть на странице JSP с помощью тега <html:submit/> расположены кнопки, свойство property которых указывает на название параметра, отправляемого на сервер со значением тега <bean:message/> после нажатия на эту кнопку.
<html:form action="ModuleAction.do">
...
<html:submit property="method">
<bean:message key=" submit.button.print" />
</html:submit>
<html:submit property="method">
<bean:message key="button.save" />
</html:submit>
</html:form>
Затем так же, как и для класса DispatchAction, должен быть задан параметр, который содержит вызываемый метод.
<action path="/ModuleAction"
type="com. struts.ModuleLookupDispatchAction"
parameter="method"
...
</action>
Реализуем методы аналогично DispatchAction классу, но также реализуем метод getKeyMethodMap(), который организует mapping между ключом названия кнопки и методом.
import org.apache.struts.actions.LookupDispatchAction;
...
public class ModuleLookupDispatchAction
extends LookupDispatchAction {
private static Map m = new HashMap();
static {
m.put("myapp.submit.button.print","print");
m.put("myapp.submit.button.save","save");
}
protected Map getKeyMethodMap(){
return m;
}
public ActionForward print(...)
throws IOException, ServletException {
...
}
public ActionForward save(...)
throws IOException, ServletException {
...
}
...
}
Класс MappingDispatchAction также является наследником DispatchAction класса, где вызываемый метод определяется не по значению параметра, а по запрашиваемому URL-адресу маппинг которого хранится в struts-config.xml.
Для одного класса MappingDispatchAction может существовать несколько возможных элементов <action>:
<action path="/userUpdate"
type="com.struts.UserMappingDispatchAction"
parameter="update"
...
<action path="/userAdd"
type="com.struts.UserMappingDispatchAction"
parameter="create"
...
Значение атрибута parameter содержит название метода, который должен отреагировать на данный запрос.
И, как в предыдущих случаях, осталось реализовать необходимые методы.
import org.apache.struts.actions.MappingDispatchAction;
...
public class UserMappingDispatchAction
extends MappingDispatchAction{
public ActionForward update(ActionMapping mapping,
ActionForm form,
HttpServletRequest request,
HttpServletResponse response)
throws IOException, ServletException {
...
}
public ActionForward create(...)
throws IOException, ServletException {
...
}
...
public ActionForward unspecified(...)
throws IOException, ServletException {
mapping.findForward("methodNotFound");
}
}
Библиотеки тегов Struts
Struts Bean Tags
cookie
Получает значение для указанного cookie.
<p>Display the properties of our current session ID cookie (if there is one):</p>
<bean:cookie id="sess" name="JSESSIONID" value="JSESSIONID-IS-UNDEFINED"/>
define
Создает переменную доступную по значению id в одной из областей видимости согласно атрибуту toScope (по умолчанию page scope) и назначает ей значение атрибута value, либо Java bean по ключу из атрибута name или его свойство по aтрибуту property.
<bean:define id="test1_boolean" name="test1"
property="booleanProperty" toScope=”session”/>
<bean:define id="test1_double" name="test1"
property="doubleProperty"/>
<bean:define id="test1_float" name="test1"
property="floatProperty"/>
<bean:define id="test1_int" name="test1"
property="intProperty"/>
<bean:define id="test1_long" name="test1"
property="longProperty"/>
<bean:define id="test1_short" name="test1"
property="shortProperty"/>
<bean:define id="test1_string" name="test1"
property="stringProperty"/>
<bean:define id="test1_value" value="ABCDE"/>
header
Получает значение соответствующего заголовка запроса.
Display the values of the headers included in this request.<br><br>
<%
java.util.Enumeration names =
((HttpServletRequest) request).getHeaderNames();
%>
<table border="1">
<tr>
<th>Header Name</th>
<th>Header Value</th>
</tr>
<%
while (names.hasMoreElements()) {
String name = (String) names.nextElement();
%>
<bean:header id="head" name="<%= name %>"/>
<tr>
<td><%= name %></td>
<td><%= head %></td>
</tr>
<%
}
%>
include
Включает в ответ данные с указанного источника. Данные хранятся в области видимости page под значением атрибута id.
<bean:include id="index" page="/index.jsp"/>
message
Получает локализированное сообщение для указанного ключа из файла ресурсов.
page
Получает значение из контекста страницы.
parameter
Получает значение указанного параметра из запроса.
<bean:parameter id="param1" name="param1"/>
resource
Получает значение указанного ресурса Web-приложения.
<bean:resource id="webxml" name="/WEB-INF/web.xml"/>
size
Получает ссылку на массив или коллекцию и создает новый объект типа java.lang.Integer со значением, равным размеру массива или коллекции.
<bean:size id="dataSize" collection="<%= data %>"/>
struts
Получает значение указанного внутреннего конфигурационного объекта Struts.
write
Показывает значение указанного атрибута указанного бина.
Struts Html Tags
button, cancel, checkbox, file, form, frame, hidden, image, img, link, multibox, password, radio, reset, submit, text, textarea
Представляют стандартные html-элементы.
errors
Отображает множество подготовленных сообщений об ошибках.
javascript
Представляет JavaScript-валидацию, основанную на наборе правил для данной формы, описанных в конфигурационном файле на сервере.
messages
Отображает множество подготовленных сообщений.
<%
ActionMessages messages = new ActionMessages();
messages.add("property1",
new ActionMessage("property1message1"));
messages.add("property2",
new ActionMessage("property2message1"));
messages.add("property2",
new ActionMessage("property2message2"));
messages.add(ActionMessages.GLOBAL_MESSAGE,
new ActionMessage("globalMessage"));
request.setAttribute(Action.MESSAGE_KEY, messages);
%>
…
<html:messages property="property1" message="true" id="msg"
header="messages.header" footer="messages.footer">
<tr><td><%= pageContext.getAttribute("msg") %></td></tr>
</html:messages>
select, option, optionsCollection
Представляет собой html-элемент select c указанным в option элементом списка. С помощью optionsCollection можно задать массив или коллекцию, на основе которой строятся элементы списка.
<html:select property="singleSelect" size="10">
<html:option value="Single 0">Single 0 </html:option>
<html:option value="Single 1">Single 1 </html:option>
<html:option value="Single 2">Single 2 </html:option>
<html:option value="Single 3">Single 3 </html:option>
<html:option value="Single 4">Single 4 </html:option>
<html:option value="Single 5">Single 5 </html:option>
<html:option value="Single 6">Single 6 </html:option>
<html:option value="Single 7">Single 7 </html:option>
<html:option value="Single 8">Single 8 </html:option>
<html:option value="Single 9">Single 9 </html:option>
</html:select>
Struts Logic Tags
empty, notEmpty
Тело данного тега выполняется, только если указанное значение равно (не равно) null или пусто.
<logic:empty name="bean" property="nullProperty">
empty
</logic:empty>
<logic:notEmpty name="bean" property="nullProperty">
notEmpty
</logic:notEmpty>
equal, notEqual
Тело тега выполняется, если совпадают/не совпадают указанные в теге значения.
forward
Выполняет переход по указанному адресу URL.
greaterEqual, lessEqual
Тело тега выполняется, если первое указанное значение меньше (больше), чем второе значение, или равно ему.
greaterThan, lessThan
Тело тега выполняется, если первое указанное значение меньше (больше), чем второе значение.
iterate
Повторяет тело тега для каждого элемента из указанной коллекции.
<% {
java.util.ArrayList list =
new java.util.ArrayList();
list.add("First");
list.add("Second");
list.add("Third");
list.add("Fourth");
list.add("Fifth");
pageContext.setAttribute("list", list, PageContext.PAGE_SCOPE);
int intArray[] = new int[]
{ 0, 10, 20, 30, 40 };
pageContext.setAttribute("intArray", intArray, PageContext.PAGE_SCOPE);
}%>
…
<h3>Test 1 - Iterate Over A String Array [0..4]</h3>
<ol>
<logic:iterate id="element" name="bean"
property="stringArray" indexId="index">
<li><em><bean:write name="element"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 2 - Iterate Over A String Array [0..2]</h3>
<ol>
<logic:iterate id="element" name="bean" property="stringArray" indexId="index"
length="3">
<li><em><bean:write name="element"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 3 - Iterate Over A String Array [3..4]</h3>
<ol>
<logic:iterate id="element" name="bean" property="stringArray" indexId="index"
offset="3">
<li><em><bean:write name="element"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 4 - Iterate Over A String Array [1..3]</h3>
<ol>
<logic:iterate id="element" name="bean"
property="stringArray" indexId="index"
offset="1" length="3">
<li><em><bean:write name="element"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 5 - Iterate Over an Array List</h3>
<ol>
<logic:iterate id="item" name="list" indexId="index">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 6 - Iterate Over an Array List [0..2]</h3>
<ol>
<logic:iterate id="item" name="list" indexId="index"
offset="0" length="3">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 7 - Iterate Over an Array List [2..4]</h3>
<ol>
<logic:iterate id="item" name="list" indexId="index"
offset="2" length="3">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 8 - Iterate Over an int array</h3>
<ol>
<logic:iterate id="item" name="intArray" indexId="index">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 9 - Iterate Over an int array [0..2]</h3>
<ol>
<logic:iterate id="item" name="intArray" indexId="index"
length="3">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
<h3>Test 10 - Iterate Over an int array [2..4]</h3>
<ol>
<logic:iterate id="item" name="intArray" indexId="index"
offset="2" length="3">
<li><em><bean:write name="item"/></em> [<bean:write name="index"/>]</li>
</logic:iterate>
</ol>
messagesNotPresent, messagesPresent
Выполняет тело тега, если объект типа ActionMessages или ActionErrors находится (не находится) в запросе.
notPresent
Тело данного тега выполняется, только если указанное значение присутствует.
<logic:present name="bean" property="stringProperty">
present
</logic:present>
<logic:notPresent name="bean" property ="stringProperty">
notPresent
</logic:notPresent>
Struts Nested Tags
Данная библиотека тегов расширяет возможности тегов всех предыдущих библиотек так, что позволяет определить, в контексте какого nested-тега находится данный тег, тем самым позволяя избежать вызова лишних методов.
Пусть, например, дана страница редактирования объекта класса Company, который содержит как поле объект класса Address со своими свойствами.
<%@ page contentType="text/html;charset=UTF-8"
language="java" %>
<%@ taglib uri="/tags/struts-html" prefix="html" %>
<html:html>
<body>
<html:form action="company.do">
Company name:
<html:text property="company.name" size="60" />
<br>
Company address:
<br>
City:
<html:text property=
"company.address.city" size="60" />
<br>
Street:
<html:text property=
"company.address.street" size="60" />
<br>
…
<html:submit/>
</html:form>
</body>
</html:html>
Здесь можно заметить, что обращение к методу getCompany() формы происходит каждый раз. Также неизбежен и повторный вызов метода getAddress() класса Company.
С использованием nested-тегов данная JSP будет выглядеть как:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib uri="/tags/struts-html" prefix="html" %>
<%@ taglib uri="/tags/struts-nested" prefix="nested" %>
<html:html>
<body>
<html:form action="company.do">
<nested:nest property="company"/>
Company name:
<html:text property="name" size="60" />
<br>
Company address:
<br>
<nested:nest property="address">
City:
<html:text property="city" size="60" />
<br>
Street:
<html:text property="street" size="60" />
<br>
…
</nested:nest>
</nested:nest>
<html:submit/>
</html:form>
</body>
</html:html>
С помощью тега nest устанавливается контекст одного из объектов и далее, используя nested-теги, работа ведется именно с объектом, в котором находится текущий nested-тег. Таким образом, с помощью nested-тегов исчезает необходимость повторного вызова методов для получения доступа к объектам, которые уже были доступны ранее.