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