uk.ac.soton.ecs.iam.grid.comms.client.helpers
Interface UserInputHandler

All Known Implementing Classes:

ServiceInputHandler, SwingInputHandler, TestInputHandler

public interface UserInputHandler

Interacts with the user when additional input is required.

Method Summary

UnknownCertificateResponse	queryUnknownCertificate(X509Certificate[] chain) The client tried to establish an SSL connection to a remote service, but the service's certificate isn't trusted (the issuer isn't in the keystore).
void	reportError(Exception ex) Convenience wrapper for reportError(Exception, Object), where the object is null.
void	reportError(Exception ex, Object object) Report the error to the user.

Method Detail

reportError

void reportError(Exception ex,
                 Object object)

Report the error to the user. Depending on whether the exception is recognised, this may display a simple message or a full stack trace.

Parameters:

ex - The exception to report

object - An object (usually a string) which the exception is about.

reportError

void reportError(Exception ex)

Convenience wrapper for reportError(Exception, Object), where the object is null.

queryUnknownCertificate

UnknownCertificateResponse queryUnknownCertificate(X509Certificate[] chain)

The client tried to establish an SSL connection to a remote service, but the service's certificate isn't trusted (the issuer isn't in the keystore). Prompt the user to find out what to do. See UnknownCertificateResponse for a list of possible responses.

Parameters:

chain - the certificate chain presented by the service (may only contain a single certificate if that is all we have available)

Returns:

the user's choice of action, or null if the user cancelled