uk.ac.soton.ecs.iam.grid.comms.client
Interface DataConversation

All Superinterfaces:

Comparable<StorableInStateRepository>, Conversation, DataStagerResource, IdentifiableResource, PolicyManagement, ResourceMetadata, Signallable, StorableInStateRepository, WSResourceLifetime

public interface DataConversation
extends WSResourceLifetime, Conversation, DataStagerResource

A DataConversation represents a data stager on a remote machine.

Field Summary

Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.data.DataStagerResource

DATA_RESOURCE_TYPE, DATA_STAGER_REST_URL

Method Summary

void	copyFrom(DataConversation source) Copy from another data stager to this one.
void	copyTo(DataConversation target) Copy to another data stager from this one.
MatchPattern	createMatchPattern() Get a pattern that matches this service.
URL	getRestURL() Return the REST URL for this stager, if available.
void	read(File file) Download from the data conversation.
void	saveFromFile(File file) Upload to the data conversation.

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

getService

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

getDescription, getEndpointRef, getURL, setDescription

Methods inherited from interface java.lang.Comparable

compareTo

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.data.DataStagerResource

addOwnerRule, checkData, checkReadAccess, checkWriteAccess, copyFrom, copyFromURL, copyTo, deleteContents, disableR, disableW, enableR, enableW, finishData, getManagerRules, getOwnerRules, getReaderRules, getWriterRules, read, removeOwnerRule, save, writeEnable, writeProtect

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.PolicyManagement

addPolicyRule, getPolicyRules, getValidRoles, removePolicyRule

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.ResourceMetadata

getEPR, setLabel

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.Signallable

getAvailableSignals, signal

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.IdentifiableResource

getServiceMatchPattern

Method Detail

read

void read(File file)
          throws RemoteException,
                 IOException

Download from the data conversation. This is a wrapper for DataStagerResource.read() which writes the result to a file.

Throws:

RemoteException

IOException

saveFromFile

void saveFromFile(File file)
                  throws RemoteException,
                         IOException

Upload to the data conversation. This is a wrapper for DataStagerResource#save() which reads the data from a file.

Throws:

RemoteException

IOException

copyFrom

void copyFrom(DataConversation source)
              throws RemoteException

Copy from another data stager to this one. This is a wrapper for DataStagerResource.copyTo(org.apache.axis.message.addressing.EndpointReferenceType) which takes a DataConversation. It automatically includes the certificate of the source in the EPR, allowing transfers between services which don't know each other.

Throws:

RemoteException

copyTo

void copyTo(DataConversation target)
            throws RemoteException

Copy to another data stager from this one. This is a wrapper for DataStagerResource.copyTo(org.apache.axis.message.addressing.EndpointReferenceType) which takes a DataConversation. It automatically includes the certificate of the source in the EPR, allowing transfers between services which don't know each other.

Throws:

RemoteException

getRestURL

URL getRestURL()
               throws MalformedURLException

Return the REST URL for this stager, if available.

Returns:

a URL which accepts PUT, GET or DELETE actions, or null if none is available

Throws:

MalformedURLException - if the remote service returned an invalid URL

See Also:

upload using HTTP PUT, download using HTTP GET

createMatchPattern

MatchPattern createMatchPattern()
                                throws RemoteException

Get a pattern that matches this service.

Throws:

RemoteException