com.neurosys.q.service

Interface TokenGenerator<T extends Token<T>,R extends TokenRequest,E extends TokenEvent<T>>

Type Parameters:

T - as Token

E - as TokenEvent

All Superinterfaces:

ChangeGenerator<E>

public interface TokenGenerator<T extends Token<T>,R extends TokenRequest,E extends TokenEvent<T>>
extends ChangeGenerator<E>

Token request agent facing facade that generates tokens based on a TokenRequest.
In some setups the TokenGenerator maybe on a different machine like a phone etc.
The TokenGenerator may be the same or consult a TokenDispatcher.

Author:

Arjun Dhar

Method Summary

Modifier and Type	Method and Description
T	generate(R request, SingleTokenEvent<T> tokenEvent) Generate a Token based on Application defined input.
T	reGenerate(R request, SingleTokenEvent<T> tokenEvent) Incase of any error or problem, re-generate last token.
boolean	validate(R request) Similar to #generate(TokenRequest), however in this case there is no commitment to creating the actual Token.

Methods inherited from interface com.neurosys.events.ChangeGenerator

addChangeListener, getListeners, notifyAllListeners, setListeners

Method Detail

generate

T generate(R request,
           SingleTokenEvent<T> tokenEvent)
    throws TokenGenerationException

Generate a Token based on Application defined input.

Type Parameters:

R - as request

Parameters:

tokenEvent - as SingleTokenEvent, for optional TokenEvent.getBehaviors() to be passed

Returns:

Throws:

TokenGenerationException

reGenerate

T reGenerate(R request,
             SingleTokenEvent<T> tokenEvent)
      throws TokenProcessingException

Incase of any error or problem, re-generate last token. It takes an optional argument as context, for security or environment specific reasons.

Type Parameters:

R - as request

Parameters:

tokenEvent - as SingleTokenEvent, for optional TokenEvent.getBehaviors() to be passed

Returns:

Throws:

TokenProcessingException

validate

boolean validate(R request)
          throws TokenGenerationException

Similar to #generate(TokenRequest), however in this case there is no commitment to creating the actual Token. if it throws and Exception or returns false then means validation did not pass.

Parameters:

request - as

Returns:

boolean. true means success

Throws:

TokenGenerationException