*/
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 org.eclipse.jdt.annotation.NonNull;
import org.eclipse.jdt.annotation.NonNullByDefault;
import org.eclipse.jdt.annotation.Nullable;
-import org.kohsuke.MetaInfServices;
import org.opendaylight.yangtools.concepts.Variant;
/**
@Beta
@NonNullByDefault
public class Uint8 extends Number implements CanonicalValue<Uint8> {
- @MetaInfServices(value = CanonicalValueSupport.class)
public static final class Support extends AbstractCanonicalValueSupport<Uint8> {
public Support() {
super(Uint8.class);
private static final CanonicalValueSupport<Uint8> SUPPORT = new Support();
- static final short MIN_VALUE_SHORT = 0;
- static final short MAX_VALUE_SHORT = 255;
+ private static final short MAX_VALUE_SHORT = 255;
+ private static final String MAX_VALUE_STR = "255";
private static final long serialVersionUID = 1L;
- private static final Uint8[] CACHE = new Uint8[MAX_VALUE_SHORT + 1];
- public static final Uint8 MIN_VALUE = valueOf(MIN_VALUE_SHORT);
+ private static final @NonNull Uint8[] CACHE;
+
+ static {
+ final Uint8[] c = new Uint8[MAX_VALUE_SHORT + 1];
+ for (int i = 0; i <= MAX_VALUE_SHORT; ++i) {
+ c[i] = new Uint8((byte)i);
+ }
+ CACHE = c;
+ }
+
+ /**
+ * Value of {@code 0}.
+ */
+ public static final Uint8 ZERO = valueOf(0);
+ /**
+ * Value of {@code 1}.
+ */
+ public static final Uint8 ONE = valueOf(1);
+ /**
+ * Value of {@code 2}.
+ */
+ public static final Uint8 TWO = valueOf(2);
+ /**
+ * Value of {@code 10}.
+ */
+ public static final Uint8 TEN = valueOf(10);
+ /**
+ * Value of {@code 255}.
+ */
public static final Uint8 MAX_VALUE = valueOf(MAX_VALUE_SHORT);
private final byte value;
}
protected Uint8(final Uint8 other) {
- this.value = other.value;
+ this(other.value);
}
private static Uint8 instanceFor(final byte value) {
- final int slot = Byte.toUnsignedInt(value);
-
- // FIXME: 4.0.0: use VarHandles here
- Uint8 ret = CACHE[slot];
- if (ret == null) {
- synchronized (CACHE) {
- ret = CACHE[slot];
- if (ret == null) {
- ret = new Uint8(value);
- CACHE[slot] = ret;
- }
- }
- }
-
- return ret;
+ return CACHE[Byte.toUnsignedInt(value)];
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given bit representation. The argument is interpreted as an
+ * unsigned 8-bit value.
+ *
+ * @param bits unsigned bit representation
+ * @return A Uint8 instance
+ */
public static Uint8 fromByteBits(final byte bits) {
return instanceFor(bits);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code byteVal}. The inverse operation is {@link #byteValue()}.
+ *
+ * @param byteVal byte value
+ * @return A Uint8 instance
+ * @throws IllegalArgumentException if byteVal is less than zero
+ */
public static Uint8 valueOf(final byte byteVal) {
- checkArgument(byteVal >= MIN_VALUE_SHORT, "Negative values are not allowed");
+ UintConversions.checkNonNegative(byteVal, MAX_VALUE_STR);
return instanceFor(byteVal);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code shortVal}. The inverse operation is
+ * {@link #shortValue()}.
+ *
+ * @param shortVal short value
+ * @return A Uint8 instance
+ * @throws IllegalArgumentException if shortVal is less than zero or greater than 255.
+ */
public static Uint8 valueOf(final short shortVal) {
- checkArgument(shortVal >= MIN_VALUE_SHORT && shortVal <= MAX_VALUE_SHORT,
- "Value %s is outside of allowed range", shortVal);
- return instanceFor((byte)(shortVal & 0xff));
+ UintConversions.checkRange(shortVal, MAX_VALUE_SHORT);
+ return instanceFor((byte)shortVal);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code intVal}. The inverse operation is {@link #intValue()}.
+ *
+ * @param intVal int value
+ * @return A Uint8 instance
+ * @throws IllegalArgumentException if intVal is less than zero or greater than 255.
+ */
public static Uint8 valueOf(final int intVal) {
- checkArgument(intVal >= MIN_VALUE_SHORT && intVal <= MAX_VALUE_SHORT,
- "Value %s is outside of allowed range", intVal);
- return instanceFor((byte)(intVal & 0xff));
+ UintConversions.checkRange(intVal, MAX_VALUE_SHORT);
+ return instanceFor((byte)intVal);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code longVal}. The inverse operation is
+ * {@link #longValue()}.
+ *
+ * @param longVal long value
+ * @return A Uint8 instance
+ * @throws IllegalArgumentException if intVal is less than zero or greater than 255.
+ */
public static Uint8 valueOf(final long longVal) {
- checkArgument(longVal >= MIN_VALUE_SHORT && longVal <= MAX_VALUE_SHORT,
- "Value %s is outside of allowed range", longVal);
- return instanceFor((byte)(longVal & 0xff));
+ UintConversions.checkRange(longVal, MAX_VALUE_SHORT);
+ return instanceFor((byte)longVal);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint16 value
+ * @return A Uint8 instance
+ * @throws NullPointerException if uint is null
+ * @throws IllegalArgumentException if uint is greater than 255.
+ */
public static Uint8 valueOf(final Uint16 uint) {
return valueOf(uint.intValue());
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint32 value
+ * @return A Uint8 instance
+ * @throws NullPointerException if uint is null
+ * @throws IllegalArgumentException if uint is greater than 255.
+ */
public static Uint8 valueOf(final Uint32 uint) {
return valueOf(uint.longValue());
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code uint}.
+ *
+ * @param uint Uint64 value
+ * @return A Uint8 instance
+ * @throws NullPointerException if uint is null
+ * @throws IllegalArgumentException if uint is greater than 255.
+ */
public static Uint8 valueOf(final Uint64 uint) {
return valueOf(uint.longValue());
}
+ /**
+ * Returns an {@code Uint8} holding the value of the specified {@code String}, parsed as an unsigned {@code short}
+ * value.
+ *
+ * @param string String to parse
+ * @return A Uint8 instance
+ * @throws NullPointerException if string is null
+ * @throws IllegalArgumentException if the parsed value is less than zero or greater than 255
+ * @throws NumberFormatException if the string does not contain a parsable unsigned {@code short} value.
+ */
public static Uint8 valueOf(final String string) {
return valueOf(string, 10);
}
+ /**
+ * Returns an {@code Uint8} holding the value of the specified {@code String}, parsed as an unsigned {@code short}
+ * value.
+ *
+ * @param string String to parse
+ * @param radix Radix to use
+ * @return A Uint8 instance
+ * @throws NullPointerException if string is null
+ * @throws IllegalArgumentException if the parsed value is less than zero or greater than 255
+ * @throws NumberFormatException if the string does not contain a parsable unsigned {@code short} value, or if the
+ * {@code radix} is outside of allowed range.
+ */
public static Uint8 valueOf(final String string, final int radix) {
- return valueOf(Short.parseShort(string, radix));
+ return valueOf(Short.parseShort(requireNonNull(string), radix));
+ }
+
+ /**
+ * Returns an {@code Uint8} 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 Uint8 instance
+ */
+ public static Uint8 saturatedOf(final byte byteVal) {
+ return byteVal <= 0 ? Uint8.ZERO : instanceFor(byteVal);
+ }
+
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code shortVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned. If the value is greater than 255, {@link #MAX_VALUE} will be returned.
+ *
+ * @param shortVal short value
+ * @return A Uint8 instance
+ */
+ public static Uint8 saturatedOf(final short shortVal) {
+ if (shortVal <= 0) {
+ return Uint8.ZERO;
+ }
+ if (shortVal >= MAX_VALUE_SHORT) {
+ return Uint8.MAX_VALUE;
+ }
+ return instanceFor((byte) shortVal);
}
+ /**
+ * Returns an {@code Uint8} corresponding to a given {@code intVal} if it is representable. If the value is
+ * negative {@link #ZERO} will be returned. If the value is greater than 255, {@link #MAX_VALUE} will be returned.
+ *
+ * @param intVal int value
+ * @return A Uint8 instance
+ */
+ public static Uint8 saturatedOf(final int intVal) {
+ if (intVal <= 0) {
+ return Uint8.ZERO;
+ }
+ if (intVal >= MAX_VALUE_SHORT) {
+ return Uint8.MAX_VALUE;
+ }
+ return instanceFor((byte) intVal);
+ }
+
+ /**
+ * Returns an {@code Uint8} 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 255, {@link #MAX_VALUE} will be returned.
+ *
+ * @param longVal long value
+ * @return A Uint8 instance
+ */
+ public static Uint8 saturatedOf(final long longVal) {
+ if (longVal <= 0) {
+ return Uint8.ZERO;
+ }
+ if (longVal >= MAX_VALUE_SHORT) {
+ return Uint8.MAX_VALUE;
+ }
+ return instanceFor((byte) longVal);
+ }
+
+ /**
+ * {@inheritDoc}
+ *
+ * <p>
+ * The inverse operation is {@link #fromByteBits(byte)}. In case this value is greater than {@link Byte#MAX_VALUE},
+ * the returned value will be equal to {@code this - 2^8}.
+ */
@Override
public final byte byteValue() {
return value;
@Override
@SuppressWarnings("checkstyle:parameterName")
public final int compareTo(final Uint8 o) {
- return intValue() - o.intValue();
+ return Byte.compareUnsigned(value, o.value);
}
@Override
public final String toCanonicalString() {
- return String.valueOf(intValue());
+ return Integer.toString(intValue());
}
@Override
return SUPPORT;
}
+ /**
+ * Convert this value to a {@code short}.
+ *
+ * @return A short
+ */
+ public final short toJava() {
+ return shortValue();
+ }
+
+ /**
+ * Convert this value to a {@code Uint16}.
+ *
+ * @return A Uint16
+ */
+ public final Uint16 toUint16() {
+ return Uint16.fromShortBits(shortValue());
+ }
+
+ /**
+ * Convert this value to a {@code Uint32}.
+ *
+ * @return A Uint32
+ */
+ public final Uint32 toUint32() {
+ return Uint32.fromIntBits(intValue());
+ }
+
+ /**
+ * Convert this value to a {@code Uint64}.
+ *
+ * @return A Uint64
+ */
+ public final Uint64 toUint64() {
+ return Uint64.fromLongBits(longValue());
+ }
+
@Override
public final int hashCode() {
return Byte.hashCode(value);
return this == obj || obj instanceof Uint8 && value == ((Uint8)obj).value;
}
+ /**
+ * A slightly faster version of {@link #equals(Object)}.
+ *
+ * @param obj Uint8 object
+ * @return {@code true} if this object is the same as the obj argument; {@code false} otherwise.
+ */
+ public final boolean equals(final @Nullable Uint8 obj) {
+ return this == obj || obj != null && value == obj.value;
+ }
+
@Override
public final String toString() {
return toCanonicalString();