net.moznion.random.string

Class RandomStringGenerator

java.lang.Object

net.moznion.random.string.RandomStringGenerator

public class RandomStringGenerator
extends Object

Generator of random string.

Author:

moznion

Constructor Summary

Constructors

Constructor and Description
RandomStringGenerator() Instantiate generator with default number of upper limit for regex quantifiers, for example *, + and etc (default value: 10).
RandomStringGenerator(int numOfUpperLimit) Instantiate generator with number of upper limit for regex quantifiers, for example *, + and etc.

Method Summary

Modifier and Type	Method and Description
String	generateByRegex(String regex) Generate random string from regular expression.
String	generateFromPattern(String pattern) Generate random string from pattern.
int	getNumOfUpperLimit() Get number of upper limit for regex quantifiers, for example *, + and etc.
void	setNumOfUpperLimit(int numOfUpperLimit) Set number of upper limit for regex quantifiers, for example *, + and etc.

Methods inherited from class java.lang.Object

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

Constructor Detail

RandomStringGenerator

public RandomStringGenerator(int numOfUpperLimit)

Instantiate generator with number of upper limit for regex quantifiers, for example *, + and etc.

Parameters:

numOfUpperLimit - Number of upper limit for quantifiers

RandomStringGenerator

public RandomStringGenerator()

Instantiate generator with default number of upper limit for regex quantifiers, for example *, + and etc (default value: 10).

Method Detail

generateFromPattern

public String generateFromPattern(String pattern)

Generate random string from pattern.

You can use following characters as pattern.

• c : Any Latin lower-case character
• C : Any Latin upper-case character
• n : Any digit [0-9]
• ! : A symbol character [~`!@$%^&*()-_+= []|\:;"'.<>?/#,]
• . : Any of the above
• s : A "salt" character [A-Za-z0-9./]
• b : An ASCIII character which has code from 0 to 255

e.g.

 
 RandomStringGenerator generator = new RandomStringGenerator();
 
 // generates random string (e.g. "aB4@X.Ç")
 String randomString = generator.generateFromPattern("cCn!.sb");
 
 

Parameters:

pattern - Pattern string

Returns:

Random string which is generated according to pattern

generateByRegex

public String generateByRegex(String regex)

Generate random string from regular expression.

You can use following meta characters as regex.

• \w : Alphanumeric + "_" [A-Za-z0-9_]
• \d : Digits [0-9]
• \W : Printable characters other than those in \w
• \D : Printable characters other than those in \d
• \s : Whitespace characters [ \t]
• \S : Printable characters
• . : Printable characters
• [] : Character classes (Example of usage [a-zA-Z])
• {}: Repetition
• * : Same as {0,}
• ? : Same as {0,1}
• + : Same as {1,}

e.g.

 
 RandomStringGenerator generator = new RandomStringGenerator();
 
 // generates random string (e.g. "a5B123 18X")
 String randomString = generator.generateByRegex("\\w+\\d\*\s[0-9]{0,3}X");
 
 

Parameters:

regex - Pattern based on regular expression

Returns:

Random String

getNumOfUpperLimit

public int getNumOfUpperLimit()

Get number of upper limit for regex quantifiers, for example *, + and etc.

Returns:

Number of upper limit for quantifiers

setNumOfUpperLimit

public void setNumOfUpperLimit(int numOfUpperLimit)

Set number of upper limit for regex quantifiers, for example *, + and etc.

Parameters:

numOfUpperLimit - Number of upper limit for quantifiers