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

All Superinterfaces:

InvocationListener

All Known Implementing Classes:

ServiceInputHandler, SwingInputHandler

public interface UserInputHandler
extends InvocationListener

Interacts with the user when additional input is required.

Method Summary

void	addInvocationListener(InvocationListener listener) Add a new listener to the chain of handlers called when invoking SOAP operations.
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	removeInvocationListener(InvocationListener listener) Remove a listener previously added with addInvocationListener(uk.ac.soton.ecs.iam.grid.comms.client.helpers.InvocationListener).
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.
void	setCurrentThreadEPR(org.apache.axis.message.addressing.EndpointReferenceType EPR) Set the EPR for this thread.

Methods inherited from interface uk.ac.soton.ecs.iam.grid.comms.client.helpers.InvocationListener

addHeadersForCall, invocationDone, invocationStarted

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

addInvocationListener

void addInvocationListener(InvocationListener listener)

Add a new listener to the chain of handlers called when invoking SOAP operations.

removeInvocationListener

void removeInvocationListener(InvocationListener listener)

Remove a listener previously added with addInvocationListener(uk.ac.soton.ecs.iam.grid.comms.client.helpers.InvocationListener).

setCurrentThreadEPR

void setCurrentThreadEPR(org.apache.axis.message.addressing.EndpointReferenceType EPR)

Set the EPR for this thread. When contacting a remote service with an unknown certificate, this EPR checked for a ConversationID.ENDPOINT_KEYINFO containing the certificate. This allows per-call roots of trust.