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">

<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>

<%-- вывод сообщения из.properties проекта --%>

<%-- генерируется тег <base> с атрибутом href, в котором будет URL
текущего application. При этом все относительные ссылки на странице
ответа отсчитываются от этого значения

--%>

<html:base />

</head>

<body>

<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-beans>

<form-bean name="loginForm"

type="by.bsu.famcs.jspservlet.LoginForm" />

</form-beans>

<global-exceptions>

</global-exceptions>

<global-forwards>

</global-forwards>

<action-mappings>

<action name="loginForm"

path="/login"

scope="request" <!—- Задается область видимости формы. Часто необходимо, чтобы форма лежала в сессии, а не в запросе. -->

type="by.bsu.famcs.jspservlet.LoginAction"

validate="false">

<forward name="againlogin" path="/WEB-INF/jsp/login.jsp" />

<forward name="success" path="/WEB-INF/jsp/main.jsp" />

</action>

</action-mappings>

<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>

<servlet-name>action</servlet-name>

<servlet-class>

org.apache.struts.action.ActionServlet</servlet-class>

<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>

<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>

<taglib-uri>/WEB-INF/struts-bean.tld</taglib-uri>

<taglib-location>/WEB-INF/struts-bean.tld</taglib-location>

</taglib>

<taglib-uri>/WEB-INF/struts-html.tld</taglib-uri>

<taglib-location>/WEB-INF/struts-html.tld</taglib-location>

</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>

<html:base/>

</head>

<body>

<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>

<html:base/>

</head>

<body>

<hr>

<%=(exception!= null)? exception.toString():

"unknown error"%>

<hr>

</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=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();

<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>

</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">

</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">

</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">

</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">

</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">

</logic:iterate>

</ol>

<h3>Test 5 - Iterate Over an Array List</h3>

<ol>

<logic:iterate id="item" name="list" indexId="index">

</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">

</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">

</logic:iterate>

</ol>

<h3>Test 8 - Iterate Over an int array</h3>

<ol>

<logic:iterate id="item" name="intArray" indexId="index">

</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">

</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">

</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>

<html:submit/>

</html:form>

</body>

</html:html>

С помощью тега nest устанавливается контекст одного из объектов и далее, используя nested-теги, работа ведется именно с объектом, в котором находится текущий nested-тег. Таким образом, с помощью nested-тегов исчезает необходимость повторного вызова методов для получения доступа к объектам, которые уже были доступны ранее.

Приложение 7

ЖУРНАЛ СООБЩЕНИЙ (LOGGER)

В процессе функционирования сложных приложений необходимо вести журнал сообщений и ошибок, чтобы была возможность отследить время входа и выхода пользователя из системы, возникновение исключительных ситуаций и т.д. Существуют различные API регистрации сообщений и ошибок. В практическом программировании для этих целей применяется API Log4j, разработанный в рамках проекта Jakarta Apache.

API Log4j – это инструмент для формирования журнала сообщений (отладочных, информационных, сообщений об ошибках). API Log4j можно загрузить по адресу: http://logging.apache.org/log4j/. Перед использованием необходимо зарегистрировать загруженную библиотеку log4j-1.2.13.jar
в приложении.

Log4j состоит из трех элементов:

· регистрирующего (logger);

· направляющего вывод (appender);

· форматирующего (layout).

Таким образом logger регистрирует и направляет вывод события в пункт назначения, определяемый элементом appender, в формате, заданном элементом layout.

В стандартной библиотеке java.util.logging также существует возможность журналирования событий. Однако функциональность классов этого пакета несколько уже, чем у классов проекта Log4j, поэтому профессиональные программисты предпочитают использовать последний.

Logger

Основным элементом API регистрации событий и ошибок является регистратор Logger, который управляет регистрацией сообщений. Вывод регистратора может быть направлен на консоль, в файл, базу данных, GUI-компонент или сокет. Это компонент приложения, принимающий и выполняющий запросы на запись в регистрационный журнал.

Каждый класс приложения может иметь свой собственный logger или быть прикреплен к общему для всего приложения. Регистраторы образуют иерархию, как и пакеты Java. Регистратор может быть создан или получен с помощью статического метода getLogger(String name), где name – имя пакета. В вершине иерархии находится корневой регистратор. Он всегда существует и у него нет имени. Он может быть получен статическим методом getRootLogger().

У каждого регистратора есть уровень сообщения по возрастанию (TRACE, DEBUG, INFO, WARN, ERROR, FATAL), который управляет выводом сообщений. Для вывода сообщений конкретного уровня используются методы debug(), info(), warn(), error(), fatal(). Чтобы вывести информацию о возникшем исключении в качестве второго параметра, в вышеперечисленные методы нужно передать объект класса, производного от Throwable. Для вывода сообщения необходимо, чтобы уровень выводимого сообщения был не ниже, чем уровень регистратора (TRACE < DEBUG < INFO < WARN < ERROR < FATAL), т. е. если уровень регистратора INFO, то вызов logger.debug(“message”) не даст никакого эффекта, т. к. DEBUG < INFO. Уровень регистратора можно указать с помощью метода setLevel(Level level), который принимает объект класса Level, содержащий одноименные константы для каждого уровня. Если уровень регистратора не указывается, то наследуется уровень от его родителя. Уровень корневого регистратора DEBUG.

Существуют следующие методы для вывода сообщений:

log(Priority priority, Object message, Throwable t) –выводит сообщения указанного уровня с информацией об исключительной ситуации t.

log(Priority priority, Object message) –выводит сообщения указанного уровня.

Appender и Layout

Вывод регистратора может быть направлен в различные места назначения. Каждому из них соответствует класс, реализующий интерфейс Appender. С помощью метода addAppender(Appender newAppender) класса Logger можно добавить Apeender к регистратору. Один регистратор может иметь несколько элементов Appender. Вывод на консоль осуществляется с помощью класса ConsoleAppender. Класс FileAppender используется для вывода сообщений в файл. Для установки файла, в который будет выполняться вывод, нужно передать имя файла в конструктор FileAppender(Layout layout, String filename) или метод setFile(String file). По умолчанию любые сообщения, записанные в файл, будут добавляться к уже имеющимся. Изменить это можно с помощью конструктора FileAppender(Layout layout, String filename, boolean append) сбросив флаг append или с помощью метода setAppend(boolean append).

Кроме того, вывод в базу данных можно произвести с помощью класса JDBCAppender, в журнал событий ОС – NTEventLogAppender, на SMTP-сервер – SMTPAppender, на удаленный сервер – SocketAppender.

Любой вывод, сделанный в регистраторе, будет направлен всем его предкам. Чтобы этого избежать, в регистраторе следует установить флаг аддитивности
с помощью метода setAdditivity(boolean additive). В этом случае вывод будет направлен всем его предкам вплоть до регистратора с установленным флагом аддитивности.

Вывод регистратора может иметь различный формат. Каждый формат представлен классом, производным от Layout. Все методы класса Layout предназначены только для создания подклассов. В библиотеке определены следующие:

HTMLLayout – вывод в HTML-формате;

XMLLayout – вывод в XML-формате;

SimpleLayout – вывод в простом текстовом формате.

Более информативен вывод в XML-формате.

Установить Layout для FileAppender или ConsoleAppender можно
с помощью метода setLayout(Layout layout) или передать его в вышеперечисленные конструкторы этих классов.

В приведенном ниже примере производятся регистрация и вывод как обычных информационных сообщений о выполненных действиях, так и сообщений о возникающих ошибках (попытке вычисления факториала отрицательного числа).

/* пример # 1: регистратор ошибок: Demo Log.java */

package app6;

import org.apache.log4j.Logger;

import org.apache.log4j.FileAppender;

import org.apache.log4j.SimpleLayout;

import org.apache.log4j.Level;

import java.io.IOException;

