01: /*
02: * Copyright 1999-2001,2004 The Apache Software Foundation.
03: *
04: * Licensed under the Apache License, Version 2.0 (the "License");
05: * you may not use this file except in compliance with the License.
06: * You may obtain a copy of the License at
07: *
08: * http://www.apache.org/licenses/LICENSE-2.0
09: *
10: * Unless required by applicable law or agreed to in writing, software
11: * distributed under the License is distributed on an "AS IS" BASIS,
12: * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13: * See the License for the specific language governing permissions and
14: * limitations under the License.
15: */
16:
17: package org.apache.catalina;
18:
19: /**
20: * <p>Decoupling interface which specifies that an implementing class is
21: * associated with at most one <strong>Container</strong> instance.</p>
22: *
23: * @author Craig R. McClanahan
24: * @author Peter Donald
25: * @version $Revision: 1.2 $ $Date: 2004/02/27 14:58:38 $
26: */
27:
28: public interface Contained {
29:
30: //-------------------------------------------------------------- Properties
31:
32: /**
33: * Return the <code>Container</code> with which this instance is associated
34: * (if any); otherwise return <code>null</code>.
35: */
36: public Container getContainer();
37:
38: /**
39: * Set the <code>Container</code> with which this instance is associated.
40: *
41: * @param container The Container instance with which this instance is to
42: * be associated, or <code>null</code> to disassociate this instance
43: * from any Container
44: */
45: public void setContainer(Container container);
46:
47: }
|