org.apache.commons.lang.RandomStringUtils


Operations for random Strings.

Constructor Detail

 public RandomStringUtils() 

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.

Method Detail

 public static java.lang.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.

Parameters: countthe length of random string to create

Returns: the random string

 public static java.lang.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).

Parameters: countthe length of random string to create

Returns: the random string

 public static java.lang.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.

Parameters: countthe length of random string to create

Returns: the random string

 public static java.lang.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.

Parameters: countthe length of random string to create

Returns: the random string

 public static java.lang.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.

Parameters: countthe length of random string to create

Returns: the random string

 public static java.lang.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.

Parameters: countthe length of random string to create

lettersif true, generated string will include alphabetic characters

numbersif true, generatd string will include numeric characters

Returns: the random string

[View full width]

public static java.lang.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.

Parameters: countthe length of random string to create

startthe position in set of chars to start at

endthe position in set of chars to end before

lettersif TRue, generated string will include alphabetic characters

numbersif true, generated string will include numeric characters

Returns: the random string

[View full width]

public static java.lang.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.

Parameters: countthe length of random string to create

startthe position in set of chars to start at

endthe position in set of chars to end before

lettersonly allow letters?

numbersonly allow numbers?

charsthe set of chars to choose randoms from. If null, then it will use the set of all chars.

Returns: the random string

Throws: java.lang.ArrayIndexOutOfBoundsExceptionif there are not (end-start) + 1 characters in the set array.

 public static java.lang.String random(int count, int start, int end, boolean letters, boolean numbers, char[] chars, java.util.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.

Parameters: countthe length of random string to create

startthe position in set of chars to start at

endthe position in set of chars to end before

lettersonly allow letters?

numbersonly allow numbers?

charsthe set of chars to choose randoms from. If null, then it will use the set of all chars.

randoma source of randomness

Returns: the random string

Throws: java.lang.ArrayIndexOutOfBoundsExceptionif there are not (endstart) + 1 characters in the set array.

java.lang.IllegalArgumentExceptionif count < 0.

 public static java.lang.String random(int count, java.lang.String chars) 

Creates a random string whose length is the number of characters specified. Characters will be chosen from the set of characters specified.

Parameters: countthe length of random string to create

charsthe String containing the set of characters to use, may be null

Returns: the random string

Throws: java.lang.IllegalArgumentExceptionif count < 0.

 public static java.lang.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.

Parameters: countthe length of random string to create

charsthe character array containing the set of characters to use, may be null

Returns: the random string

Throws: java.lang.IllegalArgumentExceptionif count < 0.



    Apache Jakarta Commons(c) Reusable Java Components
    Real World Web Services
    ISBN: N/A
    EAN: 2147483647
    Year: 2006
    Pages: 137
    Authors: Will Iverson

    flylib.com © 2008-2017.
    If you may any questions please contact us: flylib@qtcs.net