java.lang

Class RuntimePermission

java.lang.Object

java.security.Permission

java.security.BasicPermission

java.lang.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 Summary

Constructors

Constructor and Description
RuntimePermission(String name) Creates a new RuntimePermission with the specified name.
RuntimePermission(String name, String actions) Creates a new RuntimePermission object with the specified name.

Method Summary

Methods inherited from class java.security.BasicPermission

equals, getActions, hashCode, implies

Methods inherited from class java.security.Permission

getName, toString

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

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.