--- 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();