Simple Struts 2 Tutorial in eclipse with tomcat 7 server


There are loads and loads of Struts 2 Tutorials on the web but most of them are confusing for beginners and mostly outdated. Here is a very simple, basic and easy to understand tutorial.

Before we start you must make sure that you too are working with Apache Tomcat version 7.0.xx or higher (Apache Tomcat version 9.0 is yet in Beta), make sure you have Eclipse IDE with J2EE plugin and you have downloaded the struts2 related jar files (http://mirror.cc.columbia.edu/pub/software/apache/tomcat/tomcat-7/v7.0.61/bin/apache-tomcat-7.0.61.tar.gz) and have created a Server under eclipse.

My Configurations and Setups :
  1. Operating system: Mac OS X 10.10.2 (Yosemite)
  2. Application Server : Apache Tomcat version 7.0.61
  3. IDE: Eclipse Indigo Service Release 2 (20120216-1857)
Struts 2 Login Page Example

This is a very simple example to get started, we will have an index.php page with two fields username and password, if username = "code2care" and password ="1234" the LoginAction lets you to Homepage.jsp or else to ErrorLogin.jsp, let's get started!

1. Create a new Project under Eclipse Project Explorer: SimpleStrutsEx

2. Place the index.jsp page under SimpleStrutsEx -> WebContent

index.jsp
<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
   pageEncoding="ISO-8859-1"%>
<%@ taglib prefix="s" uri="/struts-tags"%>
   <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" 
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>Simple Struts Example : Code2care</title>
</head>
<body>
   <h1>Login Page : </h1>
   <form action="loginForm">
   
      <label for="uname">Enter UserName : </label>
           <input type="text" name="uname"/><br/>
       <label for="password">Enter Password : </label>
         <input type="password" name="password"/><br/>
 
      <input type="submit" value="Login"/>
   </form>
</body>
</html>

3. Create HomePage.jsp file under SimpleStrutsEx -> WebContent

homepage.jsp
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Welcome : Admin</title>
</head>
<body>
   Welcome :  <s:property value="uname"/>
</body>
</html>

4. Create LoginError.jsp page and place it also under : SimpleStrutsEx -> WebContent

LoginError.jsp
<%@ page contentType="text/html; charset=UTF-8" %>
<%@ taglib prefix="s" uri="/struts-tags" %>
<html>
<head>
<title>Login Error!</title>
</head>
<body>
  No user found!! :   <s:property value="uname"/>
</body>
</html>

5. Now lets create a package under SimpleStrutsEx -> Java Resources -> src and name it com.code2care.struts

6. Under the package, we just created in step 5 place our Action class called LoginAction.java

LoginAction.java
package com.code2care.struts;

public class LoginAction {

	private String uname;
	private String password;

	public String execute() throws Exception {

		if(uname.equals("code2care") && password.equals("1234")) 
			return "SUCCESS";
		else 
			return "ERROR";	
	}

	public String getUname() {
		return uname;
	}

	public void setUname(String uname) {
		this.uname = uname;
	}

	public String getPassword() {
		return password;
	}

	public void setPassword(String password) {
		this.password = password;
	}

}

7. Now lets create our web.xml file under : SimpleStrutsEx -> WebContent -> WEB-INF

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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	id="WebApp_ID" version="2.5">
	<display-name>StrutsExample</display-name>
	<welcome-file-list>
		<welcome-file>index.jsp</welcome-file>
	</welcome-file-list>
	<filter>
		<filter-name>loginProj</filter-name>
		<filter-class>org.apache.struts2.dispatcher.ng.filter.StrutsPrepareAndExecuteFilter</filter-class>
	</filter>
	<filter-mapping>
		<filter-name>loginProj</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>

8. Now create a folder named classes under : SimpleStrutsEx -> WebContent -> WEB-INF

9. Create struts.xml under classes folder w created at step 8.

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.devMode" value="true" />
   <package name="SimpleStrutsEx" extends="struts-default" >
     
      <action name="loginForm" 
            class="com.code2care.struts.LoginAction" method="execute">
            <result name="SUCCESS">/HomePage.jsp</result>
              <result name="ERROR">/LoginError.jsp</result>
      </action>
   </package>
</struts>

Note that you have added all Struts supporting jars under SimpleStrutsEx -> WebContent -> lib folder.

commons-fileupload-1.3.1.jar
commons-io-2.2.jar
commons-lang-2.4.jar
commons-lang3-3.2.jar
commons-logging-api-1.1.jar
freemarker-2.3.19.jar
javassist-3.11.0.GA.jar
ognl-3.0.6.jar
struts2-core-2.3.20.1.jar
xwork-core-2.3.20.1.jar

Source Code Download Link: Dropbox: SimpleStrutsEx.zip

Download PDF: Strut2 Simple Tutorial with Example.pdf