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 * Hours. 14 * 15 * Not DSGVO relevant. 16 * 17 * TODO min, max 18 */ 19 public final class Hours implements Comparable<Hours>, IValueObject 20 { 21 /* * 22 * Cache for singletons. 23 */ 24 // private static final Map<Long, Hours> CACHE = new WeakHashMap<>(); 25 26 /** 27 * Hours. 28 */ 29 private final long hours; 30 31 32 /** 33 * Constructor. 34 * 35 * @param hours Hours 0-.. 36 * @throws IndexOutOfBoundsException When the hours is less than 0 37 */ 38 private Hours(final long hours) 39 { 40 super(); 41 if (hours < 0) 42 { 43 throw new IndexOutOfBoundsException("Negative hours are not allowed"); //$NON-NLS-1$ 44 } 45 this.hours = hours; 46 } 47 48 49 /** 50 * Hours factory. 51 * 52 * @param hours Hours 0-.. 53 * @return Hours object 54 */ 55 public static Hours of(final long hours) 56 { 57 /* 58 synchronized (Hours.class) 59 { 60 Hours obj = Hours.CACHE.get(hours); 61 if (obj != null) 62 { 63 return obj; 64 } 65 obj = new Hours(hours); 66 Hours.CACHE.put(Long.valueOf(hours), obj); 67 return obj; 68 } 69 */ 70 return new Hours(hours); 71 } 72 73 74 /** 75 * Hours factory. 76 * 77 * @param value Hours 0-.. string 78 * @return Hours object 79 */ 80 public static Hours of(final String value) 81 { 82 return of(Long.parseLong(value)); 83 } 84 85 86 /** 87 * Returns the value of this BFPONumber 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.hours; 94 } 95 96 97 /** 98 * Returns the value of this BFPONumber 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.hours); 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.hours); 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 Hours)) 137 { 138 return false; 139 } 140 final Hours other = (Hours)obj; 141 return this.hours == other.hours; 142 } 143 144 145 /** 146 * Returns the string representation of this Hours. 147 * 148 * The exact details of this representation are unspecified and subject to change, but the following may be regarded as typical: 149 * 150 * "Hours[hours=1]" 151 * 152 * @return String representation of this Hours 153 * @see java.lang.Object#toString() 154 */ 155 @Override 156 public String toString() 157 { 158 final var builder = new StringBuilder(); 159 builder.append("Hours[hours=").append(this.hours).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 Hours obj) 173 { 174 Objects.requireNonNull(obj, "obj"); //$NON-NLS-1$ 175 return Long.compare(this.hours, obj.hours); 176 } 177 178 179 /** 180 * Add other hours to this hours. 181 * 182 * @param other Other hours to add to this hours 183 * @return New hours after adding other hours to this hours 184 * @throws ArithmeticException In case of an overflow 185 */ 186 public Hours add(final Hours other) 187 { 188 return Hours.of(Math.addExact(this.hours, other.hours)); 189 } 190 191 192 /** 193 * Subtract other hours from this hours. 194 * 195 * @param other Other hours to subtract from this one 196 * @return Absolute new hours after subtracting other hours from this hours 197 */ 198 public Hours subtract(final Hours other) 199 { 200 if (other.hours > this.hours) 201 { 202 return Hours.of(other.hours - this.hours); 203 } 204 return Hours.of(this.hours - other.hours); 205 } 206 207 208 /** 209 * Multiply hours with a multiplier. 210 * 211 * @param multiplier Multiplier to multiply with 212 * @return New hours that is a multiplication of this hours with the multiplier 213 * @throws ArithmeticException In case of an overflow 214 */ 215 public Hours multiply(final long multiplier) 216 { 217 return Hours.of(Math.multiplyExact(this.hours, multiplier)); 218 } 219 220 221 /** 222 * Divide hours 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 Hours divide(final long divisor) 229 { 230 return Hours.of(Math.floorDiv(this.hours, divisor)); 231 } 232 233 234 /** 235 * Floor modulo hours by a divisor. 236 * 237 * @param divisor Divisor to divide by 238 * @return The floor modulus Hours - (floorDiv(Hours, divisor) * divisor) 239 * @throws ArithmeticException In case the divisor is 0. 240 */ 241 public Hours modulo(final long divisor) 242 { 243 return Hours.of(Math.floorMod(this.hours, divisor)); 244 } 245 246 }