com.alibaba.toolkit.util.enumeration.IntegerFlagSet Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of antx-autoconfig Show documentation
The newest version!
/*
 * Copyright (c) 2002-2012 Alibaba Group Holding Limited.
 * All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *    http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package com.alibaba.toolkit.util.enumeration;

import java.text.MessageFormat;

/**
 * 代表整数类型的FlagSet.
 *
 * @author Michael Zhou
 * @version $Id: IntegerFlagSet.java,v 1.1 2003/07/03 07:26:21 baobao Exp $
 */
public abstract class IntegerFlagSet extends FlagSet {
    private static final long serialVersionUID = 397018141070555601L;
    private int value;

    /**
     * 创建一个整数位集.
     *
     * @param enumClass 位集所代表的内部枚举类
     */
    public IntegerFlagSet(Class enumClass) {
        super(enumClass);

        if (!IntegerEnum.class.isAssignableFrom(enumClass)) {
            throw new IllegalArgumentException(MessageFormat.format(EnumConstants.ILLEGAL_CLASS, new Object[] {
                    enumClass.getName(), IntegerEnum.class.getName() }));
        }
    }

    /**
     * 设置位集的值, 值的类型由getUnderlyingClass()确定.
     *
     * @param value 位集的值
     */
    @Override
    public void setValue(Object value) {
        checkImmutable();

        if (value == null) {
            throw new NullPointerException(EnumConstants.FLAT_SET_VALUE_IS_NULL);
        }

        this.value = ((Integer) value).intValue();
    }

    /**
     * 取得位集的值, 值的类型由getUnderlyingClass()确定.
     *
     * @return 位集的值
     */
    @Override
    public Object getValue() {
        return new Integer(value);
    }

    /**
     * 清除当前位集的全部位.
     *
     * @return 当前位集
     */
    @Override
    public Flags clear() {
        checkImmutable();
        value = 0;
        return this;
    }

    /**
     * 测试当前位集的指定位, 等效于and(flags) != 0.
     *
     * @param flags 标志位
     * @return 如果指定位被置位, 则返回true
     */
    @Override
    public boolean test(Flags flags) {
        return (value & getFlagsValue(flags)) != 0;
    }

    /**
     * 测试当前位集的指定位, 等效于and(flags) == flags.
     *
     * @param flags 标志位
     * @return 如果指定位被置位, 则返回true
     */
    public boolean testAll(Flags flags) {
        int testValue = getFlagsValue(flags);

        return (value & testValue) == testValue;
    }

    /**
     * 对当前位集执行逻辑与操作.
     *
     * @param flags 标志位
     * @return 当前位集
     */
    public Flags and(Flags flags) {
        IntegerFlagSet flagSet = (IntegerFlagSet) getFlagSetForModification();

        flagSet.value &= getFlagsValue(flags);
        return flagSet;
    }

    /**
     * 对当前位集执行逻辑非操作.
     *
     * @param flags 标志位
     * @return 当前位集
     */
    public Flags andNot(Flags flags) {
        IntegerFlagSet flagSet = (IntegerFlagSet) getFlagSetForModification();

        flagSet.value &= ~getFlagsValue(flags);
        return flagSet;
    }

    /**
     * 对当前位集执行逻辑或操作.
     *
     * @param flags 标志位
     * @return 当前位集
     */
    public Flags or(Flags flags) {
        IntegerFlagSet flagSet = (IntegerFlagSet) getFlagSetForModification();

        flagSet.value |= getFlagsValue(flags);
        return flagSet;
    }

    /**
     * 对当前位集执行逻辑异或操作.
     *
     * @param flags 标志位
     * @return 当前位集
     */
    public Flags xor(Flags flags) {
        IntegerFlagSet flagSet = (IntegerFlagSet) getFlagSetForModification();

        flagSet.value ^= getFlagsValue(flags);
        return flagSet;
    }

    /**
     * 取得位集的值.
     *
     * @param flags 位集
     * @return 位集的值
     */
    private int getFlagsValue(Flags flags) {
        checkFlags(flags);
        return flags instanceof IntegerEnum ? ((IntegerEnum) flags).intValue() : ((IntegerFlagSet) flags).value;
    }

    /**
     * 实现Number类, 取得整数值.
     *
     * @return 整数值
     */
    public int intValue() {
        return value;
    }

    /**
     * 实现Number类, 取得长整数值.
     *
     * @return 长整数值
     */
    public long longValue() {
        return value;
    }

    /**
     * 实现Number类, 取得double值.
     *
     * @return double值
     */
    public double doubleValue() {
        return value;
    }

    /**
     * 实现Number类, 取得float值.
     *
     * @return float值
     */
    public float floatValue() {
        return value;
    }

    /**
     * 实现IntegralNumber类, 转换成十六进制整数字符串.
     *
     * @return 十六进制整数字符串
     */
    public String toHexString() {
        return Integer.toHexString(value);
    }

    /**
     * 实现IntegralNumber类, 转换成八进制整数字符串.
     *
     * @return 八进制整数字符串
     */
    public String toOctalString() {
        return Integer.toOctalString(value);
    }

    /**
     * 实现IntegralNumber类, 转换成二进制整数字符串.
     *
     * @return 二进制整数字符串
     */
    public String toBinaryString() {
        return Integer.toBinaryString(value);
    }
}