Interface AuthenticationHandler<P,T>

Type Parameters:

P - defining the parameter type for setParams(Object)

T - defining the token type for getToken()

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

AbstractAuthenticationHandler, BasicAuthentication, GssApiAuthentication

public interface AuthenticationHandler<P,T>
extends Closeable

An AuthenticationHandler encapsulates a possibly multi-step authentication protocol. Intended usage:

setParams(something);
start();
sendToken(getToken());
while (!isDone()) {
    setParams(receiveMessageAndExtractParams());
    process();
    Object t = getToken();
    if (t != null) {
        sendToken(t);
    }
}

An AuthenticationHandler may be stateful and therefore is a Closeable.

Method Summary

Modifier and Type	Method	Description
void	close()
T	getToken()	Retrieves the last token generated.
boolean	isDone()	Tells whether is authentication mechanism is done (successfully or unsuccessfully).
void	process()	Produces the next authentication token, if any.
void	setParams(P input)	Sets the parameters for the next token generation via start() or process().
void	start()	Produces the initial authentication token that can be then retrieved via getToken().

Method Details

start

void start()
    throws IOException

Produces the initial authentication token that can be then retrieved via getToken().

Throws:

Exception - if an error occurs

IOException

process

void process()
      throws Exception

Produces the next authentication token, if any.

Throws:

Exception - if an error occurs

setParams

void setParams(P input)

Sets the parameters for the next token generation via start() or process().

Parameters:

input - to set, may be null

getToken

T getToken()
    throws IOException

Retrieves the last token generated.

Returns:

the token, or null if there is none

Throws:

Exception - if an error occurs

IOException

isDone

boolean isDone()

Tells whether is authentication mechanism is done (successfully or unsuccessfully).

Returns:

whether this authentication is done

close

void close()

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable