org.eclipse.swt.browser

Interface AuthenticationListener

All Superinterfaces:

EventListener, SWTEventListener

public interface AuthenticationListener
extends SWTEventListener

This listener interface may be implemented in order to receive an AuthenticationEvent notification when the Browser encounters a page that requires authentication.

Since:

3.5

See Also:

Browser.addAuthenticationListener(AuthenticationListener), Browser.removeAuthenticationListener(AuthenticationListener)

Method Summary

Modifier and Type	Method and Description
void	authenticate(AuthenticationEvent event) This method is called when a page is navigated to that requires authentication.

Method Detail

authenticate

void authenticate(AuthenticationEvent event)

This method is called when a page is navigated to that requires authentication.

Setting both the event's user and password fields causes these values to be used as credentials for authentication. Leaving one or both of these fields as null indicates that credentials are not known, so an authentication prompter should be shown to the user. Otherwise, setting the event's doit field to false cancels the authentication challenge, and the page will not be loaded.

The following fields in the AuthenticationEvent apply:

• (in) widget the Browser that is attempting to show the page that requires authentication
• (in) location the location issuing the authentication challenge
• (in/out) doit can be set to false to cancel the authentication challenge
• (out) user the user name to authenticate with
• (out) password the password to authenticate with

Parameters:

event - the AuthenticationEvent that can be used to either supply authentication credentials, defer credential input to an authentication prompter, or cancel an authentication challenge.