net.nicholaswilliams.java.licensing.licensor.interfaces.spi

Class AbstractPasswordPrompter

java.lang.Object

net.nicholaswilliams.java.licensing.licensor.interfaces.spi.AbstractPasswordPrompter

All Implemented Interfaces:

PasswordPrompter

Direct Known Subclasses:

AbstractTextInterfaceDevice

public abstract class AbstractPasswordPrompter
extends Object
implements PasswordPrompter

Abstract class for prompting for passwords.

Since:

1.0.0

Version:

1.0.0

Author:

Nick Williams

Constructor Summary

Constructors

Constructor and Description
AbstractPasswordPrompter()

Method Summary

Methods

Modifier and Type	Method and Description
boolean	passwordsMatch(char[] password1, char[] password2) Checks whether the two passwords match.
char[]	promptForValidPassword(int minLength, int maxLength, String promptMessage, String promptConfirmMessage, String lengthError, String matchError, OutputDevice device) Prompts for a valid password by asking for the password using PasswordPrompter.readPassword(String, Object...), checking its length against the constraints, asking for the password to be confirmed, and checking to make sure the passwords match.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.nicholaswilliams.java.licensing.licensor.interfaces.spi.PasswordPrompter

promptForValidPassword, readPassword, readPassword

Constructor Detail

AbstractPasswordPrompter

public AbstractPasswordPrompter()

Method Detail

passwordsMatch

public boolean passwordsMatch(char[] password1,
                     char[] password2)

Checks whether the two passwords match.

Specified by:

passwordsMatch in interface PasswordPrompter

Parameters:

password1 - The entered password

password2 - The confirmed password

Returns:

true if the passwords match, false otherwise.

promptForValidPassword

public char[] promptForValidPassword(int minLength,
                            int maxLength,
                            String promptMessage,
                            String promptConfirmMessage,
                            String lengthError,
                            String matchError,
                            OutputDevice device)
                              throws IOError

Prompts for a valid password by asking for the password using PasswordPrompter.readPassword(String, Object...), checking its length against the constraints, asking for the password to be confirmed, and checking to make sure the passwords match.

This method should continue to ask for the password over and over again until a valid password is entered and confirmed or the user cancels the operation.

Specified by:

promptForValidPassword in interface PasswordPrompter

Parameters:

minLength - The minimum legal length for the password

maxLength - The maximum legal length for the password

promptMessage - The message to prompt for the password initially (the message should not include format specifiers)

promptConfirmMessage - The message to prompt to confirm the password (the message should not include format specifiers)

lengthError - The message to display if the password does not meet the minimum or maximum length requirements (the message should not include format specifiers)

matchError - The message to display if the two entered passwords do not match (the message should not include format specifiers)

device - The device that should be used to output messages and errors

Returns:

the valid, confirmed password entered by the user.

Throws:

IOError - if an I/O error occurs.