/*******************************************************************************
 * Copyright (c) 2001, 2008 Oracle Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     Oracle Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jst.jsf.common.internal.managedobject;

/**
 * Represents an object that wishes to be managed by the framework.
 * 
 * Clients should not implement: sub-class AbstractManagedObject instead.
 *
 */
public interface IManagedObject 
{
    /**
     * Called by the object client to indicate is finished with the object. 
     * The object should save any data it may want between sessions, perhaps
     * by calling its checkpoint, before cleaning held resources and clearing
     * memory references.
     */
    void dispose();
    
    /**
     * Called to indicate that the object should remove all its data from both
     * memory and persistent storage.  This differentiates it from dispose in
     * that it signals that this object and its associated state will never
     * again be loaded for associated objects.
     */
    void destroy();
    
    /**
     * Indicates that an object should flush cached data and make durable
     * any data it might want between sessions.  It does not indicate a 
     * disposal of the object.
     */
    void checkpoint();
}