de.schlichtherle.truezip.crypto.raes.param.console
Class AesCipherParametersView

java.lang.Object
  de.schlichtherle.truezip.crypto.raes.param.console.AesCipherParametersView

All Implemented Interfaces:

PromptingKeyProvider.View<AesCipherParameters>

@ThreadSafe
public final class AesCipherParametersView
extends Object
implements PromptingKeyProvider.View<AesCipherParameters>

A console based user interface to prompt for passwords.

Author:

Christian Schlichtherle

CLASS_NAME

private static final String CLASS_NAME

resources

static final ResourceBundle resources

con

static final Console con

The console to use for I/O. If null, the prompt methods are never called, so it's safe to assume that it's not null in these methods.

lock

private static final AesCipherParametersView.PromptingLock lock

Used to lock out prompting by multiple threads.

MIN_PASSWD_LEN

private static final int MIN_PASSWD_LEN

The minimum acceptable length of a password.

See Also:

Constant Field Values

lastResource

private static URI lastResource

The last resource ID used when prompting. Initialized to the empty string.

YES

private static final String YES

NO

private static final String NO

AesCipherParametersView

public AesCipherParametersView()

promptWriteKey

public final void promptWriteKey(PromptingKeyProvider.Controller<AesCipherParameters> controller)

Description copied from interface: PromptingKeyProvider.View

Prompts the user for the key for (over)writing the contents of a new or existing protected resource. Upon return, the implementation should have updated the key property of the given controller.

If the implementation has called PromptingKeyProvider.Controller.setKey(K) with a non-null parameter, then a clone of this object will be used as the key.

Otherwise, prompting for a key is permanently disabled and each subsequent call to SafeKeyProvider.getWriteKey() or SafeKeyProvider.getReadKey(boolean) results in a KeyPromptingCancelledException until PromptingKeyProvider.resetCancelledKey() or PromptingKeyProvider.resetUnconditionally() gets called.

Specified by:

promptWriteKey in interface PromptingKeyProvider.View<AesCipherParameters>

Parameters:

controller - The key controller for storing the result.

promptReadKey

public void promptReadKey(PromptingKeyProvider.Controller<AesCipherParameters> controller,
                          boolean invalid)

Description copied from interface: PromptingKeyProvider.View

Prompts the user for the key for reading the contents of an existing protected resource. Upon return, the implementation should have updated the key property of the given controller.

If the implementation has called PromptingKeyProvider.Controller.setKey(K) with a non-null parameter, then a clone of this object will be used as the key.

Otherwise, if the implementation has called PromptingKeyProvider.Controller.setKey(K) with a null parameter or throws a KeyPromptingCancelledException, then prompting for the key is permanently disabled and each subsequent call to SafeKeyProvider.getWriteKey() or SafeKeyProvider.getReadKey(boolean) results in a KeyPromptingCancelledException until PromptingKeyProvider.resetCancelledKey() or PromptingKeyProvider.resetUnconditionally() gets called.

Otherwise, the state of the key provider is not changed and this method gets called again.

Specified by:

promptReadKey in interface PromptingKeyProvider.View<AesCipherParameters>

Parameters:

controller - The key controller for storing the result.

invalid - true iff a previous call to this method resulted in an invalid key.