*/
package org.opendaylight.yangtools.yang.common;
-import static com.google.common.base.Preconditions.checkArgument;
+import static java.util.Objects.requireNonNull;
import com.google.common.annotations.Beta;
-import com.google.common.annotations.VisibleForTesting;
-import com.google.common.cache.CacheBuilder;
-import com.google.common.cache.CacheLoader;
-import com.google.common.cache.LoadingCache;
+import com.google.common.collect.Interner;
+import com.google.common.collect.Interners;
import com.google.common.primitives.UnsignedLong;
import java.math.BigInteger;
-import org.opendaylight.yangtools.concepts.Immutable;
+import org.eclipse.jdt.annotation.NonNull;
+import org.eclipse.jdt.annotation.NonNullByDefault;
+import org.eclipse.jdt.annotation.Nullable;
+import org.opendaylight.yangtools.concepts.Variant;
/**
* Dedicated type for YANG's 'type uint64' type.
* @author Robert Varga
*/
@Beta
-public final class Uint64 extends Number implements Comparable<Uint64>, Immutable {
+@NonNullByDefault
+public class Uint64 extends Number implements CanonicalValue<Uint64> {
+ public static final class Support extends AbstractCanonicalValueSupport<Uint64> {
+ public Support() {
+ super(Uint64.class);
+ }
+
+ @Override
+ public Variant<Uint64, CanonicalValueViolation> fromString(final String str) {
+ try {
+ return Variant.ofFirst(Uint64.valueOf(str));
+ } catch (IllegalArgumentException e) {
+ return CanonicalValueViolation.variantOf(e);
+ }
+ }
+ }
+
+ private static final CanonicalValueSupport<Uint64> SUPPORT = new Support();
private static final long serialVersionUID = 1L;
- private static final long MIN_VALUE = 0;
+ private static final String MAX_VALUE_STR = Long.toUnsignedString(-1);
- /**
- * Cache of first 256 values.
- */
- private static final Uint64[] CACHE = new Uint64[Uint8.MAX_VALUE];
- /**
- * Commonly encountered values.
- */
- private static final Uint64[] COMMON = {
- new Uint64(Short.MAX_VALUE + 1L),
- new Uint64(32768),
- new Uint64(65535),
- new Uint64(65536),
- new Uint64(Integer.MAX_VALUE),
- new Uint64(Integer.MAX_VALUE + 1L),
- new Uint64(Long.MAX_VALUE),
- };
+ private static final String CACHE_SIZE_PROPERTY = "org.opendaylight.yangtools.yang.common.Uint64.cache.size";
+ private static final int DEFAULT_CACHE_SIZE = 256;
/**
- * Tunable weak LRU cache for other values. By default it holds {@value #DEFAULT_LRU_SIZE} entries. This can be
- * changed via {@value #LRU_SIZE_PROPERTY} system property.
+ * Tunable cache for values. By default it holds {@value #DEFAULT_CACHE_SIZE} entries. This can be
+ * changed via {@value #CACHE_SIZE_PROPERTY} system property.
*/
- private static final int DEFAULT_LRU_SIZE = 1024;
- private static final String LRU_SIZE_PROPERTY = "org.opendaylight.yangtools.yang.common.Uint64.LRU.size";
- private static final int MAX_LRU_SIZE = 0xffffff;
- private static final int LRU_SIZE;
+ private static final long CACHE_SIZE;
+
+ static {
+ final int p = Integer.getInteger(CACHE_SIZE_PROPERTY, DEFAULT_CACHE_SIZE);
+ CACHE_SIZE = p >= 0 ? Math.min(p, Integer.MAX_VALUE) : DEFAULT_CACHE_SIZE;
+ }
+
+ private static final @NonNull Uint64[] CACHE;
static {
- final int p = Integer.getInteger(LRU_SIZE_PROPERTY, DEFAULT_LRU_SIZE);
- LRU_SIZE = p >= 0 ? Math.min(p, MAX_LRU_SIZE) : DEFAULT_LRU_SIZE;
+ final Uint64[] c = new Uint64[(int) CACHE_SIZE];
+ for (int i = 0; i < c.length; ++i) {
+ c[i] = new Uint64(i);
+ }
+ CACHE = c;
}
- private static final LoadingCache<Long, Uint64> LRU = CacheBuilder.newBuilder().weakValues().maximumSize(LRU_SIZE)
- .build(new CacheLoader<Long, Uint64>() {
- @Override
- public Uint64 load(final Long key) {
- return new Uint64(key);
- }
- });
+ private static final Interner<Uint64> INTERNER = Interners.newWeakInterner();
+
+ /**
+ * Value of {@code 0}.
+ */
+ public static final Uint64 ZERO = valueOf(0).intern();
+ /**
+ * Value of {@code 1}.
+ */
+ public static final Uint64 ONE = valueOf(1).intern();
+ /**
+ * Value of {@code 2}.
+ */
+ public static final Uint64 TWO = valueOf(2).intern();
+ /**
+ * Value of {@code 10}.
+ */
+ public static final Uint64 TEN = valueOf(10).intern();
+ /**
+ * Value of {@code 18446744073709551615}.
+ */
+ public static final Uint64 MAX_VALUE = fromLongBits(-1).intern();
private final long value;
- @VisibleForTesting
- Uint64(final long value) {
+ private Uint64(final long value) {
this.value = value;
}
- private static Uint64 instanceFor(final long value) {
- final int slot = (int)value;
- if (slot < 0 || slot >= CACHE.length) {
- for (Uint64 c : COMMON) {
- if (c.value == value) {
- return c;
- }
- }
-
- return LRU.getUnchecked(value);
- }
-
- Uint64 ret = CACHE[slot];
- if (ret == null) {
- synchronized (CACHE) {
- ret = CACHE[slot];
- if (ret == null) {
- ret = new Uint64(value);
- CACHE[slot] = ret;
- }
- }
- }
+ protected Uint64(final Uint64 other) {
+ this(other.value);
+ }
- return ret;
+ private static Uint64 instanceFor(final long value) {
+ return value >= 0 && value < CACHE.length ? CACHE[(int) value] : new Uint64(value);
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given bit representation. The argument is interpreted as an
+ * unsigned 64-bit value.
+ *
+ * @param bits unsigned bit representation
+ * @return A Uint64 instance
+ */
public static Uint64 fromLongBits(final long bits) {
return instanceFor(bits);
}
- public static Uint64 fromUnsignedLong(final UnsignedLong ulong) {
- return instanceFor(ulong.longValue());
- }
-
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code byteVal}. The inverse operation is
+ * {@link #byteValue()}.
+ *
+ * @param byteVal byte value
+ * @return A Uint64 instance
+ * @throws IllegalArgumentException if byteVal is less than zero
+ */
public static Uint64 valueOf(final byte byteVal) {
- checkArgument(byteVal >= MIN_VALUE, "Negative values are not allowed");
+ UintConversions.checkNonNegative(byteVal, MAX_VALUE_STR);
return instanceFor(byteVal);
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code shortVal}. The inverse operation is
+ * {@link #shortValue()}.
+ *
+ * @param shortVal short value
+ * @return A Uint64 instance
+ * @throws IllegalArgumentException if shortVal is less than zero
+ */
public static Uint64 valueOf(final short shortVal) {
- checkArgument(shortVal >= MIN_VALUE, "Negative values are not allowed");
+ UintConversions.checkNonNegative(shortVal, MAX_VALUE_STR);
return instanceFor(shortVal);
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code intVal}. The inverse operation is {@link #intValue()}.
+ *
+ * @param intVal int value
+ * @return A Uint64 instance
+ * @throws IllegalArgumentException if intVal is less than zero
+ */
public static Uint64 valueOf(final int intVal) {
- checkArgument(intVal >= MIN_VALUE, "Value %s is outside of allowed range", intVal);
+ UintConversions.checkNonNegative(intVal, MAX_VALUE_STR);
return instanceFor(intVal);
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code longVal}, which is checked for range.
+ * See also {@link #longValue()} and {@link #fromLongBits(long)}.
+ *
+ * @param longVal long value
+ * @return A Uint8 instance
+ * @throws IllegalArgumentException if longVal is less than zero
+ */
public static Uint64 valueOf(final long longVal) {
- checkArgument(longVal >= MIN_VALUE, "Value %s is outside of allowed range", longVal);
- return instanceFor(longVal);
+ if (longVal >= 0) {
+ return instanceFor(longVal);
+ }
+ throw new IllegalArgumentException("Invalid range: " + longVal + ", expected: [[0..18446744073709551615]].");
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint8 value
+ * @return A Uint64 instance
+ * @throws NullPointerException if uint is null
+ */
public static Uint64 valueOf(final Uint8 uint) {
return instanceFor(uint.shortValue());
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint16 value
+ * @return A Uint64 instance
+ * @throws NullPointerException if uint is null
+ */
public static Uint64 valueOf(final Uint16 uint) {
return instanceFor(uint.intValue());
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint32 value
+ * @return A Uint64 instance
+ * @throws NullPointerException if uint is null
+ */
public static Uint64 valueOf(final Uint32 uint) {
return instanceFor(uint.longValue());
}
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code ulong}.
+ *
+ * @param ulong UnsignedLong value
+ * @return A Uint64 instance
+ * @throws NullPointerException if ulong is null
+ */
+ public static Uint64 valueOf(final UnsignedLong ulong) {
+ return instanceFor(ulong.longValue());
+ }
+
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code bigInt}.
+ *
+ * @param bigInt BigInteger value
+ * @return A Uint64 instance
+ * @throws NullPointerException if bigInt is null
+ * @throws IllegalArgumentException if bigInt is less than zero or greater than 18446744073709551615
+ */
+ public static Uint64 valueOf(final BigInteger bigInt) {
+ if (bigInt.signum() >= 0 && bigInt.bitLength() <= Long.SIZE) {
+ return instanceFor(bigInt.longValue());
+ }
+ throw new IllegalArgumentException("Invalid range: " + bigInt + ", expected: [[0..18446744073709551615]].");
+ }
+
+ /**
+ * Returns an {@code Uint32} holding the value of the specified {@code String}, parsed as an unsigned {@code long}
+ * value.
+ *
+ * @param string String to parse
+ * @return A Uint64 instance
+ * @throws NullPointerException if string is null
+ * @throws IllegalArgumentException if the parsed value is less than zero or greater than 18446744073709551615
+ * @throws NumberFormatException if the string does not contain a parsable unsigned {@code long} value.
+ */
public static Uint64 valueOf(final String string) {
return valueOf(string, 10);
}
+ /**
+ * Returns an {@code Uint64} holding the value of the specified {@code String}, parsed as an unsigned {@code long}
+ * value.
+ *
+ * @param string String to parse
+ * @param radix Radix to use
+ * @return A Uint64 instance
+ * @throws NullPointerException if string is null
+ * @throws IllegalArgumentException if the parsed value is less than zero or greater than 18446744073709551615
+ * @throws NumberFormatException if the string does not contain a parsable unsigned {@code long} value, or if the
+ * {@code radix} is outside of allowed range.
+ */
public static Uint64 valueOf(final String string, final int radix) {
- return instanceFor(Long.parseUnsignedLong(string, radix));
+ return instanceFor(Long.parseUnsignedLong(requireNonNull(string), radix));
}
- public static Uint64 valueOf(final BigInteger bigInt) {
- checkArgument(bigInt.signum() >= 0, "Negative values not allowed");
- checkArgument(bigInt.bitLength() <= Long.SIZE, "Value %s is outside of allowed range", bigInt);
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code byteVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned.
+ *
+ * @param byteVal byte value
+ * @return A Uint64 instance
+ */
+ public static Uint64 saturatedOf(final byte byteVal) {
+ return byteVal < 0 ? Uint64.ZERO : instanceFor(byteVal);
+ }
+
+ /**
+ * Returns an {@code Uint32} corresponding to a given {@code shortVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned.
+ *
+ * @param shortVal short value
+ * @return A Uint32 instance
+ */
+ public static Uint64 saturatedOf(final short shortVal) {
+ return shortVal < 0 ? Uint64.ZERO : instanceFor(shortVal);
+ }
+
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code intVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned.
+ *
+ * @param intVal int value
+ * @return A Uint64 instance
+ */
+ public static Uint64 saturatedOf(final int intVal) {
+ return intVal < 0 ? Uint64.ZERO : instanceFor(intVal);
+ }
+
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code longVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned.
+ *
+ * @param longVal long value
+ * @return A Uint64 instance
+ */
+ public static Uint64 saturatedOf(final long longVal) {
+ return longVal < 0 ? Uint64.ZERO : instanceFor(longVal);
+ }
- return instanceFor(bigInt.longValue());
+ /**
+ * Returns an {@code Uint64} corresponding to a given {@code longVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned. If the value is greater than 18446744073709551615, {@link #MAX_VALUE}
+ * will be returned.
+ *
+ * @param bigInt BigInteger value
+ * @return A Uint64 instance
+ * @throws NullPointerException if bigInt is null
+ */
+ public static Uint64 saturatedOf(final BigInteger bigInt) {
+ if (bigInt.signum() < 0) {
+ return Uint64.ZERO;
+ }
+ return bigInt.bitLength() > Long.SIZE ? Uint64.MAX_VALUE : instanceFor(bigInt.longValue());
}
@Override
- public int intValue() {
+ public final int intValue() {
return (int)value;
}
+ /**
+ * {@inheritDoc}
+ *
+ * <p>
+ * The inverse operation is {@link #fromLongBits(long)}. In case this value is greater than {@link Long#MAX_VALUE},
+ * the returned value will be equal to {@code this - 2^64}.
+ */
@Override
- public long longValue() {
+ public final long longValue() {
return value;
}
@Override
- public float floatValue() {
+ public final float floatValue() {
// TODO: ditch Guava
return UnsignedLong.fromLongBits(value).floatValue();
}
@Override
- public double doubleValue() {
+ public final double doubleValue() {
// TODO: ditch Guava
return UnsignedLong.fromLongBits(value).doubleValue();
}
- public UnsignedLong toUnsignedLong() {
- return UnsignedLong.fromLongBits(value);
- }
-
@Override
@SuppressWarnings("checkstyle:parameterName")
- public int compareTo(final Uint64 o) {
+ public final int compareTo(final Uint64 o) {
return Long.compareUnsigned(value, o.value);
}
@Override
- public int hashCode() {
- return Long.hashCode(value);
+ public final String toCanonicalString() {
+ return Long.toUnsignedString(value);
}
@Override
- public boolean equals(final Object obj) {
- if (this == obj) {
- return true;
+ public final CanonicalValueSupport<Uint64> support() {
+ return SUPPORT;
+ }
+
+ /**
+ * Return an interned (shared) instance equivalent to this object. This may return the same object.
+ *
+ * @return A shared instance.
+ */
+ public final Uint64 intern() {
+ return value >= 0 && value < CACHE_SIZE ? this : INTERNER.intern(this);
+ }
+
+ /**
+ * Convert this value to a {@link BigInteger}.
+ *
+ * @return A BigInteger instance
+ */
+ public final BigInteger toJava() {
+ // FIXME: ditch the Guava transition
+ return toGuava().bigIntegerValue();
+ }
+
+ /**
+ * Convert this value to an {@link UnsignedLong}.
+ *
+ * @return An UnsignedLong instance
+ */
+ public final UnsignedLong toGuava() {
+ return UnsignedLong.fromLongBits(value);
+ }
+
+ /**
+ * Convert this value to a {@code Uint8}.
+ *
+ * @return A Uint8
+ * @throws IllegalArgumentException if this value is greater than 255.
+ */
+ public final Uint8 toUint8() {
+ if ((value & 0xFFFFFFFFFFFFFF00L) != 0) {
+ UintConversions.throwIAE(toString(), 255);
}
+ return Uint8.fromByteBits((byte) value);
+ }
- return obj instanceof Uint64 && value == ((Uint64)obj).value;
+ /**
+ * Convert this value to a {@code Uint16}.
+ *
+ * @return A Uint16
+ * @throws IllegalArgumentException if this value is greater than 65535.
+ */
+ public final Uint16 toUint16() {
+ if ((value & 0xFFFFFFFFFFFF0000L) != 0) {
+ UintConversions.throwIAE(toString(), 65535);
+ }
+ return Uint16.fromShortBits((short) value);
+ }
+
+ /**
+ * Convert this value to a {@code Uint64}.
+ *
+ * @return A Uint32
+ * @throws IllegalArgumentException if this value is greater than 4294967295.
+ */
+ public final Uint32 toUint32() {
+ if ((value & 0xFFFFFFFF00000000L) != 0) {
+ UintConversions.throwIAE(toString(), 4294967295L);
+ }
+ return Uint32.fromIntBits((int) value);
}
@Override
- public String toString() {
- return Long.toUnsignedString(value);
+ public final int hashCode() {
+ return Long.hashCode(value);
+ }
+
+ @Override
+ public final boolean equals(final @Nullable Object obj) {
+ return this == obj || obj instanceof Uint64 && value == ((Uint64)obj).value;
+ }
+
+ /**
+ * A slightly faster version of {@link #equals(Object)}.
+ *
+ * @param obj Uint64 object
+ * @return {@code true} if this object is the same as the obj argument; {@code false} otherwise.
+ */
+ public final boolean equals(final @Nullable Uint64 obj) {
+ return this == obj || obj != null && value == obj.value;
+ }
+
+ @Override
+ public final String toString() {
+ return toCanonicalString();
}
private Object readResolve() {