Java中使用 Long 表示枚举类
在日常的开发过程中,很多时候我们需要枚举类(enum)来表示对象的各种状态,并且每个状态往往会关联到指定的数字,如:
private enum Color {
RED(11), GREEN(21), YELLOW(31), BLACK(160);
...
};
或者用枚举类来表示一系列状态的转变关系:
enum Week{
SUNDAY(1), MONDAY(2), TUESDAY(3), WEDNESDAY(4), THRUSDAY(5), FRIDAY(6), SATRUDAY7);
...
};
那么,如何用最少的存储来实现这类需求,答案很简单,位存储。如 1bit 表示 0,1 两种状态,2bit 表示 00,01,10,11 四种状态,所以我们可以用一个 long 类型(64bit)/int 类型(32bit)存储多种状态,如下图:
位存储示例
但是每新建一个枚举类都需要自己操作 bit:
导致程序不易理解
容易出错,耗费精力
Hadoop hdfs 的实现中,也遇到类似的问题,它借助于 LongBitFormat.java 类封装了 bit 操作:
public class LongBitFormat implements Serializable {
private static final long serialVersionUID = 1L;
private final String NAME;
/** Bit offset */
private final int OFFSET;
/** Bit length */
private final int LENGTH;
/** Minimum value */
private final long MIN;
/** Maximum value */
private final long MAX;
/** Bit mask */
private final long MASK;
public LongBitFormat(String name, LongBitFormat previous, int length,
long min) {
NAME = name;
OFFSET = previous == null ? 0 : previous.OFFSET + previous.LENGTH;
LENGTH = length;
MIN = min;
MAX = ((-1L) >>> (64 - LENGTH));//移动的位数,右移64-Leng位,相当于保留length位
MASK = MAX << OFFSET;
}
/** Retrieve the value from the record. */
public long retrieve(long record) {
return (record & MASK) >>> OFFSET;
}
/** Combine the value to the record. */
public long combine(long value, long record) {
if (value < MIN) {
throw new IllegalArgumentException(
"Illagal value: " + NAME + " = " + value + " < MIN = " + MIN);
}
if (value > MAX) {
throw new IllegalArgumentException(
"Illagal value: " + NAME + " = " + value + " > MAX = " + MAX);
}
return (record & ~MASK) | (value << OFFSET);
}
public long getMin() {
return MIN;
}
}
当然,你也可以实现 IntBigFormat,ShortBitFormat 等
首先分析该类的构造方法:
NAME = name;
OFFSET = previous == null? 0: previous.OFFSET + previous.LENGTH;
LENGTH = length;
MIN = min;
MAX = ((-1L) >>> (64 - LENGTH));//移动的位数,右移64-Leng位,相当于保留length位
MASK = MAX << OFFSET;
字段:
NAME:状态名,可自定义
OFFSET:该状态在 long 字节中的偏移
LENGTH:用多少位存储该状态关联的数字
MIN:该状态关联的最小值
MAX:该状态关联的最大值
MASK:掩码,(OFFSET~OFFSET+LENGTH - 1) == 1
类方法:
retrieve(long record):获得该状态关联的数字
combine(long value, long record):将一个 value 加到 record 中,例如:将 value 值对应的枚举类存储在 32-40,则先将 32-40bits 清零,再将value 对应的二进制加入到 32-40
那么如何使用该类:
public class LongFormatTest {
static enum HeaderFormat {
PREFERRED_BLOCK_SIZE(null, 48, 1),
REPLICATION(PREFERRED_BLOCK_SIZE.BITS, 12, 1),
STORAGE_POLICY_ID(REPLICATION.BITS, 4, 0);
private final LongBitFormat BITS;
HeaderFormat(LongBitFormat previous, int length, long min) {
BITS = new LongBitFormat(name(), previous, length, min);
}
static short getReplication(long header) {
return (short) REPLICATION.BITS.retrieve(header);
}
static long getPreferredBlockSize(long header) {
return PREFERRED_BLOCK_SIZE.BITS.retrieve(header);
}
static byte getStoragePolicyID(long header) {
return (byte) STORAGE_POLICY_ID.BITS.retrieve(header);
}
static long toLong(long preferredBlockSize, long replication,
long storagePolicyID) {
long h = 0;
h = PREFERRED_BLOCK_SIZE.BITS.combine(preferredBlockSize, h);
h = REPLICATION.BITS.combine(replication, h);
h = STORAGE_POLICY_ID.BITS.combine(storagePolicyID, h);
return h;
}
}
public static void main(String[] args) {
long blockSize = 512;
long replication = 3L;
long storagePolicyID = 2L;
long combine = HeaderFormat.toLong(blockSize,replication,storagePolicyID);
System.out.println("block size: " + HeaderFormat.getPreferredBlockSize(combine));
System.out.println("replication: " + HeaderFormat.getReplication(combine));
System.out.println("storagePolicyID: " + HeaderFormat.getStoragePolicyID(combine));
}
}
tolong 方法的返回值也就是我们状态存储的封装