org.passay

Class PasswordGenerator

java.lang.Object

org.passay.PasswordGenerator

public class PasswordGenerator
extends Object

Creates passwords that meet password character rule criteria.

Author:

Sean C. Sullivan, Middleware Services

Constructor Summary

Constructors

Constructor and Description
PasswordGenerator() Default constructor.
PasswordGenerator(Random r) Creates a new password generator with the supplied random.

Method Summary

Modifier and Type	Method and Description
protected void	fillRandomCharacters(CharSequence source, int count, Appendable target) Fills the supplied target with count random characters from source.
String	generatePassword(int length, CharacterRule... rules) Deprecated. use generatePassword(int, Rule[])
String	generatePassword(int length, List<? extends Rule> rules) Generates a password of the supplied length which meets the requirements of the supplied character rules.
<T extends Rule> String	generatePassword(int length, T... rules) See generatePassword(int, List).
int	getRetryCount() Tracks the number retries.
protected void	randomize(CharBuffer buffer) Randomizes the contents of the given buffer.

Methods inherited from class java.lang.Object

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

Constructor Detail

PasswordGenerator

public PasswordGenerator()

Default constructor. Instantiates a secure random for password generation.

PasswordGenerator

public PasswordGenerator(Random r)

Creates a new password generator with the supplied random.

Parameters:

r - random

Method Detail

getRetryCount

public int getRetryCount()

Tracks the number retries. A password generator with a high percentage of retries may be indicative of a password ruleset that needs adjustment.

Returns:

Total number of retry attempts.

generatePassword

@Deprecated
public String generatePassword(int length,
                                           CharacterRule... rules)

Deprecated. use generatePassword(int, Rule[])

See generatePassword(int, List).

Parameters:

length - of password to generate

rules - to generate compliant password from

Returns:

generated password

generatePassword

public <T extends Rule> String generatePassword(int length,
                                                T... rules)

See generatePassword(int, List).

Type Parameters:

T - type of rule

Parameters:

length - of password to generate

rules - to generate compliant password from

Returns:

generated password

generatePassword

public String generatePassword(int length,
                               List<? extends Rule> rules)

Generates a password of the supplied length which meets the requirements of the supplied character rules. For length to be evaluated it must be greater than the number of characters defined in the character rule.

Parameters:

length - of password to generate

rules - to generate compliant password from

Returns:

generated password

fillRandomCharacters

protected void fillRandomCharacters(CharSequence source,
                                    int count,
                                    Appendable target)

Fills the supplied target with count random characters from source.

Parameters:

source - of random characters.

count - number of random characters.

target - character sequence that will hold characters.

randomize

protected void randomize(CharBuffer buffer)

Randomizes the contents of the given buffer.

Parameters:

buffer - character buffer whose contents will be randomized.