public abstract class Authenticator extends Filter
Constructor and Description |
---|
Authenticator(Context context)
Constructor setting the mode to "required".
|
Authenticator(Context context,
boolean optional)
Constructor using the context's default enroler.
|
Authenticator(Context context,
boolean optional,
Enroler enroler)
Constructor.
|
Modifier and Type | Method and Description |
---|---|
protected abstract boolean |
authenticate(Request request,
Response response)
Attempts to authenticate the subject sending the request.
|
protected int |
authenticated(Request request,
Response response)
Invoked upon successful authentication.
|
protected int |
beforeHandle(Request request,
Response response)
Handles the authentication by first invoking the
authenticate(Request, Response) method. |
Enroler |
getEnroler()
Returns the enroler invoked upon successful authentication to update the
subject with new principals.
|
boolean |
isOptional()
Indicates if the authenticator is not required to succeed.
|
void |
setEnroler(Enroler enroler)
Sets the enroler invoked upon successful authentication.
|
void |
setOptional(boolean optional)
Indicates if the authenticator is not required to succeed.
|
protected int |
unauthenticated(Request request,
Response response)
Invoked upon failed authentication.
|
afterHandle, doHandle, getNext, handle, hasNext, setNext, setNext, start, stop
finalize, getApplication, getAuthor, getContext, getDescription, getLogger, getName, getOwner, isStarted, isStopped, setAuthor, setContext, setDescription, setName, setOwner
public Authenticator(Context context)
context
- The context.Authenticator(Context, boolean)
public Authenticator(Context context, boolean optional)
context
- The context.optional
- The authentication mode.Authenticator(Context, boolean, Enroler)
protected abstract boolean authenticate(Request request, Response response)
request
- The request sent.response
- The response to update.protected int beforeHandle(Request request, Response response)
authenticate(Request, Response)
method. Then, depending on the
result and the mode set, it invokes the
authenticated(Request, Response)
or the
unauthenticated(Request, Response)
method.beforeHandle
in class Filter
request
- The request to handle.response
- The response to update.Filter.CONTINUE
or
Filter.SKIP
or Filter.STOP
.protected int authenticated(Request request, Response response)
Filter.CONTINUE
.request
- The request sent.response
- The response to update.protected int unauthenticated(Request request, Response response)
Filter.STOP
.request
- The request sent.response
- The response to update.public Enroler getEnroler()
Role
are added based
on the available User
instances available.public boolean isOptional()
public void setEnroler(Enroler enroler)
enroler
- The enroler invoked upon successful authentication.public void setOptional(boolean optional)
optional
- True if the authentication success is optional.Copyright © 2005–2016. All rights reserved.