public class DemoLog {

static Logger logger = Logger.getLogger(DemoLog. class);

public static void main(String[] args) {

try {

//возможна и программная настройка

factorial(9);

factorial(-3);

} catch (IllegalArgumentException e) {

//вывод сообщения уровня ERROR

logger.error("negative argument", e);

}

public static int factorial(int n) {

if (n < 0)

throw new IllegalArgumentException(

"argument " + n +" less then zero");

//вывод сообщения уровня DEBUG

logger.debug("Argument n is " + n);

int result = 1;

for (int i = n; i >= 1; i--)

result *= i;

//вывод сообщения уровня INFO

logger.info("Result is " + result);

return result;

}

При этом в корне проекта должен находиться конфигурационный файл "log4j.xml" со следующим содержимым:

<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">

<log4j:configuration xmlns:log4j='http://jakarta.apache.org/log4j/'>

<appender name="TxtAppender" class="org.apache.log4j.FileAppender">

<param name="File" value="log.txt" />

<layout class="org.apache.log4j.SimpleLayout"/>

</appender>

</logger>

<root>

<appender-ref ref="TxtAppender" />

</root>

</log4j:configuration>

Вывод регистратора "app6.DemoLog", в файл log.txt будет следующим:

DEBUG - Argument n is 9

INFO - Result is 362880

ERROR - negative argument java.lang.IllegalArgumentException: argument -3 less then zero

at app6.DemoLog.factorial(DemoLog.java:35)

at app6.DemoLog.main(DemoLog.java:27)

Возможна также и программная настройка логгирования. Тогда в код программы необходимо добавить следующее:

FileAppender appender =

new FileAppender(

new SimpleLayout(), "log.txt");

logger.addAppender(appender);

logger.setLevel(Level.DEBUG);

Для вывода на консоль и в XML необходимо добавить следующее в конфигурационный файл:

</appender>

</appender>

<root>

<appender-ref ref="ConsAppender" />

<appender-ref ref="XMLAppender" />

</root>

Или программно:

ConsoleAppender appender2 =

new ConsoleAppender(new SimpleLayout());

FileAppender appender3 =

new FileAppender(new XMLLayout(), "log.xml");

logger.addAppender(appender2);

logger.addAppender(appender3);

В классе Logger объявлены методы, реагирующие на соответствующие события, а именно: fine(), info(), warning(), log(), throwing() и др.

В приведенном примере запись в файл log.xml производится в зависимости от значения остатка после деления.

/* пример # 2: стандартный регистратор ошибок: StandartDemoLog.java */

package app6;

import java.io.IOException;

import java.util.logging.FileHandler;

import java.util.logging.Level

import java.util.logging.Logger;

public class StandartDemoLog {

static Logger log = Logger.getLogger("app6");

public static void main(String[] args)

throws SecurityException, IOException {

/*инициализация и назначение для вывода логов простого файла, который по умолчанию использует XMLFormatter, то есть
в файле информация будет сохраняться в виде XML */

FileHandler fh = new FileHandler("log.xml");

log.addHandler(fh);

log.setLevel(Level.WARNING); //установка уровня сообщений

int arr[] = { 5, 6, 1, -4 };

for (int i = 0; i < arr.length; i++) {

int j = arr[i] % 3;

switch (j) {

case 0:

log.fine(arr[i] + "%3 = 0");

break;

case 1:

log.info(arr[i] + "%3 = 1");

break;

case 2:

log.warning(arr[i] + "%3 = 2");

break;

default:

log.severe(arr[i] + "%3 < 0");

}

В результате на консоль будет выведено:

App6.DemoLog main

WARNING: 5%3 = 2

App6.DemoLog main

INFO: 1%3 = 1

App6.DemoLog main

SEVERE: -4%3 < 0

В файле log.xml та же информация будет сохранена в виде

<?xml version="1.0" encoding="windows-1251"

standalone="no"?>

<!DOCTYPE log SYSTEM "logger.dtd">

<log>

<record>

<date>2006-03-17T15:39:03</date>

<millis>1142602743635</millis>

<sequence>0</sequence>

<logger>app6</logger>

<level>WARNING</level>

<class>app6.DemoLog</class>

<method>main</method>

<thread>10</thread>

<message>5%3 = 2</message>

</record>

<record>

<date>2006-03-17T15:39:03</date>

<millis>1142602743736</millis>

<sequence>1</sequence>

<logger>app6</logger>

<level>INFO</level>

<class>app6.DemoLog</class>

<method>main</method>

<thread>10</thread>

<message>1%3 = 1</message>

</record>

<record>

<date>2006-03-17T15:39:03</date>

<millis>1142602743736</millis>

<sequence>2</sequence>

<logger>app6</logger>

<level>SEVERE</level>

<class>app6.DemoLog</class>

<method>main</method>

<thread>10</thread>

<message>-4%3 < 0</message>

</record>

</log>

В несложных учебных проектах проще использоват