1 /** 2 * 3 * Copyright 2003-2004 The Apache Software Foundation 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * 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 implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 18 package org.apache.geronimo.core.service; 19 20 21 /** 22 * Implements the JSR 77 state model 23 * 24 * 25 * @version $Rev: 46019 $ $Date: 2004-09-14 02:56:06 -0700 (Tue, 14 Sep 2004) $ 26 */ 27 public interface Component 28 { 29 /** 30 * Gets the container to which this component belongs. 31 * @return the container for which invocations will be intercepted 32 */ 33 Container getContainer(); 34 35 /** 36 * Sets the container which ownes this component. 37 * The contianer can only be set before create() or to null after the destroy(). 38 * 39 * @param container which owns this component 40 * @throws java.lang.IllegalStateException if this component is not in the not-created or destroyed state 41 * @throws java.lang.IllegalArgumentException if this comonent has not been created and the container 42 * parameter is null, or the component has been destroyed and the container parameter is NOT null 43 */ 44 void setContainer(Container container) throws IllegalStateException, IllegalArgumentException; 45 46 } 47