/*
 * Java Genetic Algorithm Library (jenetics-8.3.0).
 * Copyright (c) 2007-2025 Franz Wilhelmstötter
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 *
 * Author:
 *    Franz Wilhelmstötter (franz.wilhelmstoetter@gmail.com)
 */
package io.jenetics.util;

import static java.util.Objects.requireNonNull;

import java.io.Serial;
import java.util.Random;
import java.util.random.RandomGenerator;
import java.util.stream.DoubleStream;
import java.util.stream.IntStream;
import java.util.stream.LongStream;

/**
 * Some places in the Java API still require a {@link Random} object instead of
 * the new {@link RandomGenerator}. This class can be used by using this adapter
 * class.
 * {@snippet lang="java":
 * final var random = RandomGenerator.getDefault();
 * final var bi = new BigInteger(100, RandomAdapter.of(random));
 * }
 *
 * @deprecated Will be removed in the next major version. Use the
 *            {@link Random#from(RandomGenerator)} method instead.
 *
 * @author <a href="mailto:franz.wilhelmstoetter@gmail.com">Franz Wilhelmstötter</a>
 * @since 7.0
 * @version 7.0
 */
@Deprecated(since = "8.3", forRemoval = true)
public final class RandomAdapter extends Random {

        @Serial
        private static final long serialVersionUID = 1;

        private final RandomGenerator _random;

        private RandomAdapter(final RandomGenerator random) {
                _random = requireNonNull(random);
        }

        @Override
        public boolean isDeprecated() {
                return _random.isDeprecated();
        }

        @Override
        public DoubleStream doubles() {
                return _random.doubles();
        }

        @Override
        public DoubleStream doubles(double randomNumberOrigin, double randomNumberBound) {
                return _random.doubles(randomNumberOrigin, randomNumberBound);
        }

        @Override
        public DoubleStream doubles(long streamSize) {
                return _random.doubles(streamSize);
        }

        @Override
        public DoubleStream doubles(long streamSize, double randomNumberOrigin, double randomNumberBound) {
                return _random.doubles(streamSize, randomNumberOrigin, randomNumberBound);
        }

        @Override
        public IntStream ints() {
                return _random.ints();
        }

        @Override
        public IntStream ints(int randomNumberOrigin, int randomNumberBound) {
                return _random.ints(randomNumberOrigin, randomNumberBound);
        }

        @Override
        public IntStream ints(long streamSize) {
                return _random.ints(streamSize);
        }

        @Override
        public IntStream ints(long streamSize, int randomNumberOrigin, int randomNumberBound) {
                return _random.ints(streamSize, randomNumberOrigin, randomNumberBound);
        }

        @Override
        public LongStream longs() {
                return _random.longs();
        }

        @Override
        public LongStream longs(long randomNumberOrigin, long randomNumberBound) {
                return _random.longs(randomNumberOrigin, randomNumberBound);
        }

        @Override
        public LongStream longs(long streamSize) {
                return _random.longs(streamSize);
        }

        @Override
        public LongStream longs(long streamSize, long randomNumberOrigin, long randomNumberBound) {
                return _random.longs(streamSize, randomNumberOrigin, randomNumberBound);
        }

        @Override
        public boolean nextBoolean() {
                return _random.nextBoolean();
        }

        @Override
        public void nextBytes(byte[] bytes) {
                _random.nextBytes(bytes);
        }

        @Override
        public float nextFloat() {
                return _random.nextFloat();
        }

        @Override
        public float nextFloat(float bound) {
                return _random.nextFloat(bound);
        }

        @Override
        public float nextFloat(float origin, float bound) {
                return _random.nextFloat(origin, bound);
        }

        @Override
        public double nextDouble() {
                return _random.nextDouble();
        }

        @Override
        public double nextDouble(double bound) {
                return _random.nextDouble(bound);
        }

        @Override
        public double nextDouble(double origin, double bound) {
                return _random.nextDouble(origin, bound);
        }

        @Override
        public int nextInt() {
                return _random.nextInt();
        }

        @Override
        public int nextInt(int bound) {
                return _random.nextInt(bound);
        }

        @Override
        public int nextInt(int origin, int bound) {
                return _random.nextInt(origin, bound);
        }

        @Override
        public long nextLong() {
                return _random.nextLong();
        }

        @Override
        public long nextLong(long bound) {
                return _random.nextLong(bound);
        }

        @Override
        public long nextLong(long origin, long bound) {
                return _random.nextLong(origin, bound);
        }

        @Override
        public double nextGaussian() {
                return _random.nextGaussian();
        }

        @Override
        public double nextGaussian(double mean, double stddev) {
                return _random.nextGaussian(mean, stddev);
        }

        @Override
        public double nextExponential() {
                return _random.nextExponential();
        }

        /**
         * Create a new {@link Random} object from the given {@code random} generator.
         *
         * @param random the random generator to adapt
         * @return the adapted random generator
         */
        public static Random of(final RandomGenerator random) {
                return new RandomAdapter(random);
        }
}