src/main/java/de/xn__ho_hia/utils/storage_unit/Gigabyte.java

   1 /*
   2  * This file is part of storage-units. It is subject to the license terms in the LICENSE file found in the top-level
   3  * directory of this distribution and at http://creativecommons.org/publicdomain/zero/1.0/. No part of storage-units,
   4  * including this file, may be copied, modified, propagated, or distributed except according to the terms contained
   5  * in the LICENSE file.
   6  */
   7 package de.xn__ho_hia.utils.storage_unit;
   8
   9 import static de.xn__ho_hia.quality.null_analysis.Nullsafe.addNullsafe;
  10 import static de.xn__ho_hia.quality.null_analysis.Nullsafe.asBigInteger;
  11 import static de.xn__ho_hia.quality.null_analysis.Nullsafe.divideNullsafe;
  12 import static de.xn__ho_hia.quality.null_analysis.Nullsafe.multiplyNullsafe;
  13 import static de.xn__ho_hia.quality.null_analysis.Nullsafe.subtractNullsafe;
  14
  15 import java.math.BigInteger;
  16 import java.util.function.Function;
  17
  18 import org.eclipse.jdt.annotation.NonNull;
  19
  20 /**
  21  * Gigabyte as specified in ISO IEC 80000-13:2008 (1 Gigabyte = 1 000 000 000 Byte).
  22  */
  23 public class Gigabyte extends StorageUnit<Gigabyte> {
  24
  25     private static final long serialVersionUID = 7581075190529125530L;
  26
  27     Gigabyte(@NonNull final BigInteger bytes) {
  28         super(bytes);
  29     }
  30
  31     /**
  32      * @param numberOfBytes
  33      *            The amount of bytes the Gigabyte contains.
  34      * @return A new Gigabyte unit with the given value.
  35      */
  36     @NonNull
  37     public static Gigabyte valueOf(@NonNull final BigInteger numberOfBytes) {
  38         return new Gigabyte(numberOfBytes);
  39     }
  40
  41     /**
  42      * @param numberOfBytes
  43      *            The amount of bytes the Gigabyte contains.
  44      * @return A new Gigabyte unit with the given value.
  45      */
  46     @NonNull
  47     public static Gigabyte valueOf(final long numberOfBytes) {
  48         return new Gigabyte(asBigInteger(numberOfBytes));
  49     }
  50
  51     /**
  52      * @param numberOfBytes
  53      *            The amount of bytes the Gigabyte contains.
  54      * @return A new Gigabyte unit with the given value.
  55      */
  56     @NonNull
  57     public static Gigabyte valueOf(@NonNull final Long numberOfBytes) {
  58         return valueOf(numberOfBytes.longValue());
  59     }
  60
  61     @Override
  62     public Gigabyte add(final long bytesToAdd) {
  63         return new Gigabyte(addNullsafe(bytes, asBigInteger(bytesToAdd)));
  64     }
  65
  66     @Override
  67     public Gigabyte add(final StorageUnit<?> storageAmount) {
  68         return new Gigabyte(addNullsafe(bytes, storageAmount.bytes));
  69     }
  70
  71     @Override
  72     public Gigabyte divide(final long divisor) {
  73         return new Gigabyte(divideNullsafe(bytes, asBigInteger(divisor)));
  74     }
  75
  76     @Override
  77     public Gigabyte multiply(final long factor) {
  78         return new Gigabyte(multiplyNullsafe(bytes, asBigInteger(factor)));
  79     }
  80
  81     @Override
  82     public Gigabyte subtract(final long bytesToSubtract) {
  83         return new Gigabyte(subtractNullsafe(bytes, asBigInteger(bytesToSubtract)));
  84     }
  85
  86     @Override
  87     public Gigabyte subtract(final StorageUnit<?> storageAmount) {
  88         return new Gigabyte(subtractNullsafe(bytes, storageAmount.bytes));
  89     }
  90
  91     @Override
  92     protected BigInteger getNumberOfBytesPerUnit() {
  93         return StorageUnit.BYTES_IN_A_GIGABYTE;
  94     }
  95
  96     @Override
  97     protected String getSymbol() {
  98         return "GB"; //$NON-NLS-1$
  99     }
 100
 101     @Override
 102     protected Function<@NonNull BigInteger, @NonNull StorageUnit<?>> converter() {
 103         return StorageUnits::metricValueOf;
 104     }
 105
 106 }