eu.ciechanowiec.sling.rocket.unit.DataSize Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of sling.rocket.commons Show documentation
Common utilities used by Sling Rocket
There is a newer version: 13.32.0
package eu.ciechanowiec.sling.rocket.unit;

import eu.ciechanowiec.conditional.Conditional;
import lombok.extern.slf4j.Slf4j;

import java.io.File;
import java.util.Objects;
import java.util.concurrent.CompletableFuture;
import java.util.function.Supplier;

/**
 * Size of digital information.
 *
 * 
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 *   
 *     
 *     
 *     
 *     
 *   
 * Data Unit SizesConstant Data size Power of 2 Size in Bytes
{@link DataUnit#BYTES} 1B 2^0 1
{@link DataUnit#KILOBYTES} 1KB 2^10 1,024
{@link DataUnit#MEGABYTES} 1MB 2^20 1,048,576
{@link DataUnit#GIGABYTES} 1GB 2^30 1,073,741,824
{@link DataUnit#TERABYTES} 1TB 2^40 1,099,511,627,776
 */
@SuppressWarnings({"AccessingNonPublicFieldOfAnotherObject", "WeakerAccess"})
@Slf4j
public final class DataSize implements Comparable {

    private final CompletableFuture bytesFuture;

    private DataSize(long bytes) {
        this.bytesFuture = CompletableFuture.supplyAsync(() -> bytes);
    }

    /**
     * Constructs an instance of this class.
     * @param amount amount of the size of digital information represented by this {@link DataSize},
     *               measured in the specified {@link DataUnit}
     * @param dataUnit unit of digital information that the specified amount is measured in
     */
    public DataSize(long amount, DataUnit dataUnit) {
        this(dataUnit.toBytes(amount));
    }

    /**
     * Constructs an instance of this class.
     * @param file {@link File} whose size is represented by this {@link DataSize}
     */
    public DataSize(File file) {
        this(() -> file);
    }

    /**
     * Constructs an instance of this class.
     * @param fileSupplier {@link Supplier} with a {@link File} whose size is represented by this {@link DataSize}
     */
    public DataSize(Supplier fileSupplier) {
        this.bytesFuture = CompletableFuture.supplyAsync(() -> fileSupplier.get().length());
        Conditional.onFalseExecute(
                fileSupplier.get().exists(), () -> log.warn("This file doesn't exist: '{}'", fileSupplier)
        );
    }

    /**
     * Number of {@link DataUnit#BYTES} in this {@link DataSize}.
     * @return the number of bytes
     */
    public long bytes() {
        return bytesFuture.join();
    }

    /**
     * Number of {@link DataUnit#KILOBYTES} in this {@link DataSize}.
     * @return number of {@link DataUnit#KILOBYTES} in this {@link DataSize}
     */
    public double kilobytes() {
        return (double) bytesFuture.join() / DataUnitMultiplications.BYTES_PER_KB;
    }

    /**
     * Number of {@link DataUnit#MEGABYTES} in this {@link DataSize}.
     * @return the number of bytes
     */
    public double megabytes() {
        return (double) bytesFuture.join() / DataUnitMultiplications.BYTES_PER_MB;
    }

    /**
     * Number of {@link DataUnit#GIGABYTES} in this {@link DataSize}.
     * @return the number of bytes
     */
    public double gigabytes() {
        return (double) bytesFuture.join() / DataUnitMultiplications.BYTES_PER_GB;
    }

    /**
     * Number of {@link DataUnit#TERABYTES} in this {@link DataSize}.
     * @return the number of bytes
     */
    public double terabytes() {
        return (double) bytesFuture.join() / DataUnitMultiplications.BYTES_PER_TB;
    }

    /**
     * Checks if this {@link DataSize} is bigger than the compared {@link DataSize}.
     * @param comparedDataSize {@link DataSize} to which this {@link DataSize} is compared to
     * @return {@code true} if this {@link DataSize} is bigger than the compared {@link DataSize};
     *         {@code false} otherwise
     */
    public boolean biggerThan(DataSize comparedDataSize) {
        return bytesFuture.join() > comparedDataSize.bytesFuture.join();
    }

    /**
     * Checks if this {@link DataSize} is smaller than the compared {@link DataSize}.
     * @param comparedDataSize {@link DataSize} to which this {@link DataSize} is compared to
     * @return {@code true} if this {@link DataSize} is smaller than the compared {@link DataSize};
     *         {@code false} otherwise
     */
    public boolean smallerThan(DataSize comparedDataSize) {
        return bytesFuture.join() < comparedDataSize.bytesFuture.join();
    }

    @Override
    public int compareTo(DataSize comparedDataSize) {
        return Long.compare(bytesFuture.join(), comparedDataSize.bytesFuture.join());
    }

    /**
     * Adds the specified {@link DataSize} to this {@link DataSize}.
     * The sum result is returned and this {@link DataSize} remains unchanged.
     * @param dataSizeToAdd {@link DataSize} to add to this {@link DataSize}
     * @return new {@link DataSize} that is the sum of this {@link DataSize} and the passed {@link DataSize}
     */
    public DataSize add(DataSize dataSizeToAdd) {
        long thisBytes = this.bytes();
        long bytesToAdd = dataSizeToAdd.bytes();
        return new DataSize(thisBytes + bytesToAdd);
    }

    @Override
    public boolean equals(Object comparedObject) {
        if (this == comparedObject) {
            return true;
        }
        if (Objects.isNull(comparedObject) || getClass() != comparedObject.getClass()) {
            return false;
        }
        DataSize comparedDataSize = (DataSize) comparedObject;
        return Objects.equals(bytesFuture.join(), comparedDataSize.bytesFuture.join());
    }

    @Override
    public int hashCode() {
        return Long.hashCode(bytesFuture.join());
    }

    /**
     * Returns a human-readable representation of this {@link DataSize}.
     * @return human-readable representation of this {@link DataSize}
     */
    @SuppressWarnings("VariableDeclarationUsageDistance")
    public String toHumanReadableRepresentation() {
        long remainingBytes = bytesFuture.join();

        long hrTerabytes = remainingBytes / DataUnitMultiplications.BYTES_PER_TB;
        remainingBytes %= DataUnitMultiplications.BYTES_PER_TB;

        long hrGigabytes = remainingBytes / DataUnitMultiplications.BYTES_PER_GB;
        remainingBytes %= DataUnitMultiplications.BYTES_PER_GB;

        long hrMegabytes = remainingBytes / DataUnitMultiplications.BYTES_PER_MB;
        remainingBytes %= DataUnitMultiplications.BYTES_PER_MB;

        long hrKilobytes = remainingBytes / DataUnitMultiplications.BYTES_PER_KB;
        remainingBytes %= DataUnitMultiplications.BYTES_PER_KB;

        long hrBytes = remainingBytes;

        return String.format(
                "[%d TB, %d GB, %d MB, %d KB, %d B]", hrTerabytes, hrGigabytes, hrMegabytes, hrKilobytes, hrBytes
        );
    }

    @Override
    public String toString() {
        return String.format("DataSize{%s}", toHumanReadableRepresentation());
    }
}
Constant	Data size	Power of 2	Size in Bytes
{@link DataUnit#BYTES}	1B	2^0	1
{@link DataUnit#KILOBYTES}	1KB	2^10	1,024
{@link DataUnit#MEGABYTES}	1MB	2^20	1,048,576
{@link DataUnit#GIGABYTES}	1GB	2^30	1,073,741,824
{@link DataUnit#TERABYTES}	1TB	2^40	1,099,511,627,776