LXF98:Java EE10 - История изменений

Lockal: Перенаправление на LXF98:Java EE

2008-04-27T14:51:13Z

Перенаправление на LXF98:Java EE

Внесённые изменения

Lockal: восстановление кавычек в коде AWB

2008-04-27T14:44:59Z

восстановление кавычек в коде AWB

Внесённые изменения

Belogorie: /* Что включается в Struts? */

2008-03-27T11:28:23Z

‎Что включается в Struts?

Belogorie: /* Как этим пользоваться? */

2008-03-27T11:24:37Z

‎Как этим пользоваться?

Belogorie: /* Как этим пользоваться? */

2008-03-27T11:23:33Z

‎Как этим пользоваться?

Belogorie: Новая: ==Struts, великий и ужасный== '''''ЧАСТЬ 10''' Компьютеры были придуманы, чтобы и...

2008-03-27T11:22:59Z

Новая: ==<font color=darkred>Struts</font>, великий и ужасный== ''<font color=darkred>'''ЧАСТЬ 10'''</font> Компьютеры были придуманы, чтобы и...

Новая страница

==<font color=darkred>Struts</font>, великий и ужасный==

''<font color=darkred>'''ЧАСТЬ 10'''</font> Компьютеры были придуманы, чтобы избавить человечество от рутины – так зачем делать вручную то, что можно сгенерировать автоматически? '''Александр Бабаев''' покажет, как Struts позволяет избежать монотонного кодирования приложений J2EE.''

Вручную делать простые вещи хорошо: быстро, просто, понятно. Но что делать, если нужно так же быстро и просто создать нечто большое? Сайт-портал, например? Не тот портал, который Яндекс, а корпоративный – где интегрирована система хранения документов, информационная система, наша адресная книга?

В PHP в этом случае приходит на помощь ''CMS''. Сладкие слова, которые обещают «в два клика» сделать вам все что угодно. Маркетинг, конечно, страшная сила, но почему так много ''CMS'' на PHP, и нет на ''Java''?

Возможно, просто потому что не нужно. Место ''CMS'' в ''Java'' занимают разнообразные инструментарии разработчика, которые помогают обходить сложные и рутинные работы. В результате можно небольшими силами сделать систему, по сложности намного превосходящую то, что можно сделать «вручную».

===Что включается в Struts?===

''Struts'' не изобретает велосипедов. В его основе лежит шаблон «MODEl-View-Controller», который мы рассматривали в LXF92, но с его помощью проще создать грамотное приложение, так как четко определены задачи по его созданию; проще разобраться, что необходимо написать для получения результата.

Итак, ''Struts'' (будем рассматривать более простую, первую версию) содержит:

*''API'' для создания обработчика запросов (менеджер, распределяющий запросы по действиям) и для создания самих действий (<font color=darkred>Actions</font>).
*''API'' для создания обработчиков форм.
*''API'' для работы с проверкой корректности заполнения (валидации) форм.
*''Tiles''. Расширение для создания модульных страниц (что-то «вроде SSI»).
*''JSP-taglib'', библиотека ''JPS''-тэгов для упрощения написания JSP-страниц.
*''XML''-конфигурационные файлы, для простой и быстрой настройки всего вышеперечисленного и связи его друг с другом.

Все это в предыдущих статьях мы делали вручную. Теперь настало время проделать то же самое более «технологично».

===Как этим пользоваться?===

Во-первых, библиотеку нужно скачать. Это можно сделать со странички http://struts.apache.org/download.cgi#struts138. После чего следует распаковать полученный файл и вытащить оттуда все JAR-архивы.

В качестве примера, создадим уже знакомую телефонную книгу. Сперва каталог; в нем, как всегда, организуем подкаталоги для исходных текстов, скомпилированного кода, библиотек и JSP-файлов. Получится что-то такое:

