Module io.inverno.mod.security.http

Package io.inverno.mod.security.http.login

Class LoginActionHandler<A extends LoginCredentials,B extends Authentication,C extends io.inverno.mod.http.base.ExchangeContext,D extends Exchange<C>>

java.lang.Object

io.inverno.mod.security.http.login.LoginActionHandler<A,B,C,D>

Type Parameters:

A - the login credentials type

B - the authentication type

C - the context type

D - the exchange type

All Implemented Interfaces:

ExchangeHandler<C,D>, ReactiveExchangeHandler<C,D>

public class LoginActionHandler<A extends LoginCredentials,B extends Authentication,C extends io.inverno.mod.http.base.ExchangeContext,D extends Exchange<C>>
extends Object
implements ExchangeHandler<C,D>

An exchange handler that authenticates login credentials and delegates further processing to success and failure handlers.

A login action handler is typically used in a form login authentication to authenticate the credentials sent by a user in a POST request.

It relies on a CredentialsExtractor to extract login credentials from the request, an Authenticator to authenticate them, a LoginSuccessHandler and a LoginFailureHandler to respectively handle successful authentications and failed authentications.

Since:

1.5

Author:

Jeremy Kuhn

Constructor Summary

Constructors

Constructor	Description
LoginActionHandler(CredentialsExtractor<A> credentialsExtractor, Authenticator<A,B> authenticator)	Creates a login action handler with the specified credentials extractor and authenticator.
LoginActionHandler(CredentialsExtractor<A> credentialsExtractor, Authenticator<A,B> authenticator, LoginSuccessHandler<B,C,D> loginSuccessHandler, LoginFailureHandler<C,D> loginFailureHandler)	Creates a login action handler with the specified credentials extractor, authenticator, login success handler and login failure handler.

Method Summary

Modifier and Type	Method	Description
reactor.core.publisher.Mono<Void>	defer(D exchange)
Authenticator<A,B>	getAuthenticator()	Returns the authenticator.
CredentialsExtractor<A>	getCredentialsExtractor()	Returns the credentials extractor.
LoginFailureHandler<C,D>	getLoginFailureHandler()	Returns the login failure handler.
LoginSuccessHandler<B,C,D>	getLoginSuccessHandler()	Returns the login success handler.
void	handle(D exchange)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.inverno.mod.http.server.ReactiveExchangeHandler

intercept

Constructor Details

LoginActionHandler

public LoginActionHandler(CredentialsExtractor<A> credentialsExtractor,
 Authenticator<A,B> authenticator)

Creates a login action handler with the specified credentials extractor and authenticator.

Parameters:

credentialsExtractor - a credentials extractor

authenticator - an authenticator

LoginActionHandler

public LoginActionHandler(CredentialsExtractor<A> credentialsExtractor,
 Authenticator<A,B> authenticator,
 LoginSuccessHandler<B,C,D> loginSuccessHandler,
 LoginFailureHandler<C,D> loginFailureHandler)

Creates a login action handler with the specified credentials extractor, authenticator, login success handler and login failure handler.

Parameters:

credentialsExtractor - a credentials extractor

authenticator - an authenticator

loginSuccessHandler - a login success handler

loginFailureHandler - a login failure handler

Method Details

getCredentialsExtractor

public CredentialsExtractor<A> getCredentialsExtractor()

Returns the credentials extractor.

Returns:

the credentials extractor

getAuthenticator

public Authenticator<A,B> getAuthenticator()

Returns the authenticator.

Returns:

the authenticator

getLoginSuccessHandler

public LoginSuccessHandler<B,C,D> getLoginSuccessHandler()

Returns the login success handler.

Returns:

the login success handler

getLoginFailureHandler

public LoginFailureHandler<C,D> getLoginFailureHandler()

Returns the login failure handler.

Returns:

the login failure handler

defer

public reactor.core.publisher.Mono<Void> defer(D exchange)

Specified by:

defer in interface ExchangeHandler<A extends LoginCredentials,B extends Authentication>

Specified by:

defer in interface ReactiveExchangeHandler<A extends LoginCredentials,B extends Authentication>

handle

public void handle(D exchange)
            throws io.inverno.mod.http.base.HttpException

Specified by:

handle in interface ExchangeHandler<A extends LoginCredentials,B extends Authentication>

Throws:

io.inverno.mod.http.base.HttpException