--- a/src/java.desktop/share/classes/java/applet/Applet.java Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/Applet.java Tue Nov 13 16:35:58 2018 -0800
@@ -31,6 +31,7 @@
import java.awt.HeadlessException;
import java.awt.Image;
import java.awt.Panel;
+import java.awt.event.ComponentEvent;
import java.io.IOException;
import java.io.ObjectInputStream;
import java.net.MalformedURLException;
@@ -45,18 +46,17 @@
import com.sun.media.sound.JavaSoundAudioClip;
/**
- * An applet is a small program that is intended not to be run on
- * its own, but rather to be embedded inside another application.
+ * An applet is a small program that is intended not to be run on its own, but
+ * rather to be embedded inside another application.
* <p>
- * 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.
+ * 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
- *
+ * @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.
* <p>
- * 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.
+ * <p>
+ * Before Serialization: An applet must be in STOPPED state.
+ * <p>
+ * 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.
- * <p>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
+ * <p>
+ * 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.
+ * 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()
+ * @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:
* <blockquote><pre>
* http://www.oracle.com/technetwork/java/index.html
* </pre></blockquote>
@@ -164,55 +162,55 @@
* http://www.oracle.com/technetwork/java/index.html
* </pre></blockquote>
*
- * @return the {@link java.net.URL} of the document that contains this
- * applet.
- * @see java.applet.Applet#getCodeBase()
+ * @return the {@link java.net.URL} of the document that contains this
+ * applet
+ * @see java.applet.Applet#getCodeBase()
*/
public URL getDocumentBase() {
return stub.getDocumentBase();
}
/**
- * Gets the base URL. This is the URL of the directory which contains this applet.
+ * Gets the base {@code URL}. This is the {@code URL} of the directory which
+ * contains this applet.
*
- * @return the base {@link java.net.URL} of
- * the directory which contains this applet.
- * @see java.applet.Applet#getDocumentBase()
+ * @return the base {@link java.net.URL} of the directory which contains
+ * this applet
+ * @see java.applet.Applet#getDocumentBase()
*/
public URL getCodeBase() {
return stub.getCodeBase();
}
/**
- * Returns the value of the named parameter in the HTML tag. For
- * example, if this applet is specified as
+ * Returns the value of the named parameter in the HTML tag. For example, if
+ * this applet is specified as
* <blockquote><pre>
* <applet code="Clock" width=50 height=50>
* <param name=Color value="blue">
* </applet>
* </pre></blockquote>
* <p>
- * then a call to {@code getParameter("Color")} returns the
- * value {@code "blue"}.
+ * then a call to {@code getParameter("Color")} returns the value
+ * {@code "blue"}.
* <p>
* 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.
* <p>
- * 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}
+ * @see java.awt.Container#isValidateRoot
* @since 1.7
- * @see java.awt.Container#isValidateRoot
*/
@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.
+ * 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}.
* <p>
- * 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.
+ * 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
+ * @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.
+ * 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.
* <p>
- * 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.
+ * 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
+ * @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.
+ * Get an audio clip from the given {@code URL}.
*
- * @param url points to the audio clip
- * @return the audio clip at the specified 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.
* <p>
- * 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.
+ * 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
+ * @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.
* <p>
- * 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.
+ * 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
+ * @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.
* <p>
- * 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.
+ * 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
+ * @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
+ * strings describing these parameters.
* <p>
- * 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 strings containing the
+ * name, the type, and a description. For example:
* <blockquote><pre>
* String pinfo[][] = {
* {"fps", "1-10", "frames per second"},
@@ -414,20 +408,20 @@
* };
* </pre></blockquote>
* <p>
- * 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
+ * Plays the audio clip given the {@code 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.
+ * 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.
* <p>
- * 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.
+ * 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.
* <p>
- * 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#start()
- * @see java.applet.Applet#stop()
+ * @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.
+ * 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.
* <p>
- * 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.
+ * 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.
* <p>
- * 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}.
+ * 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}.
* <p>
- * 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#stop()
- * @see java.awt.Component#isShowing()
- * @see java.awt.event.ComponentListener#componentShown(java.awt.event.ComponentEvent)
+ * @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.
+ * 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.
* <p>
- * 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.
+ * 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.
* <p>
- * 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}.
+ * 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}.
* <p>
- * 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.
+ * 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.
* <p>
- * 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#init()
- * @see java.applet.Applet#start()
- * @see java.applet.Applet#stop()
+ * @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;
}
-
}
}
--- a/src/java.desktop/share/classes/java/applet/AppletContext.java Tue Nov 13 07:11:50 2018 -0800
+++ b/src/java.desktop/share/classes/java/applet/AppletContext.java Tue Nov 13 16:35:58 2018 -0800
@@ -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.
* <p>
- * The methods in this interface can be used by an applet to obtain
- * information about its environment.
+ * The methods in this interface can be used by an applet to obtain information
+ * about its environment.
*
- * @author Arthur van Hoff
- * @since 1.0
- *
+ * @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}.
* <p>
- * 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.
+ * 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
+ * @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.
+ * 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.
+ * @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<Applet> getApplets();
/**
- * Requests that the browser or applet viewer show the Web page
- * indicated by the {@code url} argument. The browser or
- * applet viewer determines which window or frame to display the
- * Web page. This method may be ignored by applet contexts that
- * are not browsers.
+ * Requests that the browser or applet viewer show the Web page indicated by
+ * the {@code url} argument. The browser or applet viewer determines which
+ * window or frame to display the Web page. This method may be ignored by
+ * applet contexts that are not browsers.
*
- * @param url an absolute URL giving the location of the document.
+ * @param url an absolute {@code URL} giving the location of the document
*/
void showDocument(URL url);
/**
- * Requests that the browser or applet viewer show the Web page
- * indicated by the {@code url} argument. The
- * {@code target} argument indicates in which HTML frame the
- * document is to be displayed.
- * The target argument is interpreted as follows:
+ * Requests that the browser or applet viewer show the Web page indicated by
+ * the {@code url} argument. The {@code target} argument indicates in which
+ * HTML frame the document is to be displayed. The target argument is
+ * interpreted as follows:
*
* <table class="striped">
* <caption>Target arguments and their descriptions</caption>
@@ -141,53 +136,50 @@
* <p>
* An applet viewer or browser is free to ignore {@code showDocument}.
*
- * @param url an absolute URL giving the location of the document.
- * @param target a {@code String} indicating where to display
- * the page.
+ * @param url an absolute {@code URL} giving the location of the document
+ * @param target a {@code String} indicating where to display the page
*/
public void showDocument(URL url, String target);
/**
- * 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 status a string to display in the status window.
+ * @param status a string to display in the status window
*/
void showStatus(String status);
/**
- * Associates the specified stream with the specified key in this
- * applet context. If the applet context previously contained a mapping
- * for this key, the old value is replaced.
+ * Associates the specified stream with the specified key in this applet
+ * context. If the applet context previously contained a mapping for this
+ * key, the old value is replaced.
* <p>
* For security reasons, mapping of streams and keys exists for each
- * codebase. In other words, applet from one codebase cannot access
- * the streams created by an applet from a different codebase
+ * codebase. In other words, applet from one codebase cannot access the
+ * streams created by an applet from a different codebase
*
- * @param key key with which the specified value is to be associated.
- * @param stream stream to be associated with the specified key. If this
- * parameter is {@code null}, the specified key is removed
- * in this applet context.
- * @throws IOException if the stream size exceeds a certain
- * size limit. Size limit is decided by the implementor of this
- * interface.
+ * @param key key with which the specified value is to be associated
+ * @param stream stream to be associated with the specified key. If this
+ * parameter is {@code null}, the specified key is removed in this
+ * applet context.
+ * @throws IOException if the stream size exceeds a certain size limit. Size
+ * limit is decided by the implementor of this interface.
* @since 1.4
*/
- public void setStream(String key, InputStream stream)throws IOException;
+ public void setStream(String key, InputStream stream) throws IOException;
/**
* Returns the stream to which specified key is associated within this
- * applet context. Returns {@code null} if the applet context contains
- * no stream for this key.
+ * applet context. Returns {@code null} if the applet context contains no
+ * stream for this key.
* <p>
* For security reasons, mapping of streams and keys exists for each
- * codebase. In other words, applet from one codebase cannot access
- * the streams created by an applet from a different codebase
+ * codebase. In other words, applet from one codebase cannot access the
+ * streams created by an applet from a different codebase.
*
+ * @param key key whose associated stream is to be returned
* @return the stream to which this applet context maps the key
- * @param key key whose associated stream is to be returned.
* @since 1.4
*/
public InputStream getStream(String key);
@@ -196,11 +188,11 @@
* Finds all the keys of the streams in this applet context.
* <p>
* For security reasons, mapping of streams and keys exists for each
- * codebase. In other words, applet from one codebase cannot access
- * the streams created by an applet from a different codebase
+ * codebase. In other words, applet from one codebase cannot access the
+ * streams created by an applet from a different codebase.
*
- * @return an Iterator of all the names of the streams in this applet
- * context.
+ * @return an {@code Iterator} of all the names of the streams in this
+ * applet context
* @since 1.4
*/
public Iterator<String> getStreamKeys();