SessionMan решает проблему сохранения состояний в вебсервисах

<xsd:element name="UserAuthElement">
	<xsd:complexType>
		<xsd:sequence>
			<xsd:element name="login" type="xsd:string"
				     minOccurs="1" maxOccurs="1"/>
			<xsd:element name="password" type="xsd:string"
				     minOccurs="1" maxOccurs="1" />
		</xsd:sequence>
	</xsd:complexType>
</xsd:element>

  

Оставшиеся же две принимают только SOAP конверт содержащий идентификатор сессии, что с одной стороны, необходимо для проверки актуальности сессии перед выполнением любой операции, и с другой — вполне достаточно для объяснения работы с библиотекой SessionMan.

После того, как wsdl-документ создан, мы запускаем утилиту wsdl2java, прилагающуюся к Axis2 и дожидаемся окончания генерации всех необходимых классов.

Полнофукнциональный пример, использующий библиотеку SessionMan, совместно с Axis2, доступен из SVN репозитория: http://sessionman.googlecode.com/svn/trunk/sessionman-example.

Инструкция по сборке проекта для работы в среде Eclipse 3.2: http://sessionman.googlecode.com/svn/trunk/sessionman-example/readme.txt.

SessionMan выходит на арену

Результатом работы wsdl2java является целый пакет классов, среди которых SessionManExampleServiceSkeleton — сердце нашего будущего сервиса. Для дальнейшей работы мы унаследуем этот класс и создадим свой SessionManExampleService.

Подключаем SessionMan:

	import com.webtair.session.*;
	import com.webtair.session.artifact.*;
	import com.webtair.sessionman.ws.types.*;
  

Добавляем контроллер сессий к сервис классу:

public class SessionManExampleService extends
	SessionManExampleServiceSkeleton {

	...
	/** SessionMan instance — main goal of this example */
	private static SessionMan<SimpleSessionInfo> sessions
		= new SessionMan<SimpleSessionInfo>();

  

Здесь необходимы пояснения:

1. Класс com.webtair.session.SessionMan имеет два конструктора: public SessionMan(ConfigBean config) и public SessionMan() — второй создает конфигурацию по умолчанию со временем жизни сессии 30мин и периодичностью очистки устаревших сессий 10мин. С помощью первого конструктора пользователю предоставляется возможность управлять этими параметрами, а так же определить стартовую размерность таблицы для сессий, передав, соответствующим образом настроенный, com.webtair.session.config.ConfigBean
2. В качестве хранилища вашей информации может использоваться любой класс, реализующий интерфейс com.webtair.session.artifact.SessionInfo, для базовых операций с сессией библиотека предоставляет класс SimpleSessionInfo.

Таким образом, если Вам необходимо создать хранилище для, скажем состояния корзины, достаточно будет реализовать интерфейс SessionInfo c сответствующей функциональностью.

Создаем сессию и возвращем ее кленту вебсервиса:

/**
* Method that allow for client to login under this ws
* @return IdSessionDocument — soap envelope with session id;
*/
@Override
public IdSessionDocument login
	(UserAuthElementDocument userAuthElementDocument) {
 /* default login and pass for examples only. At this place you
	* mast recieve real pass from the real storage like RDBMS or
	* config-file or somthing else.
	*/
	String defaultLogin = "sessionman";
	String defaultpass = "example";

	UserAuthElement userAuthElement =
		userAuthElementDocument.getUserAuthElement();

	if (userAuthElement.getLogin().equals(defaultLogin)
	&& userAuthElement.getPassword().equals(defaultpass)){

	// request for id session from SessionMan lib
		idSession =
		 sessions.putSessionInfo(userAuthElement.getLogin(),
	new SimpleSessionInfo());
	}
	...
}

  

Ключевым выражением в процедуре получения идентификатора является метод putSessionInfo(), "вкладывающий" в HashMap контроллера SessionInfo и возвращающий уникальный идентификатор сессии.

Провереям актуальность сессии:

Вызов метода validateSession(String idSession), позволяет не только проверить "жива" ли сессия, но и автоматически обновляет время ее последнего использования, что приводит к ее автоматическому пролонгированию на время указанное в ConfigBean (30 мин по умолчанию).

Вызов метода isSessionExpired(String idSession), позволяет просто определить завершилось ли время жизни сессии, не обновляя ее последнего использования.

LogOut и "чистка" сессий

Если пользователь не выполнил явной операции disconnect (logout), чисткой HashMap займется фоновый поток, который проснется через интервал времени, определенный в ConfigBean.

Полнофукнциональный пример, использующий библиотеку SessionMan, совместно с Axis2, доступен из SVN репозитория: http://sessionman.googlecode.com/svn/trunk/sessionman-example.

Ресурсы

1. Английская версия этой статьи: http://www.webtair.com/articles/sessionman_en.html
2. Online banking with Apache Geronimo and Axis2: http://www-128.ibm.com/developerworks/edu/os-dw-os-ag-onbank1.html
3. WebTair SessionMan library: http://www.webtair.com/sessionman
4. Example for SessionMan and Axis2:http://sessionman.googlecode.com/svn/trunk/sessionman-example
5. SessionMan online API JavaDoc: http://www.webtair.com/sessionman/api/.