/*
* ################################################################
*
* ProActive: The Java(TM) library for Parallel, Distributed,
* Concurrent computing with Security and Mobility
*
* Copyright (C) 1997-2007 INRIA/University of Nice-Sophia Antipolis
* Contact: proactive@objectweb.org
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
* USA
*
* Initial developer(s): The ProActive Team
* http://www.inria.fr/oasis/ProActive/contacts.html
* Contributor(s):
*
* ################################################################
*/
package org.objectweb.proactive;
/**
* <P>
* EndActive is related to the finalization of an active object.
* The finalization of the activity is done only once when the object
* stops to be active and becomes unusable.
* In case of a migration, an active object stops its activity
* before restarting on a new VM automatically without finalization.
* </P><P>
* An object implementing this interface can be invoked to perform the
* finalization work after the activity is ended. The object being
* reified as an active object can implement this interface or an external
* class can also be used.
* </P>
* <P>
* It is generally the role of the body of the active object to perform the
* call on the object implementing this interface.
* </P>
* <P>
* It is hard to ensure that the <code>endActivity</code> method will indeed
* be invoked at the end of the activity. <code>Error<code>, <code>Exception<code>,
* customized activity that never ends or sudden death of the JVM can prevents
* this method to be called by the body of the active object.
* </P>
*
* @author ProActive Team
* @version 1.0, 2002/06
* @since ProActive 0.9.3
*/
public interface EndActive extends Active {
/**
* Finalized the active object after the activity has been stopped.
* @param body the body of the active object being finalized.
*/
public void endActivity(Body body);
}
|