Package org.apache.commons.lang3
Class RandomUtils
java.lang.Object
org.apache.commons.lang3.RandomUtils
Deprecated.
Use Apache Commons RNG's optimized UniformRandomProvider
Utility library that supplements the standard
Random
class.
Caveat: Instances of Random
are not cryptographically secure.
Please note that the Apache Commons project provides a component dedicated to pseudo-random number generation, namely Commons RNG, that may be a better choice for applications with more stringent requirements (performance and/or correctness).
- Since:
- 3.3
-
Constructor Summary
ConstructorsConstructorDescriptionDeprecated.RandomUtils
instances should NOT be constructed in standard programming. -
Method Summary
Modifier and TypeMethodDescriptionstatic boolean
Deprecated.Generates a random boolean value.static byte[]
nextBytes
(int count) Deprecated.Generates an array of random bytes.static double
Deprecated.Generates a random double within 0 - Double.MAX_VALUE.static double
nextDouble
(double startInclusive, double endExclusive) Deprecated.Generates a random double within the specified range.static float
Deprecated.Generates a random float within 0 - Float.MAX_VALUE.static float
nextFloat
(float startInclusive, float endExclusive) Deprecated.Generates a random float within the specified range.static int
nextInt()
Deprecated.Generates a random int within 0 - Integer.MAX_VALUE.static int
nextInt
(int startInclusive, int endExclusive) Deprecated.Generates a random integer within the specified range.static long
nextLong()
Deprecated.Generates a random long within 0 - Long.MAX_VALUE.private static long
nextLong
(long n) Deprecated.Generates along
value between 0 (inclusive) and the specified value (exclusive).static long
nextLong
(long startInclusive, long endExclusive) Deprecated.Generates a random long within the specified range.private static ThreadLocalRandom
random()
Deprecated.
-
Constructor Details
-
RandomUtils
public RandomUtils()Deprecated.RandomUtils
instances should NOT be constructed in standard programming. Instead, the class should be used asRandomUtils.nextBytes(5);
.This constructor is public to permit tools that require a JavaBean instance to operate.
-
-
Method Details
-
nextBoolean
public static boolean nextBoolean()Deprecated.Generates a random boolean value.- Returns:
- the random boolean
- Since:
- 3.5
-
nextBytes
public static byte[] nextBytes(int count) Deprecated.Generates an array of random bytes.- Parameters:
count
- the size of the returned array- Returns:
- the random byte array
- Throws:
IllegalArgumentException
- ifcount
is negative
-
nextDouble
public static double nextDouble()Deprecated.Generates a random double within 0 - Double.MAX_VALUE.- Returns:
- the random double
- Since:
- 3.5
- See Also:
-
nextDouble
public static double nextDouble(double startInclusive, double endExclusive) Deprecated.Generates a random double within the specified range.- Parameters:
startInclusive
- the smallest value that can be returned, must be non-negativeendExclusive
- the upper bound (not included)- Returns:
- the random double
- Throws:
IllegalArgumentException
- ifstartInclusive > endExclusive
or ifstartInclusive
is negative
-
nextFloat
public static float nextFloat()Deprecated.Generates a random float within 0 - Float.MAX_VALUE.- Returns:
- the random float
- Since:
- 3.5
- See Also:
-
nextFloat
public static float nextFloat(float startInclusive, float endExclusive) Deprecated.Generates a random float within the specified range.- Parameters:
startInclusive
- the smallest value that can be returned, must be non-negativeendExclusive
- the upper bound (not included)- Returns:
- the random float
- Throws:
IllegalArgumentException
- ifstartInclusive > endExclusive
or ifstartInclusive
is negative
-
nextInt
public static int nextInt()Deprecated.Generates a random int within 0 - Integer.MAX_VALUE.- Returns:
- the random integer
- Since:
- 3.5
- See Also:
-
nextInt
public static int nextInt(int startInclusive, int endExclusive) Deprecated.Generates a random integer within the specified range.- Parameters:
startInclusive
- the smallest value that can be returned, must be non-negativeendExclusive
- the upper bound (not included)- Returns:
- the random integer
- Throws:
IllegalArgumentException
- ifstartInclusive > endExclusive
or ifstartInclusive
is negative
-
nextLong
public static long nextLong()Deprecated.Generates a random long within 0 - Long.MAX_VALUE.- Returns:
- the random long
- Since:
- 3.5
- See Also:
-
nextLong
private static long nextLong(long n) Deprecated.Generates along
value between 0 (inclusive) and the specified value (exclusive).- Parameters:
n
- Bound on the random number to be returned. Must be positive.- Returns:
- a random
long
value between 0 (inclusive) andn
(exclusive).
-
nextLong
public static long nextLong(long startInclusive, long endExclusive) Deprecated.Generates a random long within the specified range.- Parameters:
startInclusive
- the smallest value that can be returned, must be non-negativeendExclusive
- the upper bound (not included)- Returns:
- the random long
- Throws:
IllegalArgumentException
- ifstartInclusive > endExclusive
or ifstartInclusive
is negative
-
random
Deprecated.
-