| java.lang.Object
 org.apache.commons.lang.RandomStringUtils
| RandomStringUtils | | public class RandomStringUtils (Code) | | Operations for random Strings.
Currently private high surrogate characters are ignored.
These are unicode characters that fall between the values 56192 (db80)
and 56319 (dbff) as we don't know how to handle them.
High and low surrogates are correctly dealt with - that is if a
high surrogate is randomly chosen, 55296 (d800) to 56191 (db7f)
then it is followed by a low surrogate. If a low surrogate is chosen,
56320 (dc00) to 57343 (dfff) then it is placed after a randomly
chosen high surrogate.
author:
Steven Caswell
author:
Stephen Colebourne
author:
Gary Gregory
author:
Phil Steitz
since:
1.0
version:
$Id: RandomStringUtils.java 471626 2006-11-06 04:02:09Z bayard $ |
| Constructor Summary | |
| public | RandomStringUtils()
RandomStringUtils instances should NOT be constructed in
standard programming.
|
| Method Summary | |
| public static String | random(int count)
| | public static String | random(int count, boolean letters, boolean numbers)
| | public static String | random(int count, int start, int end, boolean letters, boolean numbers)
| | public static String | random(int count, int start, int end, boolean letters, boolean numbers, char[] chars)
Creates a random string based on a variety of options, using
default source of randomness.
This method has exactly the same semantics as
RandomStringUtils.random(int,int,int,boolean,boolean,char[],Random) , but
instead of using an externally supplied source of randomness, it uses
the internal static
Random instance.
Parameters:
count - the length of random string to create
Parameters:
start - the position in set of chars to start at
Parameters:
end - the position in set of chars to end before
Parameters:
letters - only allow letters?
Parameters:
numbers - only allow numbers?
Parameters:
chars - the set of chars to choose randoms from.If null, then it will use the set of all chars. | | public static String | random(int count, int start, int end, boolean letters, boolean numbers, char[] chars, Random random)
Creates a random string based on a variety of options, using
supplied source of randomness.
If start and end are both 0, start and end are set
to ' ' and 'z', the ASCII printable
characters, will be used, unless letters and numbers are both
false, in which case, start and end are set to
0 and Integer.MAX_VALUE.
If set is not null, characters between start and
end are chosen.
This method accepts a user-supplied
Random instance to use as a source of randomness. | | public static String | random(int count, String chars)
| | public static String | random(int count, char[] chars)
| | public static String | randomAlphabetic(int count)
| | public static String | randomAlphanumeric(int count)
| | public static String | randomAscii(int count)
| | public static String | randomNumeric(int count)
|
| RandomStringUtils | | public RandomStringUtils()(Code) | | RandomStringUtils instances should NOT be constructed in
standard programming. Instead, the class should be used as
RandomStringUtils.random(5);.
This constructor is public to permit tools that require a JavaBean instance
to operate.
|
| random | | public static String random(int count)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of all characters.
Parameters:
count - the length of random string to create the random string |
| random | | public static String random(int count, boolean letters, boolean numbers)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of alpha-numeric
characters as indicated by the arguments.
Parameters:
count - the length of random string to create
Parameters:
letters - if true, generated string will includealphabetic characters
Parameters:
numbers - if true, generated string will includenumeric characters the random string |
| random | | public static String random(int count, int start, int end, boolean letters, boolean numbers)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of alpha-numeric
characters as indicated by the arguments.
Parameters:
count - the length of random string to create
Parameters:
start - the position in set of chars to start at
Parameters:
end - the position in set of chars to end before
Parameters:
letters - if true, generated string will includealphabetic characters
Parameters:
numbers - if true, generated string will includenumeric characters the random string |
| random | | public static String random(int count, int start, int end, boolean letters, boolean numbers, char[] chars)(Code) | | Creates a random string based on a variety of options, using
default source of randomness.
This method has exactly the same semantics as
RandomStringUtils.random(int,int,int,boolean,boolean,char[],Random) , but
instead of using an externally supplied source of randomness, it uses
the internal static
Random instance.
Parameters:
count - the length of random string to create
Parameters:
start - the position in set of chars to start at
Parameters:
end - the position in set of chars to end before
Parameters:
letters - only allow letters?
Parameters:
numbers - only allow numbers?
Parameters:
chars - the set of chars to choose randoms from.If null, then it will use the set of all chars. the random string
throws:
ArrayIndexOutOfBoundsException - if there are not(end - start) + 1 characters in the set array. |
| random | | public static String random(int count, int start, int end, boolean letters, boolean numbers, char[] chars, Random random)(Code) | | Creates a random string based on a variety of options, using
supplied source of randomness.
If start and end are both 0, start and end are set
to ' ' and 'z', the ASCII printable
characters, will be used, unless letters and numbers are both
false, in which case, start and end are set to
0 and Integer.MAX_VALUE.
If set is not null, characters between start and
end are chosen.
This method accepts a user-supplied
Random instance to use as a source of randomness. By seeding a single
Random instance with a fixed seed and using it for each call,
the same random sequence of strings can be generated repeatedly
and predictably.
Parameters:
count - the length of random string to create
Parameters:
start - the position in set of chars to start at
Parameters:
end - the position in set of chars to end before
Parameters:
letters - only allow letters?
Parameters:
numbers - only allow numbers?
Parameters:
chars - the set of chars to choose randoms from.If null, then it will use the set of all chars.
Parameters:
random - a source of randomness. the random string
throws:
ArrayIndexOutOfBoundsException - if there are not(end - start) + 1 characters in the set array.
throws:
IllegalArgumentException - if count < 0.
since:
2.0 |
| random | | public static String random(int count, String chars)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of characters
specified.
Parameters:
count - the length of random string to create
Parameters:
chars - the String containing the set of characters to use,may be null the random string
throws:
IllegalArgumentException - if count < 0. |
| random | | public static String random(int count, char[] chars)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of characters specified.
Parameters:
count - the length of random string to create
Parameters:
chars - the character array containing the set of characters to use,may be null the random string
throws:
IllegalArgumentException - if count < 0. |
| randomAlphabetic | | public static String randomAlphabetic(int count)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of alphabetic
characters.
Parameters:
count - the length of random string to create the random string |
| randomAlphanumeric | | public static String randomAlphanumeric(int count)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of alpha-numeric
characters.
Parameters:
count - the length of random string to create the random string |
| randomAscii | | public static String randomAscii(int count)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of characters whose
ASCII value is between 32 and 126 (inclusive).
Parameters:
count - the length of random string to create the random string |
| randomNumeric | | public static String randomNumeric(int count)(Code) | | Creates a random string whose length is the number of characters
specified.
Characters will be chosen from the set of numeric
characters.
Parameters:
count - the length of random string to create the random string |
|
|