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