OwbHotswapContext.java

package org.hotswap.agent.plugin.owb.beans;

import java.util.Set;

import javax.enterprise.context.ContextNotActiveException;
import javax.enterprise.context.spi.Contextual;


/**
 * The Interface OwbHotswapContext.
 *
 * @author alpapad@gmail.com
 */
public interface OwbHotswapContext {

    /**
     * <p>
     * Destroy the existing contextual instance. If there is no existing
     * instance, no action is taken.
     * </p>
     *
     * @definedIn AlterableContext
     * @param contextual the contextual type
     * @throws ContextNotActiveException if the context is not active
     */
    void destroy(Contextual<?> contextual);

    /**
     * Determines if the context object is active.
     *
     * If the context is active, then __redefine() is called.
     *
     * @definedIn Context
     * @return <tt>true</tt> if the context is active, or <tt>false</tt>
     *         otherwise.
     */
    boolean isActive();

    /**
     * Return an existing instance of a certain contextual type or a null value.
     *
     * @param <T> the type of the contextual type
     * @param contextual the contextual type
     * @return the contextual instance, or a null value
     *
     * @throws ContextNotActiveException if the context is not active
     */
    public <T> T get(Contextual<T> contextual);

    /**
     * Adds a bean to the set of beans to be reloaded.
     *
     * @param bean
     */
    void __addBeanToReloadOwb(Contextual<Object> bean);

    /**
     * Gets the OWB beans to be reloaded.
     *
     * @return the OWB beans to be reloaded
     */
    Set<Contextual<Object>> __getBeansToReloadOwb();

    /**
     * reload the owb beans which have changed
     */
    void __reloadOwb();

    /**
     * the original isActive() method (renamed)
     *
     * @return
     */
    boolean __isActiveOwb();
}