Nebula LoginDialog

< Back to Nebula Main Page

Introduction

This component is very simple and present a simple and flexible dialog box to authentify a user. It is inspired by the SwingX component.

Usage

The first thing to do is to create a Verifier by instancing a object that implements the interface LoginDialogVerifier.

This interface contains one method :

public void authenticate(final String login, final String password) throws Exception

In the implementation of this method, you put the code to authenticate the user (LDAP, DB, ...). If the couple login/password is incorrect or if something goes wrong (Database lost for example), the method throws an Exception. The detail message contains the description of the error :

final LoginDialogVerifier verifier = new LoginDialogVerifier() {

Then, you create a LoginDialog object, you inject the verifier and you call the open() methods that returns true if the couple login/password is correct, or false if the user pressed on the cancel button.

final LoginDialog dialog = new LoginDialog();
dialog.setVerifier(verifier);

final boolean result = dialog.open();
if (result) {
     System.out.println("Login confirmed : " + dialog.getLogin());
} else {
     System.out.println("User canceled !");
}

You can customize the dialog box by setting the following properties :

• image. By default, the header image is a blue wave with a title
• description. A text located between the header and the login text box
• login, password
• autorizedLogin, if you want to limit the login to a set of users. In this case, the login text box will be replaced by a combo.
• displayRememberPassword. If true, a checkbox "Remember my password" is displayed. In this case, you can get/set the checkbox by manipulating the property rememberPassword.

Example

An example called LoginDialogSnippet.java is available in the plugin org.eclipse.nebula.widgets.opal.logindialog.snippets.

This example is also available here : LoginDialogSnippet.java