org.i3xx.step.due.service.model

Interface SessionService

All Known Implementing Classes:

SessionServiceImpl

public interface SessionService

Method Summary

Methods

Modifier and Type	Method and Description
Session	createSession(String cert, String mandator, long timeout, String sessionId, Map<String,String> params) Creates a session to handle resources
boolean	destroy(String cert, String mandatorId, String sessionId) Destroys a session
boolean	exists(String mandatorId, String sessionId) Returns true if the session is available.
Session	getSession(String cert, String mandatorId, String sessionId) Gets a session or null if the session doesn't exist.
org.osgi.framework.ServiceReference<?>[]	getSessionReference(String mandatorId, String sessionId) Gets the session references of the matching sessions

Method Detail

createSession

Session createSession(String cert,
                    String mandator,
                    long timeout,
                    String sessionId,
                    Map<String,String> params)
                      throws SessionException

Creates a session to handle resources

Parameters:

cert - The string to authenticate

mandator - The mandator of the session

timeout - The timeout of the session

sessionId - The id of the session, if the sessionId is null a new id is created.

params - The parameter of the session to be put to the service registry (not the session)

Returns:

The session

Throws:

SessionException - If the session can't be created.

SessionAlreadyExistsException - If the sessionId exists.

getSession

Session getSession(String cert,
                 String mandatorId,
                 String sessionId)

Gets a session or null if the session doesn't exist.

Parameters:

cert - The string to authenticate

mandatorId - The mandator of the session

sessionId - The id of the session

Returns:

The session

getSessionReference

org.osgi.framework.ServiceReference<?>[] getSessionReference(String mandatorId,
                                                           String sessionId)

Gets the session references of the matching sessions

Parameters:

mandatorId - The id of the mandator (optional)

sessionId - The id of the session (optional)

Returns:

The session reference

exists

boolean exists(String mandatorId,
             String sessionId)

Returns true if the session is available.

Note: If the sessionId is '0' the mandator id is not optional.

Parameters:

mandatorId - The id of the mandator (optional)

sessionId - The id of the session

Returns:

The flag

destroy

boolean destroy(String cert,
              String mandatorId,
              String sessionId)

Destroys a session

Parameters:

cert - The string to authenticate

mandatorId - The mandator of the session

sessionId - The id of the session

Returns:

The flag, true if the service is destroyed properly, false otherwise.