SQLPermission

Class Overview

The permission for which the SecurityManager will check when code that is running in an applet calls the DriverManager.setLogWriter method or the DriverManager.setLogStream (deprecated) method. If there is no SQLPermission object, these methods throw a java.lang.SecurityException as a runtime exception.

A SQLPermission object contains a name (also referred to as a "target name") but no actions list; there is either a named permission or there is not. The target name is the name of the permission (see below). The naming convention follows the hierarchical property naming convention. In addition, 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, but *loadLibrary or a*b is not valid.

The following table lists all the possible SQLPermission target names. Currently, the only name allowed is setLog. The table gives 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
setLog	Setting of the logging stream	This is a dangerous permission to grant. The contents of the log may contain usernames and passwords, SQL statements, and SQL data.

The person running an applet decides what permissions to allow and will run the Policy Tool to create an SQLPermission in a policy file. A programmer does not use a constructor directly to create an instance of SQLPermission but rather uses a tool.

Summary

Public Constructors
	SQLPermission(String name) Creates a new SQLPermission object with the specified name.
	SQLPermission(String name, String actions) Creates a new SQLPermission object with the specified name.

[Expand] Inherited Methods
From class java.security.BasicPermission boolean equals(Object obj) Checks two BasicPermission objects for equality. String getActions() Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions for a BasicPermission. int hashCode() Returns the hash code value for this object. boolean implies(Permission p) Checks if the specified permission is "implied" by this object. PermissionCollection newPermissionCollection() Returns a new PermissionCollection object for storing BasicPermission objects.
From class java.security.Permission void checkGuard(Object object) Implements the guard interface for a permission. abstract boolean equals(Object obj) Checks two Permission objects for equality. abstract String getActions() Returns the actions as a String. final String getName() Returns the name of this Permission. abstract int hashCode() Returns the hash code value for this Permission object. abstract boolean implies(Permission permission) Checks if the specified permission's actions are "implied by" this object's actions. PermissionCollection newPermissionCollection() Returns an empty PermissionCollection for a given Permission object, or null if one is not defined. String toString() Returns a string describing this Permission.
From class java.lang.Object Object clone() Creates and returns a copy of this object. boolean equals(Object obj) Indicates whether some other object is "equal to" this one. void finalize() Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. final Class<?> getClass() Returns the runtime class of this Object. int hashCode() Returns a hash code value for the object. final void notify() Wakes up a single thread that is waiting on this object's monitor. final void notifyAll() Wakes up all threads that are waiting on this object's monitor. String toString() Returns a string representation of the object. final void wait() Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object. final void wait(long timeout, int nanos) Causes the current thread to wait until another thread invokes the notify() method or the notifyAll() method for this object, or some other thread interrupts the current thread, or a certain amount of real time has elapsed. final void wait(long timeout) Causes the current thread to wait until either another thread invokes the notify() method or the notifyAll() method for this object, or a specified amount of time has elapsed.
From interface java.security.Guard abstract void checkGuard(Object object) Determines whether or not to allow access to the guarded object object.