org.cyclos.impl.access

Interface SessionHandler

public interface SessionHandler

Handler for user sessions, containing methods to manage them

Author:

luis

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	SessionHandler.UserCheckResult

Method Summary

Methods

Modifier and Type	Method and Description
SessionHandler.UserCheckResult	checkUserAccess(boolean forLogin, Network network, java.lang.String channelName, java.lang.String remoteAddress, UserLocatorVO locator, java.lang.String password) Checks the access for an user for a channel / network
Session	create(Channel channel, java.lang.String remoteAddress, BasicUser user) Creates a new session for the given user
Session	findByToken(java.lang.String token) Returns a session by token
Pair<Session,TimeInterval>	getIfValid(java.lang.String remoteAddress, java.lang.String sessionToken) Returns an active session by remote address and session token.
void	invalidate(java.lang.String remoteAddress, java.lang.String sessionToken) Invalidates the session with the given token, under the given remote address
Session	login(java.lang.String channelName, java.lang.String remoteAddress, UserLocatorVO locator, java.lang.String password) Performs a login.
int	purgeExpired() Purges all expired sessions
void	updateTimeout(java.lang.String sessionToken, TimeInterval timeout) Updates the expiration time of the session with the given token

Method Detail

checkUserAccess

SessionHandler.UserCheckResult checkUserAccess(boolean forLogin,
                                             Network network,
                                             java.lang.String channelName,
                                             java.lang.String remoteAddress,
                                             UserLocatorVO locator,
                                             java.lang.String password)

Checks the access for an user for a channel / network

create

Session create(Channel channel,
             java.lang.String remoteAddress,
             BasicUser user)

Creates a new session for the given user

findByToken

Session findByToken(java.lang.String token)
                    throws EntityNotFoundException

Returns a session by token

Throws:

EntityNotFoundException

getIfValid

Pair<Session,TimeInterval> getIfValid(java.lang.String remoteAddress,
                                    java.lang.String sessionToken)

Returns an active session by remote address and session token. The session timeout is also returned. If the session has expired or doesn't match the remote address, returns null

invalidate

void invalidate(java.lang.String remoteAddress,
              java.lang.String sessionToken)

Invalidates the session with the given token, under the given remote address

login

Session login(java.lang.String channelName,
            java.lang.String remoteAddress,
            UserLocatorVO locator,
            java.lang.String password)
              throws FrameworkException,
                     LoginException,
                     RemoteAddressBlockedException

Performs a login. Checks the remote address blocking by exceeding invalid username attempts, and creates a session

Throws:

FrameworkException

LoginException

RemoteAddressBlockedException

purgeExpired

int purgeExpired()

Purges all expired sessions

updateTimeout

void updateTimeout(java.lang.String sessionToken,
                 TimeInterval timeout)

Updates the expiration time of the session with the given token