BasicWrapper.java

package com.bergerkiller.bukkit.common.wrappers;

import com.bergerkiller.bukkit.common.utils.CommonUtil;

/**
 * A basic implementation for a wrapper class
 */
public class BasicWrapper {
	protected Object handle;

	/**
	 * Sets the internal handle for this wrapper<br>
	 * This handle can not be null
	 * 
	 * @param handle to set to
	 */
	protected void setHandle(Object handle) {
		if (handle == null) {
			throw new IllegalArgumentException("The handle can not be null");
		}
		this.handle = handle;
	}

	/**
	 * Gets the internal handle from this wrapper
	 * 
	 * @return handle
	 */
	public Object getHandle() {
		return handle;
	}

	/**
	 * Gets the internal handle from this wrapper and casts it to the type specified.
	 * If no handle is contained or the conversion failed, NULL is returned instead.
	 * 
	 * @param type to cast to
	 * @return the handle cast to the type, or NULL if no handle or casting fails
	 */
	public <T> T getHandle(Class<T> type) {
		return CommonUtil.tryCast(handle, type);
	}

	@Override
	public String toString() {
		return handle.toString();
	}

	@Override
	public boolean equals(Object o) {
		if (o instanceof BasicWrapper) {
			o = ((BasicWrapper) o).getHandle();
		}
		return handle != null && handle.equals(o);
	}
}