- * The {@code Applet} class must be the superclass of any - * applet that is to be embedded in a Web page or viewed by the Java - * Applet Viewer. The {@code Applet} class provides a standard - * interface between applets and their environment. - * - * @author Arthur van Hoff - * @author Chris Warth - * @since 1.0 + * The {@code Applet} class must be the superclass of any applet that is to be + * embedded in a Web page or viewed by the Java Applet Viewer. The + * {@code Applet} class provides a standard interface between applets and their + * environment. * + * @author Arthur van Hoff + * @author Chris Warth + * @since 1.0 * @deprecated The Applet API is deprecated, no replacement. */ @Deprecated(since = "9") @@ -65,13 +65,12 @@ /** * Constructs a new Applet. *
- * Note: Many methods in {@code java.applet.Applet} - * may be invoked by the applet only after the applet is - * fully constructed; applet should avoid calling methods - * in {@code java.applet.Applet} in the constructor. + * Note: Many methods in {@code java.applet.Applet} may be invoked by the + * applet only after the applet is fully constructed; applet should avoid + * calling methods in {@code java.applet.Applet} in the constructor. * - * @exception HeadlessException if GraphicsEnvironment.isHeadless() - * returns true. + * @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()} + * returns {@code true} * @see java.awt.GraphicsEnvironment#isHeadless * @since 1.4 */ @@ -83,26 +82,26 @@ /** * Applets can be serialized but the following conventions MUST be followed: - * - * Before Serialization: - * An applet must be in STOPPED state. - * - * After Deserialization: - * The applet will be restored in STOPPED state (and most clients will - * likely move it into RUNNING state). - * The stub field will be restored by the reader. + *
+ * Before Serialization: An applet must be in STOPPED state. + *
+ * After Deserialization: The applet will be restored in STOPPED state (and + * most clients will likely move it into RUNNING state). The stub field will + * be restored by the reader. */ private transient AppletStub stub; - /* version ID for serialized form. */ + /** + * Use serialVersionUID from JDK 1.0 for interoperability. + */ private static final long serialVersionUID = -5836846270535785031L; /** * Read an applet from an object input stream. - * @param s an object input stream. - * @exception HeadlessException if - * {@code GraphicsEnvironment.isHeadless()} returns - * {@code true} + * + * @param s an object input stream + * @throws HeadlessException if {@code GraphicsEnvironment.isHeadless()} + * returns {@code true} * @serial * @see java.awt.GraphicsEnvironment#isHeadless * @since 1.4 @@ -117,12 +116,13 @@ /** * Sets this applet's stub. This is done automatically by the system. - *
If there is a security manager, its {@code checkPermission} - * method is called with the - * {@code AWTPermission("setAppletStub")} - * permission if a stub has already been set. - * @param stub the new stub. - * @exception SecurityException if the caller cannot set the stub + *
+ * If there is a security manager, its {@code checkPermission} method is + * called with the {@code AWTPermission("setAppletStub")} permission if a + * stub has already been set. + * + * @param stub the new stub + * @throws SecurityException if the caller cannot set the stub */ public final void setStub(AppletStub stub) { if (this.stub != null) { @@ -135,14 +135,13 @@ } /** - * Determines if this applet is active. An applet is marked active - * just before its {@code start} method is called. It becomes - * inactive just before its {@code stop} method is called. - * - * @return {@code true} if the applet is active; - * {@code false} otherwise. - * @see java.applet.Applet#start() - * @see java.applet.Applet#stop() + * Determines if this applet is active. An applet is marked active just + * before its {@code start} method is called. It becomes inactive just + * before its {@code stop} method is called. + * + * @return {@code true} if the applet is active; {@code false} otherwise + * @see java.applet.Applet#start() + * @see java.applet.Applet#stop() */ public boolean isActive() { if (stub != null) { @@ -153,9 +152,8 @@ } /** - * Gets the URL of the document in which this applet is embedded. - * For example, suppose an applet is contained - * within the document: + * Gets the {@code URL} of the document in which this applet is embedded. + * For example, suppose an applet is contained within the document: *
* http://www.oracle.com/technetwork/java/index.html
*
* <applet code="Clock" width=50 height=50>
* <param name=Color value="blue">
* </applet>
* - * then a call to {@code getParameter("Color")} returns the - * value {@code "blue"}. + * then a call to {@code getParameter("Color")} returns the value + * {@code "blue"}. *
* The {@code name} argument is case insensitive. * - * @param name a parameter name. - * @return the value of the named parameter, - * or {@code null} if not set. + * @param name a parameter name + * @return the value of the named parameter, or {@code null} if not set */ - public String getParameter(String name) { - return stub.getParameter(name); - } + public String getParameter(String name) { + return stub.getParameter(name); + } /** - * Determines this applet's context, which allows the applet to - * query and affect the environment in which it runs. + * Determines this applet's context, which allows the applet to query and + * affect the environment in which it runs. *
- * This environment of an applet represents the document that - * contains the applet. + * This environment of an applet represents the document that contains the + * applet. * - * @return the applet's context. + * @return the applet's context */ public AppletContext getAppletContext() { return stub.getAppletContext(); @@ -221,8 +219,8 @@ /** * Requests that this applet be resized. * - * @param width the new requested width for the applet. - * @param height the new requested height for the applet. + * @param width the new requested width for the applet + * @param height the new requested height for the applet */ @SuppressWarnings("deprecation") public void resize(int width, int height) { @@ -238,7 +236,7 @@ /** * Requests that this applet be resized. * - * @param d an object giving the new width and height. + * @param d an object giving the new width and height */ @SuppressWarnings("deprecation") public void resize(Dimension d) { @@ -252,8 +250,8 @@ * override this method to return {@code true}. * * @return {@code true} - * @since 1.7 * @see java.awt.Container#isValidateRoot + * @since 1.7 */ @Override public boolean isValidateRoot() { @@ -261,51 +259,50 @@ } /** - * Requests that the argument string be displayed in the - * "status window". Many browsers and applet viewers - * provide such a window, where the application can inform users of - * its current state. + * Requests that the argument string be displayed in the "status window". + * Many browsers and applet viewers provide such a window, where the + * application can inform users of its current state. * - * @param msg a string to display in the status window. + * @param msg a string to display in the status window */ public void showStatus(String msg) { getAppletContext().showStatus(msg); } /** - * Returns an {@code Image} object that can then be painted on - * the screen. The {@code url} that is passed as an argument - * must specify an absolute URL. - *
- * This method always returns immediately, whether or not the image - * exists. When this applet attempts to draw the image on the screen, - * the data will be loaded. The graphics primitives that draw the - * image will incrementally paint on the screen. - * - * @param url an absolute URL giving the location of the image. - * @return the image at the specified URL. - * @see java.awt.Image + * Returns an {@code Image} object that can then be painted on the screen. + * The {@code url} that is passed as an argument must specify an absolute + * {@code URL}. + *
+ * This method always returns immediately, whether or not the image exists. + * When this applet attempts to draw the image on the screen, the data will + * be loaded. The graphics primitives that draw the image will incrementally + * paint on the screen. + * + * @param url an absolute {@code URL} giving the location of the image + * @return the image at the specified {@code URL} + * @see java.awt.Image */ public Image getImage(URL url) { return getAppletContext().getImage(url); } /** - * Returns an {@code Image} object that can then be painted on - * the screen. The {@code url} argument must specify an absolute - * URL. The {@code name} argument is a specifier that is - * relative to the {@code url} argument. - *
- * This method always returns immediately, whether or not the image - * exists. When this applet attempts to draw the image on the screen, - * the data will be loaded. The graphics primitives that draw the - * image will incrementally paint on the screen. - * - * @param url an absolute URL giving the base location of the image. - * @param name the location of the image, relative to the - * {@code url} argument. - * @return the image at the specified URL. - * @see java.awt.Image + * Returns an {@code Image} object that can then be painted on the screen. + * The {@code url} argument must specify an absolute {@code URL}. The + * {@code name} argument is a specifier that is relative to the {@code url} + * argument. + *
+ * This method always returns immediately, whether or not the image exists. + * When this applet attempts to draw the image on the screen, the data will + * be loaded. The graphics primitives that draw the image will incrementally + * paint on the screen. + * + * @param url an absolute URL giving the base location of the image + * @param name the location of the image, relative to the {@code url} + * argument + * @return the image at the specified {@code URL} + * @see java.awt.Image */ public Image getImage(URL url, String name) { try { @@ -316,47 +313,46 @@ } /** - * Get an audio clip from the given URL. - * - * @param url points to the audio clip - * @return the audio clip at the specified URL. + * Get an audio clip from the given {@code URL}. * - * @since 1.2 + * @param url points to the audio clip + * @return the audio clip at the specified {@code URL} + * @since 1.2 */ public static final AudioClip newAudioClip(URL url) { return JavaSoundAudioClip.create(url); } /** - * Returns the {@code AudioClip} object specified by the - * {@code URL} argument. + * Returns the {@code AudioClip} object specified by the {@code URL} + * argument. *
- * This method always returns immediately, whether or not the audio - * clip exists. When this applet attempts to play the audio clip, the - * data will be loaded. - * - * @param url an absolute URL giving the location of the audio clip. - * @return the audio clip at the specified URL. - * @see java.applet.AudioClip + * This method always returns immediately, whether or not the audio clip + * exists. When this applet attempts to play the audio clip, the data will + * be loaded. + * + * @param url an absolute {@code URL} giving the location of the audio clip + * @return the audio clip at the specified {@code URL} + * @see java.applet.AudioClip */ public AudioClip getAudioClip(URL url) { return getAppletContext().getAudioClip(url); } /** - * Returns the {@code AudioClip} object specified by the - * {@code URL} and {@code name} arguments. + * Returns the {@code AudioClip} object specified by the {@code URL} and + * {@code name} arguments. *
- * This method always returns immediately, whether or not the audio - * clip exists. When this applet attempts to play the audio clip, the - * data will be loaded. - * - * @param url an absolute URL giving the base location of the - * audio clip. - * @param name the location of the audio clip, relative to the - * {@code url} argument. - * @return the audio clip at the specified URL. - * @see java.applet.AudioClip + * This method always returns immediately, whether or not the audio clip + * exists. When this applet attempts to play the audio clip, the data will + * be loaded. + * + * @param url an absolute {@code URL} giving the base location of the audio + * clip + * @param name the location of the audio clip, relative to the {@code url} + * argument + * @return the audio clip at the specified {@code URL} + * @see java.applet.AudioClip */ public AudioClip getAudioClip(URL url, String name) { try { @@ -367,45 +363,43 @@ } /** - * Returns information about this applet. An applet should override - * this method to return a {@code String} containing information - * about the author, version, and copyright of the applet. + * Returns information about this applet. An applet should override this + * method to return a {@code String} containing information about the + * author, version, and copyright of the applet. *
- * The implementation of this method provided by the - * {@code Applet} class returns {@code null}. + * The implementation of this method provided by the {@code Applet} class + * returns {@code null}. * - * @return a string containing information about the author, version, and - * copyright of the applet. + * @return a string containing information about the author, version, and + * copyright of the applet */ public String getAppletInfo() { return null; } /** - * Gets the locale of the applet. It allows the applet - * to maintain its own locale separated from the locale - * of the browser or appletviewer. - * - * @return the locale of the applet; if no locale has - * been set, the default locale is returned. - * @since 1.1 + * Gets the locale of the applet. It allows the applet to maintain its own + * locale separated from the locale of the browser or appletviewer. + * + * @return the locale of the applet; if no locale has been set, the default + * locale is returned + * @since 1.1 */ public Locale getLocale() { - Locale locale = super.getLocale(); - if (locale == null) { - return Locale.getDefault(); - } - return locale; + Locale locale = super.getLocale(); + if (locale == null) { + return Locale.getDefault(); + } + return locale; } /** - * Returns information about the parameters that are understood by - * this applet. An applet should override this method to return an - * array of {@code Strings} describing these parameters. + * Returns information about the parameters that are understood by this + * applet. An applet should override this method to return an array of + * {@code Strings} describing these parameters. *
- * Each element of the array should be a set of three - * {@code Strings} containing the name, the type, and a - * description. For example: + * Each element of the array should be a set of three {@code Strings} + * containing the name, the type, and a description. For example: *
* String pinfo[][] = {
* {"fps", "1-10", "frames per second"},
@@ -414,20 +408,20 @@
* };
* - * The implementation of this method provided by the - * {@code Applet} class returns {@code null}. + * The implementation of this method provided by the {@code Applet} class + * returns {@code null}. * - * @return an array describing the parameters this applet looks for. + * @return an array describing the parameters this applet looks for */ public String[][] getParameterInfo() { return null; } /** - * Plays the audio clip at the specified absolute URL. Nothing + * Plays the audio clip at the specified absolute {@code URL}. Nothing * happens if the audio clip cannot be found. * - * @param url an absolute URL giving the location of the audio clip. + * @param url an absolute {@code URL} giving the location of the audio clip */ public void play(URL url) { AudioClip clip = getAudioClip(url); @@ -437,13 +431,13 @@ } /** - * Plays the audio clip given the URL and a specifier that is - * relative to it. Nothing happens if the audio clip cannot be found. + * Plays the audio clip given the URL and a specifier that is relative to + * it. Nothing happens if the audio clip cannot be found. * - * @param url an absolute URL giving the base location of the - * audio clip. - * @param name the location of the audio clip, relative to the - * {@code url} argument. + * @param url an absolute {@code URL} giving the base location of the audio + * clip + * @param name the location of the audio clip, relative to the {@code url} + * argument */ public void play(URL url, String name) { AudioClip clip = getAudioClip(url, name); @@ -453,98 +447,92 @@ } /** - * Called by the browser or applet viewer to inform - * this applet that it has been loaded into the system. It is always - * called before the first time that the {@code start} method is - * called. - *
- * A subclass of {@code Applet} should override this method if - * it has initialization to perform. For example, an applet with - * threads would use the {@code init} method to create the - * threads and the {@code destroy} method to kill them. - *
- * The implementation of this method provided by the - * {@code Applet} class does nothing. - * - * @see java.applet.Applet#destroy() - * @see java.applet.Applet#start() - * @see java.applet.Applet#stop() + * Called by the browser or applet viewer to inform this applet that it has + * been loaded into the system. It is always called before the first time + * that the {@code start} method is called. + *
+ * A subclass of {@code Applet} should override this method if it has + * initialization to perform. For example, an applet with threads would use + * the {@code init} method to create the threads and the {@code destroy} + * method to kill them. + *
+ * The implementation of this method provided by the {@code Applet} class + * does nothing. + * + * @see java.applet.Applet#destroy() + * @see java.applet.Applet#start() + * @see java.applet.Applet#stop() */ public void init() { } /** - * Called by the browser or applet viewer to inform - * this applet that it should start its execution. It is called after - * the {@code init} method and each time the applet is revisited - * in a Web page. - *
- * A subclass of {@code Applet} should override this method if - * it has any operation that it wants to perform each time the Web - * page containing it is visited. For example, an applet with - * animation might want to use the {@code start} method to - * resume animation, and the {@code stop} method to suspend the - * animation. - *
- * Note: some methods, such as {@code getLocationOnScreen}, can only - * provide meaningful results if the applet is showing. Because - * {@code isShowing} returns {@code false} when the applet's - * {@code start} is first called, methods requiring - * {@code isShowing} to return {@code true} should be called from - * a {@code ComponentListener}. - *
- * The implementation of this method provided by the - * {@code Applet} class does nothing. - * - * @see java.applet.Applet#destroy() - * @see java.applet.Applet#init() - * @see java.applet.Applet#stop() - * @see java.awt.Component#isShowing() - * @see java.awt.event.ComponentListener#componentShown(java.awt.event.ComponentEvent) + * Called by the browser or applet viewer to inform this applet that it + * should start its execution. It is called after the {@code init} method + * and each time the applet is revisited in a Web page. + *
+ * A subclass of {@code Applet} should override this method if it has any + * operation that it wants to perform each time the Web page containing it + * is visited. For example, an applet with animation might want to use the + * {@code start} method to resume animation, and the {@code stop} method to + * suspend the animation. + *
+ * Note: some methods, such as {@code getLocationOnScreen}, can only provide + * meaningful results if the applet is showing. Because {@code isShowing} + * returns {@code false} when the applet's {@code start} is first called, + * methods requiring {@code isShowing} to return {@code true} should be + * called from a {@code ComponentListener}. + *
+ * The implementation of this method provided by the {@code Applet} class + * does nothing. + * + * @see java.applet.Applet#destroy() + * @see java.applet.Applet#init() + * @see java.applet.Applet#stop() + * @see java.awt.Component#isShowing() + * @see java.awt.event.ComponentListener#componentShown(ComponentEvent) */ public void start() { } /** - * Called by the browser or applet viewer to inform - * this applet that it should stop its execution. It is called when - * the Web page that contains this applet has been replaced by - * another page, and also just before the applet is to be destroyed. - *
- * A subclass of {@code Applet} should override this method if - * it has any operation that it wants to perform each time the Web - * page containing it is no longer visible. For example, an applet - * with animation might want to use the {@code start} method to - * resume animation, and the {@code stop} method to suspend the - * animation. + * Called by the browser or applet viewer to inform this applet that it + * should stop its execution. It is called when the Web page that contains + * this applet has been replaced by another page, and also just before the + * applet is to be destroyed. + *
+ * A subclass of {@code Applet} should override this method if it has any + * operation that it wants to perform each time the Web page containing it + * is no longer visible. For example, an applet with animation might want to + * use the {@code start} method to resume animation, and the {@code stop} + * method to suspend the animation. *
- * The implementation of this method provided by the - * {@code Applet} class does nothing. + * The implementation of this method provided by the {@code Applet} class + * does nothing. * - * @see java.applet.Applet#destroy() - * @see java.applet.Applet#init() + * @see java.applet.Applet#destroy() + * @see java.applet.Applet#init() */ public void stop() { } /** - * Called by the browser or applet viewer to inform - * this applet that it is being reclaimed and that it should destroy - * any resources that it has allocated. The {@code stop} method - * will always be called before {@code destroy}. - *
- * A subclass of {@code Applet} should override this method if - * it has any operation that it wants to perform before it is - * destroyed. For example, an applet with threads would use the - * {@code init} method to create the threads and the - * {@code destroy} method to kill them. - *
- * The implementation of this method provided by the - * {@code Applet} class does nothing. - * - * @see java.applet.Applet#init() - * @see java.applet.Applet#start() - * @see java.applet.Applet#stop() + * Called by the browser or applet viewer to inform this applet that it is + * being reclaimed and that it should destroy any resources that it has + * allocated. The {@code stop} method will always be called before + * {@code destroy}. + *
+ * A subclass of {@code Applet} should override this method if it has any + * operation that it wants to perform before it is destroyed. For example, + * an applet with threads would use the {@code init} method to create the + * threads and the {@code destroy} method to kill them. + *
+ * The implementation of this method provided by the {@code Applet} class + * does nothing. + * + * @see java.applet.Applet#init() + * @see java.applet.Applet#start() + * @see java.applet.Applet#stop() */ public void destroy() { } @@ -553,16 +541,19 @@ // Accessibility support // + /** + * The accessible context associated with this {@code Applet}. + */ AccessibleContext accessibleContext = null; /** - * Gets the AccessibleContext associated with this Applet. - * For applets, the AccessibleContext takes the form of an - * AccessibleApplet. - * A new AccessibleApplet instance is created if necessary. + * Gets the {@code AccessibleContext} associated with this {@code Applet}. + * For applets, the {@code AccessibleContext} takes the form of an + * {@code AccessibleApplet}. A new {@code AccessibleApplet} instance is + * created if necessary. * - * @return an AccessibleApplet that serves as the - * AccessibleContext of this Applet + * @return an {@code AccessibleApplet} that serves as the + * {@code AccessibleContext} of this {@code Applet} * @since 1.3 */ public AccessibleContext getAccessibleContext() { @@ -573,20 +564,24 @@ } /** - * This class implements accessibility support for the - * {@code Applet} class. It provides an implementation of the - * Java Accessibility API appropriate to applet user-interface elements. + * This class implements accessibility support for the {@code Applet} class. + * It provides an implementation of the Java Accessibility API appropriate + * to applet user-interface elements. + * * @since 1.3 */ protected class AccessibleApplet extends AccessibleAWTPanel { + /** + * Use serialVersionUID from JDK 1.3 for interoperability. + */ private static final long serialVersionUID = 8127374778187708896L; /** * Get the role of this object. * - * @return an instance of AccessibleRole describing the role of the - * object + * @return an instance of {@code AccessibleRole} describing the role of + * the object */ public AccessibleRole getAccessibleRole() { return AccessibleRole.FRAME; @@ -595,8 +590,8 @@ /** * Get the state of this object. * - * @return an instance of AccessibleStateSet containing the current - * state set of the object + * @return an instance of {@code AccessibleStateSet} containing the + * current state set of the object * @see AccessibleState */ public AccessibleStateSet getAccessibleStateSet() { @@ -604,6 +599,5 @@ states.add(AccessibleState.ACTIVE); return states; } - } } --- old/src/java.desktop/share/classes/java/applet/AppletContext.java 2018-10-07 22:25:14.000000000 -0700 +++ new/src/java.desktop/share/classes/java/applet/AppletContext.java 2018-10-07 22:25:13.000000000 -0700 @@ -33,81 +33,76 @@ import java.util.Iterator; /** - * This interface corresponds to an applet's environment: the - * document containing the applet and the other applets in the same - * document. + * This interface corresponds to an applet's environment: the document + * containing the applet and the other applets in the same document. *
- * The methods in this interface can be used by an applet to obtain - * information about its environment. - * - * @author Arthur van Hoff - * @since 1.0 + * The methods in this interface can be used by an applet to obtain information + * about its environment. * + * @author Arthur van Hoff + * @since 1.0 * @deprecated The Applet API is deprecated, no replacement. */ @Deprecated(since = "9") public interface AppletContext { + /** * Creates an audio clip. * - * @param url an absolute URL giving the location of the audio clip. - * @return the audio clip at the specified URL. + * @param url an absolute {@code URL} giving the location of the audio clip + * @return the audio clip at the specified {@code URL} */ AudioClip getAudioClip(URL url); /** - * Returns an {@code Image} object that can then be painted on - * the screen. The {@code url} argument that is - * passed as an argument must specify an absolute URL. + * Returns an {@code Image} object that can then be painted on the screen. + * The {@code url} argument that is passed as an argument must specify an + * absolute {@code URL}. *
- * This method always returns immediately, whether or not the image - * exists. When the applet attempts to draw the image on the screen, - * the data will be loaded. The graphics primitives that draw the - * image will incrementally paint on the screen. - * - * @param url an absolute URL giving the location of the image. - * @return the image at the specified URL. - * @see java.awt.Image + * This method always returns immediately, whether or not the image exists. + * When the applet attempts to draw the image on the screen, the data will + * be loaded. The graphics primitives that draw the image will incrementally + * paint on the screen. + * + * @param url an absolute {@code URL} giving the location of the image + * @return the image at the specified {@code URL} + * @see java.awt.Image */ Image getImage(URL url); /** - * Finds and returns the applet in the document represented by this - * applet context with the given name. The name can be set in the - * HTML tag by setting the {@code name} attribute. - * - * @param name an applet name. - * @return the applet with the given name, or {@code null} if - * not found. + * Finds and returns the applet in the document represented by this applet + * context with the given name. The name can be set in the HTML tag by + * setting the {@code name} attribute. + * + * @param name an applet name + * @return the applet with the given name, or {@code null} if not found */ Applet getApplet(String name); /** - * Finds all the applets in the document represented by this applet - * context. + * Finds all the applets in the document represented by this applet context. * - * @return an enumeration of all applets in the document represented by - * this applet context. + * @return an enumeration of all applets in the document represented by this + * applet context */ Enumeration