Save This Page
Home » commons-lang-2.4-src » org.apache.commons » lang » [javadoc | source]
org.apache.commons.lang
public class: RandomStringUtils [javadoc | source]
java.lang.Object
   org.apache.commons.lang.RandomStringUtils

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.

Constructor:
 public RandomStringUtils() 
Method from org.apache.commons.lang.RandomStringUtils Summary:
random,   random,   random,   random,   random,   random,   random,   randomAlphabetic,   randomAlphanumeric,   randomAscii,   randomNumeric
Methods from java.lang.Object:
equals,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from org.apache.commons.lang.RandomStringUtils Detail:
 public static String random(int count) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of all characters.

 public static String random(int count,
    String chars) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of characters specified.

 public static String random(int count,
    char[] chars) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of characters specified.

 public static String random(int count,
    boolean letters,
    boolean numbers) 

    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.

 public static String random(int count,
    int start,
    int end,
    boolean letters,
    boolean numbers) 

    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.

 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 #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.

 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. 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.

 public static String randomAlphabetic(int count) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of alphabetic characters.

 public static String randomAlphanumeric(int count) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of alpha-numeric characters.

 public static String randomAscii(int count) 

    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).

 public static String randomNumeric(int count) 

    Creates a random string whose length is the number of characters specified.

    Characters will be chosen from the set of numeric characters.