org.apache.shiro.mgt

Interface RememberMeManager

All Known Implementing Classes:

AbstractRememberMeManager, CookieRememberMeManager

public interface RememberMeManager

A RememberMeManager is responsible for remembering a Subject's identity across that Subject's sessions with the application.

Since:

0.9

Method Summary

Modifier and Type	Method and Description
void	forgetIdentity(SubjectContext subjectContext) Forgets any remembered identity corresponding to the subject context map being used to build a subject instance.
PrincipalCollection	getRememberedPrincipals(SubjectContext subjectContext) Based on the specified subject context map being used to build a Subject instance, returns any previously remembered principals for the subject for automatic identity association (aka 'Remember Me').
void	onFailedLogin(Subject subject, AuthenticationToken token, AuthenticationException ae) Reacts to a failed authentication attempt, typically by forgetting any previously remembered principals for the Subject.
void	onLogout(Subject subject) Reacts to a Subject logging out of the application, typically by forgetting any previously remembered principals for the Subject.
void	onSuccessfulLogin(Subject subject, AuthenticationToken token, AuthenticationInfo info) Reacts to a successful authentication attempt, typically saving the principals to be retrieved ('remembered') for future system access.

Method Detail

getRememberedPrincipals

PrincipalCollection getRememberedPrincipals(SubjectContext subjectContext)

Based on the specified subject context map being used to build a Subject instance, returns any previously remembered principals for the subject for automatic identity association (aka 'Remember Me').

The context map is usually populated by a Subject.Builder implementation. See the SubjectFactory class constants for Shiro's known map keys.

Parameters:

subjectContext - the contextual data, usually provided by a Subject.Builder implementation, that is being used to construct a Subject instance.

Returns:

he remembered principals or null if none could be acquired.

Since:

1.0

forgetIdentity

void forgetIdentity(SubjectContext subjectContext)

Forgets any remembered identity corresponding to the subject context map being used to build a subject instance.

The context map is usually populated by a Subject.Builder implementation. See the SubjectFactory class constants for Shiro's known map keys.

Parameters:

subjectContext - the contextual data, usually provided by a Subject.Builder implementation, that is being used to construct a Subject instance.

Since:

1.0

onSuccessfulLogin

void onSuccessfulLogin(Subject subject,
                       AuthenticationToken token,
                       AuthenticationInfo info)

Reacts to a successful authentication attempt, typically saving the principals to be retrieved ('remembered') for future system access.

Parameters:

subject - the subject that executed a successful authentication attempt

token - the authentication token submitted resulting in a successful authentication attempt

info - the authenticationInfo returned as a result of the successful authentication attempt

Since:

1.0

onFailedLogin

void onFailedLogin(Subject subject,
                   AuthenticationToken token,
                   AuthenticationException ae)

Reacts to a failed authentication attempt, typically by forgetting any previously remembered principals for the Subject.

Parameters:

subject - the subject that executed the failed authentication attempt

token - the authentication token submitted resulting in the failed authentication attempt

ae - the authentication exception thrown as a result of the failed authentication attempt

Since:

1.0

onLogout

void onLogout(Subject subject)

Reacts to a Subject logging out of the application, typically by forgetting any previously remembered principals for the Subject.

Parameters:

subject - the subject logging out.

Since:

1.0