uk.ac.starlink.util.WrapUtils Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of stil Show documentation

Starlink Tables Infrastructure Library

There is a newer version: 4.3

package uk.ac.starlink.util;

/**
 * Utilities relating to the {@link Wrapper} class.
 *
 * @author   Mark Taylor
 * @since    3 Apr 2008
 */
public class WrapUtils {

    /**
     * Private constructor prevents instantiation.
     */
    private WrapUtils() {
    }

    /**
     * Returns the object on which a given object is based.
     * If obj is a {@link Wrapper}, it is unwrapped as far
     * as possible and the base object is returned.
     * Otherwise obj itself is returned.
     *
     * @param  obj  test object
     * @return   ultimate base object of obj
     */
    public static Object getWrapped( Object obj ) {
        while ( obj instanceof Wrapper ) {
            obj = ((Wrapper) obj).getBase();
        }
        return obj;
    }

    /**
     * Attempts to return an object of a given class on which a given
     * object is based.
     * An object is unwrapped (see {@link Wrapper#getBase}) until an
     * object of class clazz is found, at which point it
     * is returned.  If no clazz object can be found,
     * null is returned.
     *
     * @param  obj   test object
     * @return   object within the wrapping hierarchy of class
     *           clazz, or null
     */
    public static Object getWrapped( Object obj, Class clazz ) {
        while ( true ) {
            if ( clazz.isAssignableFrom( obj.getClass() ) ) {
                return obj;
            }
            else if ( obj instanceof Wrapper ) {
                obj = ((Wrapper) obj).getBase();
            }
            else {
                return null;
            }
        }
    }
}