Уровень представления Apache Struts Framework Библиотека тэгов

Наиболее используемые тэги html:form html:img html:image html:errors html:link html:multibox html:radio html:checkbox html:text html:select html:options bean:write bean:define logic:iterator logic:match logic:equal logic:notEqual Nested versions of all these tags tiles:insert tiles:put

Общие тэги используемые без контекста формы Define Links Images Write Message Iterator Nested Tags

Bean:Define Используется для получения доступа к объекту формы удобства работы с множеством вложенных свойств НЕ создает экземпляр объекта тэг всего лишь предоставляет доступ к бину в указанной области видимости Пример: empList employeeListselectEmployeesForm Объявление ссылки c именем empList на свойство employeeList бина-формы selectEmployeesForm Collection empList = selectEmployeesForm.getEmployeeList();

Ссылки (links) Использование global-forward конфигурации Текстовая ссылка Home Page Ссылка HTML – HREF Ссылка с использованием JavaScript Back Image Link

Параметризированные ссылки Ссылка может иметь параметр значение для которого берется из бина: Будет создана ссылка-картинка на: /viewReport.do?model= Возможная ссылка: /viewReport.do?model=detail

Картинки (image) Существует два тэга для вывода картинок html:img Используются для обычных картинок Используются совместно с ссылками Пример: или просто html:image Используется в форме как кнопка SUBMIT Обязательно наличие struts формы

Bean:write Используется для получения свойств: Формы-бина Определенной переменной скрипта (bean:define) Пример Если ссылка указывает на простой объект например String то property можно не указывать Вывод HTML кода

Bean:message Используется для вывода значений свойств из файла ресурсов Интернационализация сообщений приложения Пример:

Logic:iterate Используется для перебора (аналогично JSTL – c:forEach) Коллекций Массивов Все тэги включенные в тело тэга выполняются для каждого элемента коллекции Пример: Если атрибут name неуказан то подразумевается перебор коллекции формы указанного в атрибуте id. Форма должна быть объявлена в конфигурации Struts

Работа с формой struts Struts Forms Submit Buttons Text Input Combo Boxes Radio Checkbox Multi-Box Tables

HTML Select HTML тэг для вывода выпадающего списка Ken Tammy Amanda Пояснение к примеру Имя свойства формы employees Значение по умолчанию Ken В списке есть опции Ken, Tammy и Amanda Значение Tammy – 102 Значение Amanda – Amanda

Combo Box Используется для создания выпадающего списка Этот тэг выполняет следующее: On JSP forward Получает значение формы с помощью getEmployee() Создаёт тэг HTML select c элементами коллекции getOptions() Если есть опция соответствующая свойству employee, то это значение будет использовано, как «значение по умолчанию» списка On SUBMIT Получает значение выбранной опции Устанавливает значение свойства формы c помощью setEmployee

Опции для выпадающего списка Указание «вручную» Struts HTML Массив Strings Коллекция Пример указания опции списка вручную Ken Tammy

Опции в строковом массиве В примере employeeList представляет собой свойство формы которое возвращает массив String Каждый элемент массива является как именем так и значением списка

Коллекция объектов для опций списка Пример: collection – свойство формы – коллекция элементов property – свойство объекта в коллекции – используется как значение элемента списка labelProperty – свойство объекта в коллекции – используется как текст элемента списка

Объект коллекции из примера public class Employee { private String name; private String employeeID; public String getName() { return name; } public void setName(String name) { this.name = name; } public String getEmployeeID() { return employeeID; } public void setEmployeeID(String employeeID) { this.employeeID = employeeID; }

Radio Button Используется для создания элемента формы типа «переключатель» (селективная кнопка) Тэг выполняет следующие действия: On JSP forward Получает значение формы с помощью getStatus() Создаёт HTML тэг переключателя Устанавливает значение по умолчанию такое же как и значение свойства status On Submit Получает значение переключателя Устанавливает значение свойства status Full Time Part Time

Check Box Пример демонстрирует создание элемента Check Box Значение берется из свойства формы isUSCitizen Property должно иметь типо Boolean value – необязательный атрибут для установки значения по умолчанию Тэг выполняет следующие действия: On JSP forward Получает значение свойства формы wasUSCitizen Создает HTML тэг check box c именем isUSCitizen Значение по умолчанию устанавливается в соответствии с wasUSCitizen On Submit Получает значение check box Устанавливает значение формы isUSCitizen

Multibox Как правило необходимо иметь множество элементов check box на странице Тэг оперирует строковыми массивами (НЕ BOOLEAN!) Тэг обычно используется внутри тэга Пример 401K 401K Health Health Dental Dental Свойство benefits строковой массив Каждый элемент массива будет benefits отображен как «checked» Каждый элемент массива benefits будет использован в качестве значения по умолчанию 401K Health Dental

Multi-Box Example Используется объект приведенный в примере Combo Box Тэг Iterate обходит все элементы формы доступные из свойства getEmployees() Каждый элемент ссылается на свойство employee Будет создан check box для каждого элемента Value = employeeID Text = name