SessionAware Interface Example

The SessionAware interface must be implemented by the Action class to store the information in the session scope.

Method of SessionAware interface

It contains only one method setSession.

Public and abstract Method	Description
void setSession(Map<String,Object> map)	struts framework calls this method by passing the instance of SessionMap class.

SessionMap class

The struts 2 framework passes the instance of org.apache.struts2.dispatcher.SessionMap. It extends the java.util.AbstractMap class which implements the java.util.Map.SessionMap. There are many useful methods of SessionMap class.

Methods of SessionMap class

The commonly used methods of SessionMap class are as follows:

Methods	Description
public Object put(Object key, Object value)	stores an attribute in the HttpSession object.
public Object remove(Object key)	removes the attribute for the specified key and returns the attribute value.
public Object get(Object key)	return a value for the corresponding key from the HttpSession object.
public Set entrySet()	returns a set object containing all the key and value objects set in the HttpSession object.
public void invalidate()	invalidates the current HttpSession object.
public void clear()	removes all the attributes set in the HttpSession object.

Example of SessionAware interface

This example contains three links login, logout and profile. You cannot click on the profile page untill you are logged in. After getting logged in, you may go to the profile page. If the end user clicks on the logout link, he will not be able to access the profile page.

Steps are as follows:

add struts and servlet library
index.jsp for providing links to the login, logout and profile.
struts.xml for defining the result and action.
Login.java for defining login and logout logic.
Profile.java for checking if the user is logged in or not.
View components for the displaying results.

1) Add struts and servlet library

You need to add struts 2 and servlet library.

download the struts2 jar files

download the servlet-api.jar file

2) Create index.jsp for input

This jsp page creates three links for login, logout and profile.

index.jsp

<a href="loginform">Login</a>|
<a href="logout">Logout</a>|
<a href="profile">Profile</a>

3) Define action and result in struts.xml

This xml file defines one package and 4 actions. Each action defines at least one result page.

For the loginprocess and logout actions, we are using the same action class but there invocation methods are different.

struts.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE struts PUBLIC "-//Apache Software Foundation//DTD Struts Configuration 2.1//EN" "http://struts.apache.org/dtds/struts-2.1.dtd">
<struts>

<constant name="struts.devMode" value="true"></constant>

<package name="abc" extends="struts-default" >

<action name="loginform">
<result>login.jsp</result>
</action>

<action name="login" class="com.javatpoint.Login" method="execute">
<result name="success">/login-success.jsp</result>
<result name="login">/login-error.jsp</result>
</action>

<action name="logout" class="com.javatpoint.Login" method="logout">
<result name="success">/logout-success.jsp</result>
</action>
 
 <action name="profile" class="com.javatpoint.Profile" method="execute">
<result name="success">/profile-success.jsp</result>
<result name="login">/profile-error.jsp</result>
</action>
</package>
</struts>    

4) Create the action class for login and logout

This action class implements the SessionAware interface and overrides the setSession method to store the information in the session scope.

For logout, we are simply calling the invalidate() method of SessionMap.

Login.java

package com.javatpoint;

import java.util.Map;

import org.apache.struts2.dispatcher.SessionMap;
import org.apache.struts2.interceptor.SessionAware;

public class Login implements SessionAware{
private String name,password;
private SessionMap<String,Object> sessionMap;

//getters and setters

@Override
public void setSession(Map<String, Object> map) {
	sessionMap=(SessionMap)map;
}

public String execute(){
if(password.equals("admin")){
	sessionMap.put("login","true");
	sessionMap.put("name",name);
	
	return "success";
}
else{
	return "login";
}
}

public String logout(){
	if(sessionMap!=null){
		sessionMap.invalidate();
	}
	return "success";
}

}

5) Create the Profile class

This class gets the information from the session scope, if any information is found in the session scope with login name, it returns success otherwise false.

Profile.java

package com.javatpoint;

import javax.servlet.http.HttpSession;
import org.apache.struts2.ServletActionContext;

public class Profile{

	public String execute(){
		HttpSession session=ServletActionContext.getRequest().getSession(false);
		if(session==null || session.getAttribute("login")==null){
			return "login";
		}
		else{
			return "success";
		}
	}
}

6) Create view components

There are many view components:

login.jsp
login-success.jsp
login-error.jsp
logout-success.jsp
profile-success.jsp
profile-error.jsp

view components for login

login.jsp

This page creates the login form.

<%@ taglib uri="/struts-tags" prefix="s" %>

<s:form action="login">
<s:textfield name="name" label="Name"></s:textfield>
<s:password name="password" label="Password"></s:password>
<s:submit value="login"></s:submit>
</s:form>

login-success.jsp

This page prints the welcome message with the username.

<jsp:include page="index.jsp"></jsp:include>
<hr>
<%@ taglib uri="/struts-tags" prefix="s" %>

Welcome, <s:property value="#session.name"/>

login-error.jsp

This page displays the error message.

<jsp:include page="index.jsp"></jsp:include>
<hr>
Sorry, username or password error!
<jsp:include page="login.jsp"></jsp:include>

view components for logout

logout-success.jsp

This page simply displays the successfully logged out message.

<jsp:include page="index.jsp"></jsp:include>
<hr>
<p>You are successfully logged out!</p>

view components for profile

profile-success.jsp

This page prints the welcome to profile message.

<jsp:include page="index.jsp"></jsp:include>
<hr>
<%@ taglib uri="/struts-tags" prefix="s" %>

Welcome to Profile, <s:property value="#session.name"/>

profile-error.jsp

This page prints the message to login first and includes the login.jsp page.

<jsp:include page="index.jsp"></jsp:include>
<hr>
Sorry, username or password error!
<jsp:include page="login.jsp"></jsp:include>

download this example (developed in Eclipse IDE without jar)

download this example (developed in Myeclipse IDE)

Output

If you click on the profile link, you will be forwarded to profile-error.jsp

Now write your name for name and admin for the password.

Now, you are successfully logged in

Now, click on the profile.

Struts Tutorial