Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8340211

Remove references to Applet in core-libs/security APIs

XMLWordPrintable

    • Icon: CSR CSR
    • Resolution: Approved
    • Icon: P4 P4
    • 24
    • core-libs
    • None
    • behavioral
    • minimal
    • A doc only update which removes mentions of 'applet' within corelibs. As Applet has been deprecated since JDK9, there should be little to no dependence on its usage within the current JDK docs.
    • Java API
    • SE

      Summary

      Remove occurrences of the word 'applet' within the corelibs documentation.

      Problem

      Applet has been deprecated since JDK9. There are occurrences where the term is used interchangeably with 'application'. As Applet has been deprecated for some time, this term may confuse new Java learners, and is no longer useful in including for the JDK24+ documentation.

      Solution

      Simply remove the occurrences of 'applet' where applicable. This does not include wording that mentions 'applet' in a historical tone.

      Specification

      src/java.base/share/classes/java/lang/doc-files/threadPrimitiveDeprecation.html

      <h2>What should I use instead of <code>Thread.stop</code>?</h2>
       communication of the stop-request, the variable must be
       <code>volatile</code> (or access to the variable must be
       synchronized).</p>
      -<p>For example, suppose your applet contains the following
      +<p>For example, suppose your application contains the following
       <code>start</code>, <code>stop</code> and <code>run</code>
       methods:</p>
       <pre>
      ...
           }
       </pre>
       You can avoid the use of <code>Thread.stop</code> by replacing the
      -applet's <code>stop</code> and <code>run</code> methods with:
      +application's <code>stop</code> and <code>run</code> methods with:
       <pre>

      src/java.base/share/classes/java/net/HttpURLConnection.java

           /**
            * Sets whether HTTP redirects  (requests with response code 3xx) should
      -     * be automatically followed by this class.  True by default.  Applets
      -     * cannot change this variable.
      +     * be automatically followed by this class.  True by default.
            * <p>
            * If there is a security manager, this method first calls
            * the security manager's {@code checkSetFactory} method

      src/java.base/share/classes/java/nio/charset/spi/CharsetProvider.java

        * zero-argument constructor and some number of associated charset
        * implementation classes.  Charset providers may be installed in an instance
        * of the Java platform as extensions.  Providers may also be made available by
      - * adding them to the applet or application class path or by some other
      + * adding them to the application class path or by some other
        * platform-specific means.  Charset providers are looked up via the current
        * thread's {@link java.lang.Thread#getContextClassLoader() context class
        * loader}.

      src/java.base/share/classes/javax/crypto/CryptoPermission.java

        * The {@code CryptoPermission} class extends the
        * {@code java.security.Permission} class. A
        * {@code CryptoPermission} object is used to represent
      - * the ability of an application/applet to use certain
      + * the ability of an application to use certain
        * algorithms with certain key sizes and other
        * restrictions in certain environments.
        *

      src/java.base/share/classes/javax/crypto/ExemptionMechanism.java

        * of which are <i>key recovery</i>, <i>key weakening</i>, and
        * <i>key escrow</i>.
        *
      - * <p>Applications or applets that use an exemption mechanism may be granted
      + * <p>Applications that use an exemption mechanism may be granted
        * stronger encryption capabilities than those which don't.
        *
        * @since 1.4

      src/java.base/share/classes/javax/crypto/JceSecurityManager.java

        * <p>The JCE security manager is responsible for determining the maximum
      - * allowable cryptographic strength for a given applet/application, for a given
      + * allowable cryptographic strength for a given application, for a given
        * algorithm, by consulting the configured jurisdiction policy files and
      - * the cryptographic permissions bundled with the applet/application.
      + * the cryptographic permissions bundled with the application.

      ...

          /**
            * Returns the maximum allowable crypto strength for the given
      -     * applet/application, for the given algorithm.
      +     * application, for the given algorithm.
            */
           CryptoPermission getCryptoPermission(String theAlg) {

      src/java.base/share/classes/javax/net/SocketFactory.java

        * <P> Factory classes are specified by environment-specific configuration
        * mechanisms.  For example, the <em>getDefault</em> method could return
      - * a factory that was appropriate for a particular user or applet, and a
      + * a factory that was appropriate for a particular user, and a
        * framework could use a factory customized to its own purposes.
        *
        * @since 1.4

            jlu Justin Lu
            coffeys Sean Coffey
            Sean Coffey
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

              Created:
              Updated:
              Resolved: