Package java.lang

Class RuntimePermission

  • All Implemented Interfaces:
    Serializable, Guard
    public final class RuntimePermission
extends BasicPermission
    This class is for runtime permissions. A RuntimePermission contains a name (also referred to as 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 runtime permission (see below). The naming convention follows the hierarchical property naming convention. Also, an asterisk may appear at the end of the name, following a ".", or by itself, to signify a wildcard match. For example: "loadLibrary.*" or "*" is valid, "*loadLibrary" or "a*b" is not valid.

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

    no_caption
    Permission Target Name What the Permission Allows Risks of Allowing this Permission
    setSecurityManager Setting of the security manager (possibly replacing an existing one) The security manager is a class that allows applications to implement a security policy. Granting the setSecurityManager permission would allow code to change which security manager is used by installing a different, possibly less restrictive security manager, thereby bypassing checks that would have been enforced by the original security manager.
    createSecurityManager Creation of a new security manager This gives code access to protected, sensitive methods that may disclose information about other classes or the execution stack.
    See Also:
    BasicPermission, Permission, SecurityManager, Serialized Form

    • Constructor Detail

      • RuntimePermission

        public RuntimePermission​(String name)
        Creates a new RuntimePermission with the specified name. The name is the symbolic name of the RuntimePermission, such as "exit", "setFactory", etc. An asterisk may appear at the end of the name, following a ".", or by itself, to signify a wildcard match.
        Parameters:
        name - the name of the RuntimePermission.
        Throws:
        NullPointerException - if name is null.
        IllegalArgumentException - if name is empty.

      • RuntimePermission

        public RuntimePermission​(String name,
                         @Nullable
                         String actions)
        Creates a new RuntimePermission object with the specified name. The name is the symbolic name of the RuntimePermission, and the actions String is currently unused and should be null.
        Parameters:
        name - the name of the RuntimePermission.
        actions - should be null.
        Throws:
        NullPointerException - if name is null.
        IllegalArgumentException - if name is empty.