com.alee.utils.general.Pair Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of weblaf-core Show documentation
Core components for WebLaf
There is a newer version: 2.2.1
/*
 * This file is part of WebLookAndFeel library.
 *
 * WebLookAndFeel library 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.
 *
 * WebLookAndFeel library 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 WebLookAndFeel library.  If not, see .
 */

package com.alee.utils.general;


import com.alee.utils.MergeUtils;
import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamAsAttribute;

import java.io.Serializable;

/**
 * This class represents single name-value pair.
 *
 * @author Mikle Garin
 */

@XStreamAlias ("Pair")
public class Pair implements Serializable, Cloneable
{
    /**
     * Key of this {@code Pair}.
     */
    @XStreamAsAttribute
    public K key;

    /**
     * Value of this this {@code Pair}.
     */
    @XStreamAsAttribute
    public V value;

    /**
     * Constructs a new pair with {@code null} key and value.
     */
    public Pair ()
    {
        this ( null, null );
    }

    /**
     * Constructs a new pair with {@code null} value.
     *
     * @param key The key for this pair
     */
    public Pair ( final K key )
    {
        this ( key, null );
    }

    /**
     * Constructs a new pair
     *
     * @param key   The key for this pair
     * @param value The value to use for this pair
     */
    public Pair ( final K key, final V value )
    {
        super ();
        this.key = key;
        this.value = value;
    }

    /**
     * Gets the key for this pair.
     *
     * @return key for this pair
     */
    public K getKey ()
    {
        return key;
    }

    /**
     * Sets the key for this pair.
     *
     * @param key new key for this pair
     */
    public void setKey ( final K key )
    {
        this.key = key;
    }

    /**
     * Gets the value for this pair.
     *
     * @return value for this pair
     */
    public V getValue ()
    {
        return value;
    }

    /**
     * Sets the value for this pair.
     *
     * @param value new value for this pair
     */
    public void setValue ( final V value )
    {
        this.value = value;
    }

    @Override
    public String toString ()
    {
        return key + "=" + value;
    }

    @Override
    public int hashCode ()
    {
        return ( key != null ? key.hashCode () * 13 : 0 ) + ( value != null ? value.hashCode () : 0 );
    }

    @Override
    public boolean equals ( final Object o )
    {
        if ( this == o )
        {
            return true;
        }
        if ( o instanceof Pair )
        {
            final Pair pair = ( Pair ) o;
            return !( key != null ? !key.equals ( pair.key ) : pair.key != null ) &&
                    !( value != null ? !value.equals ( pair.value ) : pair.value != null );
        }
        return false;
    }

    @Override
    public Pair clone ()
    {
        return MergeUtils.cloneByFieldsSafely ( this );
    }
}