src/main/java/io/reactivex/rxjava4/schedulers/Timed.java - 4.x - githubmirror/RxJava

src/main/java/io/reactivex/rxjava4/schedulers/Timed.java

58 строк2 KB

David Karnok

4.x: Cleanup, wording minor things (#8186)

26 июн 2026, 17:38

26 июн 2026, 17:38557a600

/*
 * Copyright (c) 2016-present, RxJava Contributors.
 *
 * 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.
 */

package io.reactivex.rxjava4.schedulers;

import java.util.Objects;
import java.util.concurrent.TimeUnit;

import io.reactivex.rxjava4.annotations.NonNull;

/**
 * Holds onto a value along with time information.
 *
 * @param <T> the value type
 * @param value the item to store
 * @param time the time value
 * @param unit the unit of time
 * @since 4.0.0
 */
public record Timed<T>(T value, long time, TimeUnit unit) {
    /**
     * Constructs a {@code Timed} instance with the given value and time information.
     *
     * @param value the value to hold
     * @param time  the time to hold
     * @param unit  the time unit, not null
     * @throws NullPointerException if {@code value} or {@code unit} is {@code null}
     */
    public Timed {
        Objects.requireNonNull(value, "value is null");
        Objects.requireNonNull(unit, "unit is null");
    }

    /**
     * Returns the contained time value in the time unit specified.
     *
     * @param unit the time unit
     * @return the converted time
     */
    public long time(@NonNull TimeUnit unit) {
        return unit.convert(time, this.unit);
    }

    @Override
    public String toString() {
        return "Timed[time=" + time + ", unit=" + unit + ", value=" + value + "]";
    }
}