1 /* 2 * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. 3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4 * 5 * This code is free software; you can redistribute it and/or modify it 6 * under the terms of the GNU General Public License version 2 only, as 7 * published by the Free Software Foundation. Oracle designates this 8 * particular file as subject to the "Classpath" exception as provided 9 * by Oracle in the LICENSE file that accompanied this code. 10 * 11 * This code is distributed in the hope that it will be useful, but WITHOUT 12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or 13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License 14 * version 2 for more details (a copy is included in the LICENSE file that 15 * accompanied this code). 16 * 17 * You should have received a copy of the GNU General Public License version 18 * 2 along with this work; if not, write to the Free Software Foundation, 19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. 20 * 21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA 22 * or visit www.oracle.com if you need additional information or have any 23 * questions. 24 */ 25 26 package java.beans; 27 28 import java.applet.Applet; 29 30 import java.beans.beancontext.BeanContext; 31 32 /** 33 * <p> 34 * This interface is designed to work in collusion with java.beans.Beans.instantiate. 35 * The interface is intended to provide mechanism to allow the proper 36 * initialization of JavaBeans that are also Applets, during their 37 * instantiation by java.beans.Beans.instantiate(). 38 * </p> 39 * 40 * @see java.beans.Beans#instantiate 41 * 42 * @since 1.2 43 * 44 */ 45 46 47 @SuppressWarnings("deprecation") 48 public interface AppletInitializer { 49 50 /** 51 * <p> 52 * If passed to the appropriate variant of java.beans.Beans.instantiate 53 * this method will be called in order to associate the newly instantiated 54 * Applet (JavaBean) with its AppletContext, AppletStub, and Container. 55 * </p> 56 * <p> 57 * Conformant implementations shall: 58 * <ol> 59 * <li> Associate the newly instantiated Applet with the appropriate 60 * AppletContext. 61 * 62 * <li> Instantiate an AppletStub() and associate that AppletStub with 63 * the Applet via an invocation of setStub(). 64 * 65 * <li> If BeanContext parameter is null, then it shall associate the 66 * Applet with its appropriate Container by adding that Applet to its 67 * Container via an invocation of add(). If the BeanContext parameter is 68 * non-null, then it is the responsibility of the BeanContext to associate 69 * the Applet with its Container during the subsequent invocation of its 70 * addChildren() method. 71 * </ol> 72 * 73 * @param newAppletBean The newly instantiated JavaBean 74 * @param bCtxt The BeanContext intended for this Applet, or 75 * null. 76 */ 77 78 void initialize(Applet newAppletBean, BeanContext bCtxt); 79 80 /** 81 * <p> 82 * Activate, and/or mark Applet active. Implementors of this interface 83 * shall mark this Applet as active, and optionally invoke its start() 84 * method. 85 * </p> 86 * 87 * @param newApplet The newly instantiated JavaBean 88 */ 89 90 void activate(Applet newApplet); 91 }