KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > objectweb > fractal > julia > control > lifecycle > ContentLifeCycleController


1 /***
2  * Julia: France Telecom's implementation of the Fractal API
3  * Copyright (C) 2001-2002 France Telecom R&D
4  *
5  * This library is free software; you can redistribute it and/or
6  * modify it under the terms of the GNU Lesser General Public
7  * License as published by the Free Software Foundation; either
8  * version 2 of the License, or (at your option) any later version.
9  *
10  * This library is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  * Lesser General Public License for more details.
14  *
15  * You should have received a copy of the GNU Lesser General Public
16  * License along with this library; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
18  *
19  * Contact: Eric.Bruneton@rd.francetelecom.com
20  *
21  * Author: Eric Bruneton
22  */
23
24 package org.objectweb.fractal.julia.control.lifecycle;
25
26 import org.objectweb.fractal.api.control.IllegalLifeCycleException;
27
28 /**
29  * A component interface to control the life cycle of the content of container
30  * components. This interface is useful when a container and its encapsulated
31  * "user" component are merged into a single class. Indeed, in this case, the
32  * container class is generated as a sub class of the user component class, and
33  * may therefore override the life cycle management methods that may be provided
34  * by the user component (because both classes may implement the same {@link
35  * org.objectweb.fractal.api.control.LifeCycleController} interface). In order
36  * to still be able to call the user component life cycle management methods
37  * from outside the component, two new methods are generated in the container
38  * class, that just calls the corresponding methods in the user component class
39  * (i.e., in the super class) with the <tt>super</tt> keyword.
40  */
41
42 public interface ContentLifeCycleController {
43
44   /**
45    * Calls the {@link
46    * org.objectweb.fractal.api.control.LifeCycleController#startFc startFc}
47    * method on the component encapsulated in this container.
48    *
49    * @throws IllegalLifeCycleException if a problem occurs.
50    */
51
52   void startFcContent () throws IllegalLifeCycleException;
53
54   /**
55    * Calls the {@link
56    * org.objectweb.fractal.api.control.LifeCycleController#stopFc stopFc}
57    * method on the component encapsulated in this container.
58    *
59    * @throws IllegalLifeCycleException if a problem occurs.
60    */
61
62   void stopFcContent () throws IllegalLifeCycleException;
63 }
64
Popular Tags