uk.ac.soton.itinnovation.grid.utils
Interface Transport

All Known Implementing Classes:

AbstractTransport, AxisTransport

public interface Transport

A Transport is used to make calls on a remote GRIA service. Normally, you don't want to use this interface directly; instead, use Conversation objects, which use this interface internally.

Method Summary

Parser	fetchWSDL(URL url) Download and parse a WSDL file.
X509Certificate	getIssuerCert() Return the certificate of the issuer of the certificate we use for signing messages.
char[]	getKeyPassword() Get the password for the single private key in the keystore.
KeyStore	getKeyStore() Get the keystore, which contains a single private key.
Key	getPrivateKey() Get the private key from the keystore.
X509Certificate	getSubjectCert() Return the certificate we use for signing messages.
Object	invokeService(RemoteBoundMethod method, String serviceProviderRef, SOAPHeaderElement[] extraHeaders, Object[] argValues) Invoke a SOAP method on a remote server.
InputStream	openURL(URL url) Fetch 'url' using the Apache commons httpclient, using our configured keystore.

Method Detail

invokeService

Object invokeService(RemoteBoundMethod method,
                     String serviceProviderRef,
                     SOAPHeaderElement[] extraHeaders,
                     Object[] argValues)
                     throws RemoteException

Invoke a SOAP method on a remote server.

The clientRef, serviceProviderRef and version fields of the request are filled in automatically.

Parameters:

method - the service to invoke

serviceProviderRef - the server-assigned ID for the conversation

extraHeaders - additional SOAP headers to add to the message

argValues - the values of the input arguments

Returns:

the value returned by the remote call, or null if return type is void. If an attachment is returned, the value will be a DataHandler.

Throws:

RemoteException

getSubjectCert

X509Certificate getSubjectCert()

Return the certificate we use for signing messages.

getIssuerCert

X509Certificate getIssuerCert()

Return the certificate of the issuer of the certificate we use for signing messages.

getKeyStore

KeyStore getKeyStore()

Get the keystore, which contains a single private key.

Returns:

the keystore

getPrivateKey

Key getPrivateKey()

Get the private key from the keystore.

getKeyPassword

char[] getKeyPassword()

Get the password for the single private key in the keystore.

openURL

InputStream openURL(URL url)
                    throws IOException

Fetch 'url' using the Apache commons httpclient, using our configured keystore. We can't use the regular method because https endpoints will give errors since we need to set up the keystore location.

Parameters:

url - the URL of the HTTP or HTTPS resource

Returns:

InputStream the response data stream (excuding headers)

Throws:

IOException

fetchWSDL

Parser fetchWSDL(URL url)
                 throws IOException,
                        SAXException,
                        javax.wsdl.WSDLException

Download and parse a WSDL file.

Parameters:

url - the URL of the WSDL file

Returns:

a parsed WSDL document

Throws:

IOException

SAXException

javax.wsdl.WSDLException