1 /* 2 * Copyright (C) 2020-2023 Dipl.-Inform. Kai Hofmann. All rights reserved! 3 */ 4 package de.powerstat.validation.values; 5 6 7 import java.util.Objects; 8 9 import de.powerstat.validation.interfaces.IValueObject; 10 11 12 /** 13 * Minutes. 14 * 15 * Not DSGVO relevant. 16 * 17 * TODO min, max 18 */ 19 public final class Minutes implements Comparable<Minutes>, IValueObject 20 { 21 /* * 22 * Cache for singletons. 23 */ 24 // private static final Map<Long, Minutes> CACHE = new WeakHashMap<>(); 25 26 /** 27 * Minutes. 28 */ 29 private final long minutes; 30 31 32 /** 33 * Constructor. 34 * 35 * @param minutes Minutes 0-.. 36 * @throws IndexOutOfBoundsException When the minutes is less than 0 37 */ 38 private Minutes(final long minutes) 39 { 40 super(); 41 if (minutes < 0) 42 { 43 throw new IndexOutOfBoundsException("Negative minutes are not allowed"); //$NON-NLS-1$ 44 } 45 this.minutes = minutes; 46 } 47 48 49 /** 50 * Minutes factory. 51 * 52 * @param minutes Minutes 0-.. 53 * @return Minutes object 54 */ 55 public static Minutes of(final long minutes) 56 { 57 /* 58 synchronized (Minutes.class) 59 { 60 Minutes obj = Minutes.CACHE.get(minutes); 61 if (obj != null) 62 { 63 return obj; 64 } 65 obj = new Minutes(minutes); 66 Minutes.CACHE.put(Long.valueOf(minutes), obj); 67 return obj; 68 } 69 */ 70 return new Minutes(minutes); 71 } 72 73 74 /** 75 * Minutes factory. 76 * 77 * @param value Minutes 0-.. string 78 * @return Minutes object 79 */ 80 public static Minutes of(final String value) 81 { 82 return of(Long.parseLong(value)); 83 } 84 85 86 /** 87 * Returns the value of this Minutes as a long. 88 * 89 * @return The numeric value represented by this object after conversion to type long. 90 */ 91 public long longValue() 92 { 93 return this.minutes; 94 } 95 96 97 /** 98 * Returns the value of this Minutes as a String. 99 * 100 * @return The numeric value represented by this object after conversion to type String. 101 */ 102 @Override 103 public String stringValue() 104 { 105 return String.valueOf(this.minutes); 106 } 107 108 109 /** 110 * Calculate hash code. 111 * 112 * @return Hash 113 * @see java.lang.Object#hashCode() 114 */ 115 @Override 116 public int hashCode() 117 { 118 return Long.hashCode(this.minutes); 119 } 120 121 122 /** 123 * Is equal with another object. 124 * 125 * @param obj Object 126 * @return true when equal, false otherwise 127 * @see java.lang.Object#equals(java.lang.Object) 128 */ 129 @Override 130 public boolean equals(final Object obj) 131 { 132 if (this == obj) 133 { 134 return true; 135 } 136 if (!(obj instanceof Minutes)) 137 { 138 return false; 139 } 140 final Minutes other = (Minutes)obj; 141 return this.minutes == other.minutes; 142 } 143 144 145 /** 146 * Returns the string representation of this Minutes. 147 * 148 * The exact details of this representation are unspecified and subject to change, but the following may be regarded as typical: 149 * 150 * "Minutes[minutes=1]" 151 * 152 * @return String representation of this Minutes 153 * @see java.lang.Object#toString() 154 */ 155 @Override 156 public String toString() 157 { 158 final var builder = new StringBuilder(17); 159 builder.append("Minutes[minutes=").append(this.minutes).append(']'); //$NON-NLS-1$ 160 return builder.toString(); 161 } 162 163 164 /** 165 * Compare with another object. 166 * 167 * @param obj Object to compare with 168 * @return 0: equal; 1: greater; -1: smaller 169 * @see java.lang.Comparable#compareTo(java.lang.Object) 170 */ 171 @Override 172 public int compareTo(final Minutes obj) 173 { 174 Objects.requireNonNull(obj, "obj"); //$NON-NLS-1$ 175 return Long.compare(this.minutes, obj.minutes); 176 } 177 178 179 /** 180 * Add other minutes to this minutes. 181 * 182 * @param other Other minutes to add to this minutes 183 * @return New minutes after adding other minutes to this minutes 184 * @throws ArithmeticException In case of an overflow 185 */ 186 public Minutes add(final Minutes other) 187 { 188 return Minutes.of(Math.addExact(this.minutes, other.minutes)); 189 } 190 191 192 /** 193 * Subtract other minutes from this minutes. 194 * 195 * @param other Other minutes to subtract from this one 196 * @return Absolute new minutes after subtracting other minutes from this minutes 197 */ 198 public Minutes subtract(final Minutes other) 199 { 200 if (other.minutes > this.minutes) 201 { 202 return Minutes.of(other.minutes - this.minutes); 203 } 204 return Minutes.of(this.minutes - other.minutes); 205 } 206 207 208 /** 209 * Multiply minutes with a multiplier. 210 * 211 * @param multiplier Multiplier to multiply with 212 * @return New minutes that is a multiplication of this minutes with the multiplier 213 * @throws ArithmeticException In case of an overflow 214 */ 215 public Minutes multiply(final long multiplier) 216 { 217 return Minutes.of(Math.multiplyExact(this.minutes, multiplier)); 218 } 219 220 221 /** 222 * Divide minutes by a divisor. 223 * 224 * @param divisor Divisor to divide by 225 * @return The largest (closest to positive infinity) long value that is less than or equal to the algebraic quotient. 226 * @throws ArithmeticException In case the divisor is 0. 227 */ 228 public Minutes divide(final long divisor) 229 { 230 return Minutes.of(Math.floorDiv(this.minutes, divisor)); 231 } 232 233 234 /** 235 * Floor modulo minutes by a divisor. 236 * 237 * @param divisor Divisor to divide by 238 * @return The floor modulus Minutes - (floorDiv(Minutes, divisor) * divisor) 239 * @throws ArithmeticException In case the divisor is 0. 240 */ 241 public Minutes modulo(final long divisor) 242 { 243 return Minutes.of(Math.floorMod(this.minutes, divisor)); 244 } 245 246 }