*'''libs'''
**''antlr-2.7.2.jar''
**''bsf-2.3.0.jar''
**''commons-beanutils-1.7.0.jar''
**''commonschain-1.1.jar''
**''commons-digester-1.8.jar''
**''commons-fileipload-1.1.1.jar''
**''commons-io-1.1.jar''
**''commons-logging-1.0.4.jar''
**''commons-validator-1.3.1.jar''
**''jstl-1.0.2.jar''
**''oro-2.0.8.jar''
**''standart-1.0.2.jar''
**''struts-core-1.3.8.jar''
**''struts-el-1.3.8.jar''
**''struts-extras-1.3.8.jar''
**''struts-faces-1.3.8.jar''
**''struts-mailreader-dao-1.3.8.jar''
**''struts-scripting-1.3.8.jar''
**''struts-taglib-1.3.8.jar''
**''struts-tiles-1.3.8.jar''
*'''out'''
*'''src'''
**''MessageResources_en.properties''
**''MessageResources_ru.properties''
**'''ru'''
*'''web'''
**''index.jsp''
**'''pages'''
**'''WEB-INF'''

Затем в каталог библиотек нужно положить JAR-файлы ''Struts''. Готово? Тогда можно приступать к кодированию.

Когда запрос приходит в сервлет, он первым делом попадает в ''Struts'', который перенаправляет его в менеджер запросов (<font color=darkred>ActionServet</font>) и далее в нужное действие (<font color=darkred>Action</font>). Это происходит примерно так:

Как видно, схема здорово напоминает примененную нами при создании адресной книги. Зачем тогда ''Struts''? А затем, чтобы не писать много-много однотипного кода, который повторяется из проекта в проект.

===Конфигурационные файлы===

Вначале научимся запускать ''Struts''. Для этого нужно перенаправить все запросы сервлету-обработчику и написать файл конфигурации. Вот
простой дескриптор для простого ''Struts''-приложения:
<source lang="xml">
<?xml version=”1.0” encoding=”UTF-8”?>
<web-app>
<servlet>
<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>
</servlet>
<servlet-mapping>
<servlet-name>action</servlet-name>
<url-pattern>*.do</url-pattern>
</servlet-mapping>
</web-app>
</source>
Видно, что все запросы <font color=darkred>*.do</font> передаются сервлету <font color=darkred>action</font>, обрабатываемому классом <font color=darkred>ActionServlet</font>. Это стандартный класс Struts, который перенаправляет запросы в действия. Ему передается конфигурационный файл '''struts-config.xml'''. Вот он:
<source lang="xml">
<?xml version=”1.0” encoding=”UTF-8” ?>
<struts-config>
<form-beans>
<form-bean name=”addForm” type=”org.apache.struts.validator.DynaValidatorForm”>
<form-property name=”name” type=”java.lang.String” initial=”Name”/>
<form-property name=”phone” type=”java.lang.String” initial=”1234567”/>
<form-property name=”age” type=”java.lang.Integer” initial=”20”/>
<form-property name=”comment” type=”java.lang.String” initial=”NoComment”/>
</form-bean>
<action-mappings>
<action path=”/add” name=”addForm” validate=”true” type=”ru.linuxformat.actions.Add”>
<forward name=”form” path=”/pages/Add.jsp”/>
<forward name=”done” path=”/list.do”/>
</action>
<action path=”/list” type=”ru.linuxformat.actions.ShowAll”>
<forward name=”ok” path=”/pages/List.jsp”/>
</action>
</action-mappings>
<message-resources parameter=”MessageResources”/>
<plug-in className=”org.apache.struts.validator.ValidatorPlugIn”>
<set-property property=”pathnames” value=”/org/apache/struts/validator/validator-rules.xml,/WEB-INF/validation.xml”/>
</plug-in>
</struts-config>
</source>
В данном файле описана форма добавления контакта (<font color=darkred>form-bean</font>), с использованием стандартного класса формы с поддержкой автоматической проверки полей (<font color=darkred>DynaValidatorForm</font>).

