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

}

}

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;

}

/*пример # 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

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

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

Следует обратить внимание на пользовательские теги вида

<bean:message key="jsp.login.header"/>,

которые выводят текст, предварительно размещенный в специальном файле
ApplicationResources.properties. В этом файле хранятся все статичес­кие текстовые данные, которые извлекаются по ключу, указанному в свойстве пользовательского тега key. Например, в LoginAction при создании объектов ошибок в их конструкторе был указан ключ, по которому в этом файле берется текст ошибки:

errors.add(ActionMessages.GLOBAL_MESSAGE,

new ActionMessage("error.login.incorrectLoginOrPassword"));

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

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

<?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, следующим образом:

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

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

<%@ 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-html.tld

struts-logic.tld

Наследники Action

<action path="/ModuleAction"

type="com.struts.ModuleDispatchAction"

parameter="method"

<a href="ModuleAction.do? method=edit &id=1>Edit</a>

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

}

}

Пусть на странице 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>

Затем так же, как и для класса DispatchAction, должен быть задан параметр, который содержит вызываемый метод.

<action path="/ModuleAction"

type="com. struts.ModuleLookupDispatchAction"

parameter="method"

Реализуем методы аналогично 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 {

...

<action path="/userUpdate"

type="com.struts.UserMappingDispatchAction"

parameter="update"

...

<action path="/userAdd"

type="com.struts.UserMappingDispatchAction"

parameter="create"

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

}

}

Не нашли, что искали? Воспользуйтесь поиском: