Java Platform 1.2
Beta 4

Class java.awt.AWTPermission

java.lang.Object
  |
  +--java.security.Permission
        |
        +--java.security.BasicPermission
              |
              +--java.awt.AWTPermission

public final class AWTPermission
extends BasicPermission
This class is for AWT permissions. An AWTPermission contains a target name but no actions list; you either have the named permission or you don't.

The target name is the name of the AWT permission (see below). The naming convention follows the hierarchical property naming convention. Also, an asterisk could be used to represent all AWT permissions.

The following table lists all the possible AWTPermission target names, and for each provides a description of what the permission allows and a discussion of the risks of granting code the permission.

Permission Target Name What the Permission Allows Risks of Allowing this Permission
accessClipboard Posting and retrieval of information to and from the AWT clipboard This would allow malfeasant code to share potentially sensitive or confidential information.
accessEventQueue Access to the AWT event queue After retrieving the AWT event queue, malicious code may peek at and even remove existing events from the system, as well as post bogus events which may purposefully cause the application or applet to misbehave in an insecure manner.
showWindowWithoutWarningBanner Display of a window without also displaying a banner warning that the window was created by an applet Without this warning, an applet may pop up windows without the user knowing that they belong to an applet. Since users may make security-sensitive decisions based on whether or not the window belongs to an applet (entering a username and password into a dialog box, for example), disabling this warning banner may allow applets to trick the user into entering such information.

See Also:
BasicPermission, Permission, Permissions, PermissionCollection, SecurityManager, Serialized Form

Constructor Summary
AWTPermission(String name, String actions)
          Creates a new AWTPermission object with the specified name.
AWTPermission(String name)
          Creates a new AWTPermission with the specified name.
 
Methods inherited from class java.security.BasicPermission
equals , getActions , hashCode , implies , newPermissionCollection
 
Methods inherited from class java.security.Permission
checkGuard , getName , toString
 
Methods inherited from class java.lang.Object
clone , finalize , getClass , notify , notifyAll , wait , wait , wait
 

Constructor Detail

AWTPermission

public AWTPermission(String name)
Creates a new AWTPermission with the specified name. The name is the symbolic name of the AWTPermission, such as "topLevelWindow", "systemClipboard", etc. An asterisk may be used to indicate all AWT permissions.
Parameters:
name - the name of the AWTPermission.

AWTPermission

public AWTPermission(String name,
                     String actions)
Creates a new AWTPermission object with the specified name. The name is the symbolic name of the AWTPermission, and the actions String is currently unused and should be null. This constructor exists for use by the Policy object to instantiate new Permission objects.
Parameters:
name - the name of the AWTPermission.
actions - should be null.

Java Platform 1.2
Beta 4

Submit a bug or feature
Submit comments/suggestions about new javadoc look
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1993-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.
This documentation was generated with a post-Beta4 version of Javadoc.