KickJava   Java API By Example, From Geeks To Geeks.

Java > Open Source Codes > org > apache > avalon > fortress > impl > handler > ReleasableComponent


1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one or more
3  * contributor license agreements. See the NOTICE file distributed with
4  * this work for additional information regarding copyright ownership.
5  * The ASF licenses this file to You under the Apache License, Version 2.0
6  * (the "License"); you may not use this file except in compliance with
7  * the License. You may obtain a copy of the License at
8  *
9  * http://www.apache.org/licenses/LICENSE-2.0
10  *
11  * Unless required by applicable law or agreed to in writing, software
12  * distributed under the License is distributed on an "AS IS" BASIS,
13  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
14  * implied.
15  *
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  */
19
20 package org.apache.avalon.fortress.impl.handler;
21
22 /**
23  * This interfaces marks a component that can be released without
24  * using the corresponding ComponentHandler.
25  *
26  * @author <a HREF="mailto:dev@avalon.apache.org">Avalon Development Team</a>
27  * @version CVS $Revision: 1.2 $ $Date: 2004/03/13 17:57:59 $
28  * @since 1.2
29  */
30 public interface ReleasableComponent
31 {
32     /**
33      * Initialize this component with the corresponding component handler.
34      * @param handler The component handler used to put this component back again
35      * @throws ServiceException If the component is already initialized or the
36      * handler is missing
37      */
38     void initialize(ComponentHandler handler)
39     throws Exception JavaDoc;
40
41     /**
42      * Puts the reference back in the ComponentHandler according to the
43      * policy of the implementation.
44      * In fact this calls the put method on the ComponentHandler
45      */
46     void releaseOnComponentHandler( );
47 }
48
Popular Tags