Eclipse Platform
Release 3.6

org.eclipse.equinox.p2.core
Class UIServices

java.lang.Object
  extended by org.eclipse.equinox.p2.core.UIServices

public abstract class UIServices
extends Object

Service used for prompting for user information from within lower level code. Implementors of this service are responsible for registering the service. It is possible that the UIServices service is requested very early in the startup sequence for an application. For example, applications that check for updates during startup will trigger the service lookup if a server requiring authentication is detected. For this reason, implementors of UIServices should ensure that the bundle providing the service is partitioned appropriately.

Since:
2.0

Nested Class Summary
static class UIServices.AuthenticationInfo
          Authentication information returned from an authentication prompt request.
static class UIServices.TrustInfo
          Trust information returned from a trust request
 
Field Summary
static String SERVICE_NAME
          Service name constant for the UI service.
 
Constructor Summary
UIServices()
           
 
Method Summary
abstract  UIServices.TrustInfo getTrustInfo(Certificate[][] untrustedChain, String[] unsignedDetail)
          Opens a UI prompt to capture information about trusted content.
abstract  UIServices.AuthenticationInfo getUsernamePassword(String location)
          Opens a UI prompt for authentication details
abstract  UIServices.AuthenticationInfo getUsernamePassword(String location, UIServices.AuthenticationInfo previousInfo)
          Opens a UI prompt for authentication details when cached or remembered details where not accepted.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SERVICE_NAME

public static final String SERVICE_NAME
Service name constant for the UI service.

Constructor Detail

UIServices

public UIServices()
Method Detail

getUsernamePassword

public abstract UIServices.AuthenticationInfo getUsernamePassword(String location)
Opens a UI prompt for authentication details

Parameters:
location - - the location requiring login details, may be null.
Returns:
The authentication result

getUsernamePassword

public abstract UIServices.AuthenticationInfo getUsernamePassword(String location,
                                                                  UIServices.AuthenticationInfo previousInfo)
Opens a UI prompt for authentication details when cached or remembered details where not accepted.

Parameters:
location - the location requiring login details
previousInfo - - the previously used authentication details - may not be null.
Returns:
The authentication result

getTrustInfo

public abstract UIServices.TrustInfo getTrustInfo(Certificate[][] untrustedChain,
                                                  String[] unsignedDetail)
Opens a UI prompt to capture information about trusted content.

Parameters:
untrustedChain - - an array of certificate chains for which there is no current trust anchor. May be null, which means there are no untrusted certificate chains.
unsignedDetail - - an array of strings, where each String describes content that is not signed. May be null, which means there is no unsigned content
Returns:
the TrustInfo that describes the user's choices for trusting certificates and unsigned content.

Eclipse Platform
Release 3.6

Guidelines for using Eclipse APIs.

Copyright (c) Eclipse contributors and others 2000, 2010. All rights reserved.