Interface RandomData

    • Method Summary

      All Methods Instance Methods Abstract Methods Deprecated Methods 
      Modifier and Type Method Description
      double nextExponential​(double mean)
      Deprecated.
      Generates a random value from the exponential distribution with specified mean.
      double nextGaussian​(double mu, double sigma)
      Deprecated.
      Generates a random value from the Normal (or Gaussian) distribution with specified mean and standard deviation.
      String nextHexString​(int len)
      Deprecated.
      Generates a random string of hex characters of length len.
      int nextInt​(int lower, int upper)
      Deprecated.
      Generates a uniformly distributed random integer between lower and upper (endpoints included).
      long nextLong​(long lower, long upper)
      Deprecated.
      Generates a uniformly distributed random long integer between lower and upper (endpoints included).
      int[] nextPermutation​(int n, int k)
      Deprecated.
      Generates an integer array of length k whose entries are selected randomly, without repetition, from the integers 0, ..., n - 1 (inclusive).
      long nextPoisson​(double mean)
      Deprecated.
      Generates a random value from the Poisson distribution with the given mean.
      Object[] nextSample​(Collection<?> c, int k)
      Deprecated.
      Returns an array of k objects selected randomly from the Collection c.
      String nextSecureHexString​(int len)
      Deprecated.
      Generates a random string of hex characters from a secure random sequence.
      int nextSecureInt​(int lower, int upper)
      Deprecated.
      Generates a uniformly distributed random integer between lower and upper (endpoints included) from a secure random sequence.
      long nextSecureLong​(long lower, long upper)
      Deprecated.
      Generates a uniformly distributed random long integer between lower and upper (endpoints included) from a secure random sequence.
      double nextUniform​(double lower, double upper)
      Deprecated.
      Generates a uniformly distributed random value from the open interval (lower, upper) (i.e., endpoints excluded).
      double nextUniform​(double lower, double upper, boolean lowerInclusive)
      Deprecated.
      Generates a uniformly distributed random value from the interval (lower, upper) or the interval [lower, upper).
    • Method Detail

      • nextHexString

        String nextHexString​(int len)
                      throws NotStrictlyPositiveException
        Deprecated.
        Generates a random string of hex characters of length len.

        The generated string will be random, but not cryptographically secure. To generate cryptographically secure strings, use nextSecureHexString(int).

        Parameters:
        len - the length of the string to be generated
        Returns:
        a random string of hex characters of length len
        Throws:
        NotStrictlyPositiveException - if len <= 0
      • nextInt

        int nextInt​(int lower,
                    int upper)
             throws NumberIsTooLargeException
        Deprecated.
        Generates a uniformly distributed random integer between lower and upper (endpoints included).

        The generated integer will be random, but not cryptographically secure. To generate cryptographically secure integer sequences, use nextSecureInt(int, int).

        Parameters:
        lower - lower bound for generated integer
        upper - upper bound for generated integer
        Returns:
        a random integer greater than or equal to lower and less than or equal to upper
        Throws:
        NumberIsTooLargeException - if lower >= upper
      • nextLong

        long nextLong​(long lower,
                      long upper)
               throws NumberIsTooLargeException
        Deprecated.
        Generates a uniformly distributed random long integer between lower and upper (endpoints included).

        The generated long integer values will be random, but not cryptographically secure. To generate cryptographically secure sequences of longs, use nextSecureLong(long, long).

        Parameters:
        lower - lower bound for generated long integer
        upper - upper bound for generated long integer
        Returns:
        a random long integer greater than or equal to lower and less than or equal to upper
        Throws:
        NumberIsTooLargeException - if lower >= upper
      • nextSecureHexString

        String nextSecureHexString​(int len)
                            throws NotStrictlyPositiveException
        Deprecated.
        Generates a random string of hex characters from a secure random sequence.

        If cryptographic security is not required, use nextHexString(int).

        Parameters:
        len - the length of the string to be generated
        Returns:
        a random string of hex characters of length len
        Throws:
        NotStrictlyPositiveException - if len <= 0
      • nextSecureInt

        int nextSecureInt​(int lower,
                          int upper)
                   throws NumberIsTooLargeException
        Deprecated.
        Generates a uniformly distributed random integer between lower and upper (endpoints included) from a secure random sequence.

        Sequences of integers generated using this method will be cryptographically secure. If cryptographic security is not required, nextInt(int, int) should be used instead of this method.

        Definition: Secure Random Sequence

        Parameters:
        lower - lower bound for generated integer
        upper - upper bound for generated integer
        Returns:
        a random integer greater than or equal to lower and less than or equal to upper.
        Throws:
        NumberIsTooLargeException - if lower >= upper.
      • nextSecureLong

        long nextSecureLong​(long lower,
                            long upper)
                     throws NumberIsTooLargeException
        Deprecated.
        Generates a uniformly distributed random long integer between lower and upper (endpoints included) from a secure random sequence.

        Sequences of long values generated using this method will be cryptographically secure. If cryptographic security is not required, nextLong(long, long) should be used instead of this method.

        Definition: Secure Random Sequence

        Parameters:
        lower - lower bound for generated integer
        upper - upper bound for generated integer
        Returns:
        a random long integer greater than or equal to lower and less than or equal to upper.
        Throws:
        NumberIsTooLargeException - if lower >= upper.
      • nextGaussian

        double nextGaussian​(double mu,
                            double sigma)
                     throws NotStrictlyPositiveException
        Deprecated.
        Generates a random value from the Normal (or Gaussian) distribution with specified mean and standard deviation.

        Definition: Normal Distribution

        Parameters:
        mu - the mean of the distribution
        sigma - the standard deviation of the distribution
        Returns:
        a random value following the specified Gaussian distribution
        Throws:
        NotStrictlyPositiveException - if sigma <= 0.
      • nextUniform

        double nextUniform​(double lower,
                           double upper,
                           boolean lowerInclusive)
                    throws NumberIsTooLargeException,
                           NotFiniteNumberException,
                           NotANumberException
        Deprecated.
        Generates a uniformly distributed random value from the interval (lower, upper) or the interval [lower, upper). The lower bound is thus optionally included, while the upper bound is always excluded.

        Definition: Uniform Distribution lower and upper - lower are the location and scale parameters, respectively.

        Parameters:
        lower - the lower bound of the support
        upper - the exclusive upper bound of the support
        lowerInclusive - true if the lower bound is inclusive
        Returns:
        uniformly distributed random value in the (lower, upper) interval, if lowerInclusive is false, or in the [lower, upper) interval, if lowerInclusive is true
        Throws:
        NumberIsTooLargeException - if lower >= upper
        NotFiniteNumberException - if one of the bounds is infinite
        NotANumberException - if one of the bounds is NaN
      • nextPermutation

        int[] nextPermutation​(int n,
                              int k)
                       throws NumberIsTooLargeException,
                              NotStrictlyPositiveException
        Deprecated.
        Generates an integer array of length k whose entries are selected randomly, without repetition, from the integers 0, ..., n - 1 (inclusive).

        Generated arrays represent permutations of n taken k at a time.

        Parameters:
        n - the domain of the permutation
        k - the size of the permutation
        Returns:
        a random k-permutation of n, as an array of integers
        Throws:
        NumberIsTooLargeException - if k > n.
        NotStrictlyPositiveException - if k <= 0.