PlotSquared/src/main/java/com/intellectualcrafters/plot/flag/Flag.java

////////////////////////////////////////////////////////////////////////////////////////////////////
// PlotSquared - A plot manager and world generator for the Bukkit API                             /
// Copyright (c) 2014 IntellectualSites/IntellectualCrafters                                       /
//                                                                                                 /
// This program is free software; you can redistribute it and/or modify                            /
// it under the terms of the GNU General Public License as published by                            /
// the Free Software Foundation; either version 3 of the License, or                               /
// (at your option) any later version.                                                             /
//                                                                                                 /
// This program is distributed in the hope that it will be useful,                                 /
// but WITHOUT ANY WARRANTY; without even the implied warranty of                                  /
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                   /
// GNU General Public License for more details.                                                    /
//                                                                                                 /
// You should have received a copy of the GNU General Public License                               /
// along with this program; if not, write to the Free Software Foundation,                         /
// Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA                               /
//                                                                                                 /
// You can contact us via: support@intellectualsites.com                                           /
////////////////////////////////////////////////////////////////////////////////////////////////////
package com.intellectualcrafters.plot.flag;

import com.intellectualcrafters.plot.util.StringMan;

public class Flag {
    private AbstractFlag key;
    private Object value;
    
    /**
     * Flag object used to store basic information for a Plot. Flags are a key/value pair. For a flag to be usable by a
     * player, you need to register it with PlotSquared.
     *
     * @param key   AbstractFlag
     * @param value Value must be alphanumerical (can have spaces) and be <= 48 characters
     *
     * @throws IllegalArgumentException if you provide inadequate inputs
     */
    public Flag(final AbstractFlag key, final String value) {
        if (!StringMan.isAsciiPrintable(value)) {
            throw new IllegalArgumentException("Flag must be ascii");
        }
        if (value.length() > 128) {
            throw new IllegalArgumentException("Value must be <= 128 characters");
        }
        this.key = key;
        this.value = key.parseValueRaw(value);
        if (this.value == null) {
            throw new IllegalArgumentException(key.getValueDesc() + " (" + value + ")");
        }
    }
    
    public void setKey(final AbstractFlag key) {
        this.key = key;
        if (value instanceof String) {
            value = key.parseValueRaw((String) value);
        }
    }
    
    /**
     * Warning: Unchecked
     */
    public Flag(final AbstractFlag key, final Object value) {
        this.key = key;
        this.value = value;
    }
    
    /**
     * Get the AbstractFlag used in creating the flag
     *
     * @return AbstractFlag
     */
    public AbstractFlag getAbstractFlag() {
        return key;
    }
    
    /**
     * Get the key for the AbstractFlag
     *
     * @return String
     */
    public String getKey() {
        return key.getKey();
    }
    
    /**
     * Get the value
     *
     * @return String
     */
    public Object getValue() {
        return value;
    }
    
    public String getValueString() {
        return key.toString(value);
    }
    
    @Override
    public String toString() {
        if (value.equals("")) {
            return key.getKey();
        }
        return key + ":" + getValueString();
    }
    
    @Override
    public boolean equals(final Object obj) {
        if (this == obj) {
            return true;
        }
        if (obj == null) {
            return false;
        }
        if (getClass() != obj.getClass()) {
            return false;
        }
        final Flag other = (Flag) obj;
        return (key.getKey().equals(other.key.getKey()) && value.equals(other.value));
    }
    
    @Override
    public int hashCode() {
        return key.getKey().hashCode();
    }
}