--- 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 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: * * * @@ -141,53 +136,50 @@ *

* 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. *

* 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. *

* 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. *

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

Target arguments and their descriptions