com.arjuna.webservices.util.Enumerated Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jbossxts Show documentation
Narayana: XTS jbossxts
The newest version!
/*
   Copyright The Narayana Authors
   SPDX-License-Identifier: Apache-2.0
 */

package com.arjuna.webservices.util;

import java.io.InvalidObjectException;
import java.io.ObjectStreamException;
import java.io.Serializable;
import java.util.Collections;
import java.util.HashMap;
import java.util.Map;



/**
 * Base class for enumerated types.
 * @author kevin
 */
public abstract class Enumerated implements Serializable
{
    /**
     * The enumerated value.
     */
    private final Object value ;
    
    /**
     * Construct the enumerated value.
     * @param value The string value of the enumeration.
     */
    protected Enumerated(final Object value)
    {
        this.value = value ;
    }
    
    /**
     * Compare the specified object to this one.
     * @param rhs The other object to compare.
     */
    public boolean equals(final Object rhs)
    {
        if (rhs == this)
        {
            return true ;
        }
        
        if ((rhs != null) && (rhs.getClass() == getClass()))
        {
            final Object rhsValue = ((Enumerated)rhs).value ;
            return (value == null ? rhsValue == null : value.equals(rhsValue)) ;
        }
        else
        {
            return false ;
        }
    }
    
    /**
     * Return a hash code for this enumerated entry.
     * @return the enumeration hash code.
     */
    public int hashCode()
    {
        return (value == null ? 0 : value.hashCode()) ;
    }
    
    /**
     * Get the key representation of this enumeration.
     * @return the key representation.
     */
    public Object getKey()
    {
        return value ;
    }
    
    /**
     * Get the string representation of this enumeration.
     * @return the string representation.
     */
    public String toString()
    {
        return (value == null ? "" : value.toString()) ;
    }
    
    /**
     * Resolve the value of an enumeration.
     * @param value The value of the enumeration.
     * @return The enumeration.
     * @throws InvalidEnumerationException if the enumeration value is invalid. 
     */
    protected abstract Enumerated resolveEnum(final Object value)
        throws InvalidEnumerationException ;
    
    /**
     * Replace any serialised version of this class with the same instance. 
     * @return The instance of the enumeration.
     * @throws ObjectStreamException
     */
    protected Object readResolve()
        throws ObjectStreamException
    {
        try
        {
            return resolveEnum(value) ;
        }
        catch (final InvalidEnumerationException iee)
        {
            throw new InvalidObjectException(iee.getMessage()) ;
        }
    }
    
    /**
     * Generate the map of enumeration values to enumerations.
     * @param enumerations The enumerations to configure.
     * @return The enumeration map.
     */
    protected static Map generateMap(final Enumerated[] enumerations)
    {
        final int numEnumerations = (enumerations == null ? 0 : enumerations.length) ;
        final Map result ;
        if (numEnumerations == 0)
        {
            result = Collections.EMPTY_MAP ;
        }
        else
        {
            result = new HashMap() ;
            for(int count = 0 ; count < numEnumerations ; count++)
            {
                final Enumerated enumeration = enumerations[count] ;
                result.put(enumeration.getKey(), enumeration) ;
            }
        }
        return result ;
    }
}