После этого описано, какие запросы в какие классы перенаправляются.
<source lang="xml">
<action path=”/list” type=”ru.linuxformat.actions.ShowAll”>
<forward name=”ok” path=”/pages/List.jsp”/>
</action>
</source>
В этом примере запрос <font color=darkred>/list.do</font> пойдет в класс <font color=darkred>ShowAll.Forward</font> используется внутри действия, чтобы упростить перенаправление вывода. Дальше будет понятно, как.

После описания действий все становится совсем просто.Описывается файл, откуда будут браться локализованные строки, и
подключается модуль, который обеспечивает простую и мощную валидацию (проверку) форм.

===Действия===

Перейдем к классам. Все они должны быть унаследованы от класса <font color=darkred>org.apache.struts.action.Action</font>. При этом в простейшем случае нужно переопределить только один метод, <font color=darkred>execute(…)</font>. Например, вот действие, которое показывает список контактов:
<source lang="java">
public class ShowAll extends Action {
public ActionForward execute(ActionMapping aActionMapping,
ActionForm aActionForm,
HttpServletRequest aHttpServletRequest,
HttpServletResponse aHttpServletResponse)
throws Exception {
aHttpServletRequest.setAttribute(“contacts”,
Contacter.getInstance().getContactsSortedByName());
return aActionMapping.findForward(“ok”);
}
}
</source>
В этом действии в атрибут запроса кладется список всех контактов, после чего вызывается форвард <font color=darkred>“ok”</font> – именно он был описан чуть выше.
<source lang="xml">
<action path=”/list” type=”ru.linuxformat.actions.ShowAll”>
<forward name=”ok” path=”/pages/List.jsp”/>
</action>
</source>
Из описания видно, что форвард перенаправляет обработку запроса в '''List.jsp''. Посмотрим, что в нем написано:
<source lang="xml">
<%@ page pageEncoding=”UTF-8” language=”java” contentType=”text/
html; utf-8” %>
<%@ taglib uri=”http://struts.apache.org/tags-html” prefix=”html” %>
<%@ taglib uri=”http://struts.apache.org/tags-bean” prefix=”bean” %>
<%@ taglib uri=”http://struts.apache.org/tags-logic” prefix=”logic” %>
<html:html>
<head>
…
</head>
<body>
…
<table border=”1”>
<tr>
<td><bean:message key=”AddressBook.list.name”/></td>
<td><bean:message key=”AddressBook.list.phone”/></td>
<td><bean:message key=”AddressBook.list.comment”/></td>
<td><bean:message key=”AddressBook.list.age”/></td>
</tr>
<logic:iterate id=”contact” type=”ru.linuxformat.Contact”
name=”contacts” scope=”request”>
<tr>
<td><%=contact.getName()%></td>
<td><%=contact.getPhone()%></td>
<td><%=contact.getComment()%></td>
<td><%=contact.getAge()%></td>
</tr>
</logic:iterate>
</table>
</body>
</html:html>
</source>
На многоточия заменены неинтересные куски кода, а интересное – в самом начале листинга (<font color=darkred>taglib</font>). Это так называемые библиотеки тэгов. Примеры можно видеть здесь же. Скажем, <font color=darkred><bean:messagekey=”AddressBook.list.name”/></font> вставляет локализованную строку, соответствующую данному ключу. А <font color=darkred><logic:iterate></font> умеет итерировать по коллекциям (списки, ассоциативные массивы и так далее). В данном случае мы итерируем по атрибуту запроса <font color=darkred>contacts</font>, который мы положили туда в действии.

===Формы, проверка корректности форм===

Другая интересная часть – формы. Второе действие, добавление контакта, выглядит следующим образом (приведен только код метода <font color=darkred>execute</font>):
<source lang="java">
if (aHttpServletRequest.getParameter(“name”) == null) {
return aActionMapping.findForward(“form”);
} else {
DynaActionForm form = (DynaActionForm) aActionForm;
Contacter.getInstance().addContact(form.getString(“name”), form.
getString(“phone”), form.getString(“comment”), (Integer) form.
get(“age”));
return aActionMapping.findForward(“done”);
}
</source>
Логика очень похожа на ту, что была в предыдущих статьях. Если форма не заполнена, переходим по форварду <font color=darkred>form</font>, который показывает форму для ввода. Если она заполнена (и валидирована), то контакт добавляется в список, и мы переходим на форвард <font color=darkred>done</font>. Вот и сама форма (точнее, ее основная часть):
<source lang="xml">
<html:form action=”/add” method=”post” onsubmit=”return
validateAddForm(this);”>
<table>
<tr>
<td><bean:message key=”AddressBook.add.name”/>:</td>
<td><html:text property=”name”/></td>
</tr>
…
<tr>
<td colspan=”2”><html:submit titleKey=”AddressBook.add.
submit”/></td>
</tr>
</table>
</html:form>
<html:javascript formName=”addForm”/>
</source>
Тут интересны два момента. Во-первых, используются тэги ''Struts'' (<font color=darkred>html:…</font>), упрощающие создание компонентов формы. Во-вторых, используется скрипт валидации (<font color=darkred>onsubmit=”…”</font> и <font color=darkred><html:Javascript …></font>). Он обеспечивает валидацию прямо в браузере, не отсылая запрос на сервер.

Сами правила валидации задаются в файле '''validation.xml'''. Вот как это выглядит:
<source lang="xml">
<form-validation>
<formset>
<form name=”addForm”>
<field property=”age” depends=”required,integer,intRange”>
<arg key=”AddressBook.add.age”/>
<arg position=”1” name=”intRange” key=”10”
resource=”false”/>
<arg position=”2” name=”intRange” key=”20”
resource=”false”/>
<var><var-name>min</var-name><var-value>10</var-value></
var>
<var><var-name>max</var-name><var-value>20</var-value></
var>
</field>
</form>
</formset>
</form-validation>
</source>
Форму я создал в '''struts-config'''. Называться она должна так же. Для поля <font color=darkred>age</font> задается три правила валидации: <font color=darkred>required</font>, <font color=darkred>integer</font>, <font color=darkred>intRange</font>. Первое говорит, что поле обязательно, второе – что значение должно быть целочисленным, третье правило сообщает, что значение должно лежать в пределах от 10 до 20. В качестве параметров задаются аргументы сообщений, которые будут выводиться при ошибочном заполнении формы (<font color=darkred>arg</font>), и параметры для правил валидации (<font color=darkred>var</font>).

===Локализация===

Последняя часть, пока не описанная – локализация. Сообщения хранятся в так называемых properties-файлах, причем если property-файл называется '''MessageResources''', то, например, файл русской локализации должен называться '''MessageResources_ru.properties''', а английской – '''MessageResources_en.properties'''. Если нужно уточнить – например, английский язык, Америка – то получается так: '''MessageResources_en_US.properties'''.

Структура файлов '''properties''' очень проста. Каждая строка (не пустая и не комментарий) состоит из двух частей, разделенных знаком равенства (<font color=darkred>=</font>). Слева – ключ, справа – значение этого ключа.

Эти файлы нужно положить в каталог '''src''', и проконтролировать, чтобы они переписались туда же, куда попадают class-файлы. Плюс, для неанглийских
файлов, их нужно преобразовать в ASCII-формат. Это делается утилитой ''native2ascii'' из поставки JDK. Инструкции по пользованию утилитой можно найти здесь: http://Java.sun.com/Javase/6/docs/technotes/tools/windows/native2ascii.html.

После этого можно использовать в JSP вставки вида <font color=darkred><bean:message key=”AddressBook.add.name”/></font>, вместо которых будет вставлена локализованная строка, соответствующая данному ключу (в примере – <font color=darkred>AddressBook.add.name</font>).

===Что дальше?===

''Struts'' – великолепная библиотека, позволяющая упростить разработку сложных приложений. Особенно хорошо такого рода библиотеки подходят для задач, в которых много монотонной работы: больших форм, большого количества простых действий, необходимость проверки данных, вводимых в форму, локализация.

Также полезно, что используются стандартные средства: ''JSP'', ''Servlets'', да и сам ''Struts'' – самая распространенная библиотека для такого рода работ. В результате при приеме на работу, например, знание именно ''Struts'' позволяет набрать несколько дополнительных баллов.

Правда, еще больше баллов дает знание ''EJB3''. Но об этом мы поговорим в следующей, заключительной статье.

@@ Строка 11: / Строка 11: @@
 ===Что включается в Struts?===
-''Struts'' не изобретает велосипедов. В его основе лежит шаблон «MODEl-View-Controller», который мы рассматривали в LXF92, но с его помощью проще создать грамотное приложение, так как четко определены задачи по его созданию; проще разобраться, что необходимо написать для получения результата.
+''Struts'' не изобретает велосипедов. В его основе лежит шаблон «MODEl-View-Controller», который мы рассматривали в [[LXF92:Java_EE|LXF92]], но с его помощью проще создать грамотное приложение, так как четко определены задачи по его созданию; проще разобраться, что необходимо написать для получения результата.
 Итак, ''Struts'' (будем рассматривать более простую, первую версию) содержит:

@@ Строка 30: / Строка 30: @@
 В качестве примера, создадим уже знакомую телефонную книгу. Сперва каталог; в нем, как всегда, организуем подкаталоги для исходных текстов, скомпилированного кода, библиотек и JSP-файлов. Получится что-то такое:
- *'''libs'''
+*'''libs'''
- **''antlr-2.7.2.jar''
+**''antlr-2.7.2.jar''
- **''bsf-2.3.0.jar''
+**''bsf-2.3.0.jar''
- **''commons-beanutils-1.7.0.jar''
+**''commons-beanutils-1.7.0.jar''
- **''commonschain-1.1.jar''
+**''commonschain-1.1.jar''
- **''commons-digester-1.8.jar''
+**''commons-digester-1.8.jar''
- **''commons-fileipload-1.1.1.jar''
+**''commons-fileipload-1.1.1.jar''
- **''commons-io-1.1.jar''
+**''commons-io-1.1.jar''
- **''commons-logging-1.0.4.jar''
+**''commons-logging-1.0.4.jar''
- **''commons-validator-1.3.1.jar''
+**''commons-validator-1.3.1.jar''
- **''jstl-1.0.2.jar''
+**''jstl-1.0.2.jar''
- **''oro-2.0.8.jar''
+**''oro-2.0.8.jar''
- **''standart-1.0.2.jar''
+**''standart-1.0.2.jar''
- **''struts-core-1.3.8.jar''
+**''struts-core-1.3.8.jar''
- **''struts-el-1.3.8.jar''
+**''struts-el-1.3.8.jar''
- **''struts-extras-1.3.8.jar''
+**''struts-extras-1.3.8.jar''
- **''struts-faces-1.3.8.jar''
+**''struts-faces-1.3.8.jar''
- **''struts-mailreader-dao-1.3.8.jar''
+**''struts-mailreader-dao-1.3.8.jar''
- **''struts-scripting-1.3.8.jar''
+**''struts-scripting-1.3.8.jar''
- **''struts-taglib-1.3.8.jar''
+**''struts-taglib-1.3.8.jar''
- **''struts-tiles-1.3.8.jar''
+**''struts-tiles-1.3.8.jar''
- *'''out'''
+*'''out'''
- *'''src'''
+*'''src'''
- **''MessageResources_en.properties''
+**''MessageResources_en.properties''
- **''MessageResources_ru.properties''
+**''MessageResources_ru.properties''
- **'''ru'''
+**'''ru'''
- *'''web'''
+*'''web'''
- **''index.jsp''
+**''index.jsp''
- **'''pages'''
+**'''pages'''
- **'''WEB-INF'''
+**'''WEB-INF'''
 Затем в каталог библиотек нужно положить JAR-файлы ''Struts''. Готово? Тогда можно приступать к кодированию.