Toolkit.java (getSystemEventQueue): Call SecurityManager if one is installed.

2003-09-11  Sascha Brawer  <brawer@dandelis.ch>

	* java/awt/Toolkit.java (getSystemEventQueue): Call SecurityManager
	if one is installed. Improve Javadoc.
	(getSystemEventQueueImpl): Improve Javadoc.

From-SVN: r71308
This commit is contained in:
Sascha Brawer 2003-09-11 18:45:10 +02:00 committed by Tom Tromey
parent c203255aba
commit 130de16070
2 changed files with 46 additions and 5 deletions

View File

@ -1,3 +1,9 @@
2003-09-11 Sascha Brawer <brawer@dandelis.ch>
* java/awt/Toolkit.java (getSystemEventQueue): Call SecurityManager
if one is installed. Improve Javadoc.
(getSystemEventQueueImpl): Improve Javadoc.
2003-09-11 Tom Tromey <tromey@redhat.com>
* java/io/natFilePosix.cc (getCanonicalPath): Handle case where

View File

@ -803,23 +803,58 @@ public abstract class Toolkit
return props.getProperty(key, def);
}
/**
* Returns the event queue for the applet. Despite the word "System"
* in the name of this method, there is no guarantee that the same queue
* is shared system wide.
* Returns the event queue that is suitable for the calling context.
*
* @return The event queue for this applet (or application)
* <p>Despite the word System in the name of this
* method, a toolkit may provide different event queues for each
* applet. There is no guarantee that the same queue is shared
* system-wide.
*
* <p>The implementation first checks whether a
* SecurityManager has been installed. If so, its {@link
* java.lang.SecurityManager#checkAwtEventQueueAccess()} method gets
* called. The security manager will throw a SecurityException if it
* does not grant the permission to access the event queue.
*
* <p>Next, the call is delegated to {@link
* #getSystemEventQueueImpl()}.
*
* @return The event queue for this applet (or application).
*
* @throws SecurityException if a security manager has been
* installed, and it does not grant the permission to access the
* event queue.
*/
public final EventQueue getSystemEventQueue()
{
SecurityManager sm;
sm = System.getSecurityManager();
if (sm != null)
sm.checkAwtEventQueueAccess();
return getSystemEventQueueImpl();
}
/**
* // FIXME: What does this do?
* Returns the event queue that is suitable for the calling context.
*
* <p>Despite the word ,System, in the name of this
* method, a toolkit may provide different event queues for each
* applet. There is no guarantee that the same queue is shared
* system-wide.
*
* <p>No security checks are performed, which is why this method
* may only be called by Toolkits.
*
* @see #getSystemEventQueue()
*/
protected abstract EventQueue getSystemEventQueueImpl();
/**
* @since 1.3
*/