Руководство Struts2 для начинающих
View more Tutorials:
Статья написана и основана на:
- Eclipse 4.6 (NEON)
- Struts 2 (2.3.20)
Вы смотрите руководство создания приложения Hello World Struts, используя Annotation для конфигурации. Можете посмотреть похожий пример используя XML для конфигурации по ссылке:
- File/New/Other..
Ввод:
- Group Id: org.o7planning
- Artifact Id: Struts2Annotation
- Package: org.o7planning.struts2annotation
Project создан, и не обрщайте внимания при появлении сообщений об ошибке. Это потому что вы еще не объяявили библиотеку Servlet.
Это иллюстрация Project после завершения:
Конфигурировать Maven чтобы объявить использовенные библиотеки. Включает библиотеки Servlet, Struts2.Так же конфигурируем Maven Tomcat Plugin чтобы запустить приложения прямо в Eclipse.
pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/maven-v4_0_0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>org.o7planning</groupId>
<artifactId>Struts2Annotation</artifactId>
<packaging>war</packaging>
<version>0.0.1-SNAPSHOT</version>
<name>Struts2Annotation Maven Webapp</name>
<url>http://maven.apache.org</url>
<dependencies>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<scope>test</scope>
</dependency>
<!-- Servlet Library -->
<!-- http://mvnrepository.com/artifact/javax.servlet/javax.servlet-api -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.1.0</version>
<scope>provided</scope>
</dependency>
<!-- Jstl for jsp page -->
<!-- http://mvnrepository.com/artifact/javax.servlet/jstl -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!-- JSP API -->
<!-- http://mvnrepository.com/artifact/javax.servlet.jsp/jsp-api -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.2</version>
<scope>provided</scope>
</dependency>
<!-- http://mvnrepository.com/artifact/org.apache.struts/struts2-core -->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-core</artifactId>
<version>2.3.20</version>
</dependency>
<!-- http://mvnrepository.com/artifact/org.apache.struts/struts2-convention-plugin -->
<dependency>
<groupId>org.apache.struts</groupId>
<artifactId>struts2-convention-plugin</artifactId>
<version>2.3.20</version>
</dependency>
</dependencies>
<build>
<finalName>Struts2Annotation</finalName>
<plugins>
<!-- Config: Maven Tomcat Plugin -->
<!-- http://mvnrepository.com/artifact/org.apache.tomcat.maven/tomcat7-maven-plugin -->
<plugin>
<groupId>org.apache.tomcat.maven</groupId>
<artifactId>tomcat7-maven-plugin</artifactId>
<version>2.2</version>
<!-- Config: contextPath and Port (Default: /Struts2Annotation : 8080) -->
<!-- <configuration> <path>/</path> <port>8899</port> </configuration> -->
</plugin>
</plugins>
</build>
</project>
Использовать Webapps >= 3
web.xml
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://java.sun.com/xml/ns/javaee"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
id="WebApp_ID" version="3.0">
<display-name>Struts2Annotation</display-name>
<filter>
<filter-name>struts2</filter-name>
<filter-class>
org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter
</filter-class>
</filter>
<filter-mapping>
<filter-name>struts2</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<welcome-file-list>
<welcome-file>/WEB-INF/pages/helloStruts2.jsp</welcome-file>
</welcome-file-list>
</web-app>
struts.xml это файл resource который должен находиться в src/main/resources, этот файл выполняет обязанность конфигурации struts.
struts.xml
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.0//EN" "http://struts.apache.org/dtds/struts-2.0.dtd"> <struts> <constant name="struts.enable.DynamicMethodInvocation" value="false" /> <constant name="struts.devMode" value="false" /> <constant name="struts.custom.i18n.resources" value="ApplicationResources" /> </struts>
ApplicationResources.properties
label.username= Username label.password= Password label.login= Login error.login= Invalid Username/Password. Please try again.
_menu.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<a href="${pageContext.request.contextPath}/">Home</a>
|
<a href="${pageContext.request.contextPath}/login">Login</a>
<br>
helloStruts2.jsp
<html>
<head>
<title>Struts 2 - Hello World</title>
</head>
<body>
<jsp:include page="_menu.jsp" />
<h2>Hello Struts2</h2>
</body>
</html>
login.jsp
<%@ page contentType="text/html; charset=UTF-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>Struts 2 - Login Application</title>
</head>
<body>
<jsp:include page="_menu.jsp" />
<h2>Struts 2 - Login Application</h2>
<s:actionerror />
<s:form action="/login" method="post">
<s:textfield name="username" key="label.username" size="20" />
<s:password name="password" key="label.password" size="20" />
<s:submit method="execute" key="label.login" align="center" />
</s:form>
<br>
Username: admin, password: admin123
</body>
</html>
userInfo.jsp
<%@ page contentType="text/html; charset=UTF-8"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
<html>
<head>
<title>User Info</title>
</head>
<body>
<jsp:include page="_menu.jsp" />
<h2>Howdy, ${loginedUsername}...!</h2>
</body>
</html>
HelloAction.java
package com.o7planning.struts2annotation.action;
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.Result;
import com.opensymphony.xwork2.ActionSupport;
@Action(value = "hello", //
results = { //
@Result(name = "helloPage", location = "/WEB-INF/pages/helloStruts2.jsp")
} //
)
public class HelloAction extends ActionSupport {
private static final long serialVersionUID = 1L;
@Override
public String execute() {
return "helloPage";
}
}
LoginAction.java
package com.o7planning.struts2annotation.action;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpSession;
import org.apache.struts2.ServletActionContext;
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.Result;
import com.opensymphony.xwork2.ActionSupport;
@Action(value = "login", //
results = { //
@Result(name = "showForm", location = "/WEB-INF/pages/login.jsp"), //
@Result(name = "loginError", location = "/WEB-INF/pages/login.jsp"), //
// loginSuccess: Redirect to /userInfo
@Result(name = "loginSuccess", type="redirect", location= "/userInfo") //
} //
)
public class LoginAction extends ActionSupport {
private static final long serialVersionUID = 7299264265184515893L;
private String username;
private String password;
public LoginAction() {
}
@Override
public String execute() {
if (this.username == null && this.password == null) {
return "showForm";
}
HttpServletRequest request = ServletActionContext.getRequest();
// Username и password действительны.
if ("admin".equals(this.username) && "admin123".equals(this.password)) {
HttpSession session = request.getSession();
// Сохранить userName в session.
session.setAttribute("loginedUsername", this.username);
return "loginSuccess";
}
// Username или password неправильный
else {
// ** Смотреть в ApplicationResources.properties
String message = getText("error.login");
addActionError(message);
return "loginError";
}
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
}
UserInfoAction.java
package com.o7planning.struts2annotation.action;
import org.apache.struts2.convention.annotation.Action;
import org.apache.struts2.convention.annotation.Result;
import com.opensymphony.xwork2.ActionSupport;
@Action(value = "userInfo", //
results = { //
@Result(name = "userInfoPage", location = "/WEB-INF/pages/userInfo.jsp")
} //
)
public class UserInfoAction extends ActionSupport {
private static final long serialVersionUID = 1L;
@Override
public String execute() {
return "userInfoPage";
}
}
Чтобы запустить приложение прямо в Eclipse, вам нужна конфигурация запуска Tomcat Maven Plugin.
Ввод:
- Name: Run Struts2Annotation
- Base Directory: ${workspace_loc:/Struts2Annotation}
- Goals: tomcat7:run
Tomcat Maven Plugin запущен:
В браузере, введите URL:
И URL:
Если вы ввели неправильные Username/password, страница отобразит следущее:
При правильном вводе:
Поток приложения:
Как Struts найти подходящий класс Action?
- Библиотека struts2-convention-plugin-*.jar выполняет обязанность поиска.
- Она читает в struts2.xml чтобы посмотреть инструкцию если есть, в противном случае она ищет с помощью руководства по умолчанию в Struts.
- По умолчанию:
- Искать классы с названиями, оканчивающимися на Action.
- Искать классы с названием package окачивающиеся наi: action, actions, struts, struts2.
Поэтому вы должны назвать классы Action по правилам выше, или конфигурировать ваши собственные правила в struts2.xml
