1 /* 2 * JBoss, Home of Professional Open Source 3 * Copyright 2005, JBoss Inc., and individual contributors as indicated 4 * by the @authors tag. See the copyright.txt in the distribution for a 5 * full listing of individual contributors. 6 * 7 * This is free software; you can redistribute it and/or modify it 8 * under the terms of the GNU Lesser General Public License as 9 * published by the Free Software Foundation; either version 2.1 of 10 * the License, or (at your option) any later version. 11 * 12 * This software is distributed in the hope that it will be useful, 13 * but WITHOUT ANY WARRANTY; without even the implied warranty of 14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 15 * Lesser General Public License for more details. 16 * 17 * You should have received a copy of the GNU Lesser General Public 18 * License along with this software; if not, write to the Free 19 * Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 20 * 02110-1301 USA, or see the FSF site: http://www.fsf.org. 21 */ 22 package org.jboss.kernel.spi.dependency; 23 24 /** 25 * A KernelControllerContextAware. 26 * 27 * @author <a HREF="adrian@jboss.com">Adrian Brock</a> 28 * @version $Revision: 37459 $ 29 */ 30 public interface KernelControllerContextAware 31 { 32 /** 33 * Set the controller context.<p> 34 * 35 * This is invoked after construction with the controller context.<p> 36 * 37 * WARNING: This protocol is subject to change with the classadapter implementation. 38 * 39 * @todo integrate better with aop and instance classadapter such that 40 * describe can process this without the instance actually existing. 41 * Use case: creating jmx/jsr77 hollow proxy for on-demand beans before they are instantiated. 42 * @param context the context 43 * @throws Exception for any error 44 */ 45 void setKernelControllerContext(KernelControllerContext context) throws Exception; 46 47 /** 48 * Unset the controller context.<p> 49 * 50 * This is before uninstallation with null.<p> 51 * 52 * WARNING: This protocol is subject to change with the classadapter implementation. 53 * 54 * @todo integrate better with aop and instance classadapter such that 55 * describe can process this without the instance actually existing. 56 * Use case: creating jmx/jsr77 hollow proxy for on-demand beans before they are instantiated. 57 * @param context the context 58 * @throws Exception for any error 59 */ 60 void unsetKernelControllerContext(KernelControllerContext context) throws Exception; 61 } 62