|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.rim.device.api.userauthenticator.SecurityUIManager
public final class SecurityUIManager
This manager class provides simple user-interface services to user authenticators.
Typically, applications are not allowed to interact with the device's user in any way while the device is locked. User authenticators may have a compelling reason to do so, however; this class provides a way for user authenticators to perform interactions with the device's user from the lock screen.
Note: a user authenticator need only make use of a security UI
manager if it does not implement the PasswordFrameworkProvider
interface. If it does implement that interface, then it will piggy-back on
the security framework's standard device password interaction with the
user. However, the user authenticator can always make use of the security ui
manager provided by the security framework if it wants additional interaction
with the device's user.
The security framework provides the user authenticator with a security UI manager object through its invocation of several user authenticator methods. The security UI manager reference passed in is only usable during the execution of those methods; as soon as those methods return, the security framework renders the manager object unusable (thus, there's no point for the authenticator to hold on to a reference to a security UI manager: they are intended only for temporary use).
UserAuthenticator.initializeImpl(net.rim.device.api.userauthenticator.SecurityUIManager, net.rim.device.api.util.DataBuffer, net.rim.device.api.util.DataBuffer, net.rim.device.api.userauthenticator.UserAuthenticatorContextObject)
UserAuthenticator.verifyPolicySettingsImpl(net.rim.device.api.userauthenticator.SecurityUIManager, net.rim.device.api.util.DataBuffer, net.rim.device.api.util.DataBuffer, net.rim.device.api.userauthenticator.UserAuthenticatorContextObject)
verifyPolicySettings
.
UserAuthenticator.authenticateImpl(net.rim.device.api.userauthenticator.SecurityUIManager, net.rim.device.api.util.DataBuffer, net.rim.device.api.userauthenticator.UserAuthenticatorContextObject)
Field Summary | ||
---|---|---|
|
static int |
CANCEL
Indication of the dialog is closing because it was canceled |
|
static int |
CLOSE
Indication that the dialog closed in the normal way |
Method Summary | ||
---|---|---|
|
void |
dismissDialog(int reason)
Dismiss the dialog created by SecurityUIManager.showDialog(net.rim.device.api.ui.Manager, boolean) . |
|
int |
showDialog(Manager manager,
boolean cancelAllowed)
Present a dialog to the user. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static int CLOSE
public static int CANCEL
Method Detail |
---|
public int showDialog(Manager manager, boolean cancelAllowed)
To use this method, the invoker may provide any dialog for this manager to show to the user.
manager
- UI manager containing the fields and layout for the dialog
to show the user.cancelAllowed
- True if the user can close this dialog by
Canceling; otherwise, false.
SecurityUIManager.CLOSE
if the dialog terminated by a simple
close; otherwise, SecurityUIManager.CANCEL
, if the user closes the dialog by
Canceling it.
IllegalStateException
- when trying to use a disabled SecurityUIManager.
IllegalArgumentException
- when the manager passed in is null.public void dismissDialog(int reason)
SecurityUIManager.showDialog(net.rim.device.api.ui.Manager, boolean)
.
reason
- Close reason value (SecurityUIManager.CLOSE
or SecurityUIManager.CANCEL
).
IllegalStateException
- when trying to use a disabled SecurityUIManager.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.