org.mozilla.jss.util

Class NullPasswordCallback

java.lang.Object

org.mozilla.jss.util.NullPasswordCallback

All Implemented Interfaces:

PasswordCallback

public class NullPasswordCallback
extends java.lang.Object
implements PasswordCallback

A PasswordCallback that immediately gives up. This should be used when a user is not available to enter a password. Any operations that require a password will fail if this is used, unless the token has already been logged in manually.

See Also:

CryptoToken.login(org.mozilla.jss.util.PasswordCallback)

Nested Class Summary

Nested classes/interfaces inherited from interface org.mozilla.jss.util.PasswordCallback

PasswordCallback.GiveUpException

Constructor Summary

Constructors

Constructor and Description
NullPasswordCallback()

Method Summary

Modifier and Type	Method and Description
Password	getPasswordAgain(PasswordCallbackInfo info) Tries supplying a password again.
Password	getPasswordFirstAttempt(PasswordCallbackInfo info) Supplies a password.

Methods inherited from class java.lang.Object

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

Constructor Detail

NullPasswordCallback

public NullPasswordCallback()

Method Detail

getPasswordFirstAttempt

public Password getPasswordFirstAttempt(PasswordCallbackInfo info)
                                 throws PasswordCallback.GiveUpException

Description copied from interface: PasswordCallback

Supplies a password. This is called on the first attempt; if it returns the wrong password, getPasswordAgain will be called on subsequent attempts.

Specified by:

getPasswordFirstAttempt in interface PasswordCallback

Parameters:

info - Information about the token that is being logged into.

Returns:

The password. This password object is owned by and will be cleared by the caller.

Throws:

PasswordCallback.GiveUpException - If the callback does not want to supply a password.

getPasswordAgain

public Password getPasswordAgain(PasswordCallbackInfo info)
                          throws PasswordCallback.GiveUpException

Description copied from interface: PasswordCallback

Tries supplying a password again. This callback will be called if the first callback returned an invalid password. It will be called repeatedly until it returns a correct password, or it gives up by throwing a GiveUpException.

Specified by:

getPasswordAgain in interface PasswordCallback

Parameters:

info - Information about the token that is being logged into.

Returns:

The password. This password object is owned by and will be cleared by the caller.

Throws:

PasswordCallback.GiveUpException - If the callback does not want to supply a password. This may often be the case if the first attempt failed.