java/awt/doc-files/FocusSpec.html has SecurityManager references

XMLWordPrintable

    • Type: CSR
    • Resolution: Approved
    • Priority: P4
    • 24
    • Component/s: client-libs
    • None
    • behavioral
    • minimal
    • doc-only
    • Java API
    • SE

      Summary

      Remove references to SecurityManager from the AWT Focus Specification.

      Problem

      JEP 486 disabled the Java SecurityManager and updated API specifications which described how they worked with a SecurityManager, but the AWT Focus Specification was overlooked, even though it is part of the javadoc, likely because it lives in an HTML file in the JDK sources

      Solution

      Update the Focus Specification to remove references to the SecurityManager

      Specification

      java/awt/doc-files/FocusSpec.html - test is deleted as shown below

      <pre> - First note that, because unhindered access to Components in other - contexts represents a security hole, the SecurityManager must grant a - new permission, "replaceKeyboardFocusManager", before client code is - permitted to replace the <code>KeyboardFocusManager</code> with an arbitrary - subclass instance. Because of the security check, replacing the - <code>KeyboardFocusManager</code> is not an option for applications that will be - deployed in environments with a SecurityManager, such as applets in a - browser. - <p> - Once installed, a <code>KeyboardFocusManager</code> instance has - access to the global focus state via a set of protected functions. - The <code>KeyboardFocusManager</code> can only call these functions - if it is installed in the calling thread's context. This ensures - that malicious code cannot circumvent the security check in - <code>KeyboardFocusManager.setCurrentFocusManager</code>. - A <code>KeyboardFocusManager</code> should always work with - the global focus state instead of the context focus state. - Failure to do this will lead to incorrect behavior of the - <code>KeyboardFocusManager</code>. </pre>

            Assignee:
            Philip Race
            Reporter:
            Philip Race
            Alexander Zuev, Alexander Zvegintsev
            Votes:
            0 Vote for this issue
            Watchers:
            1 Start watching this issue

              Created:
              Updated:
              Resolved: