uk.ac.soton.itinnovation.grid.comms.data
Interface DataStagerResource

All Superinterfaces:

PolicyManagement, ResourceMetadata, Signallable, WSResourceLifetime

All Known Subinterfaces:

DataConversation, DataServiceSOAP, LocalDataService

All Known Implementing Classes:

DataConversationImpl, DataServiceModule

public interface DataStagerResource
extends WSResourceLifetime, PolicyManagement, ResourceMetadata, Signallable

Public operations on data stagers. This interface lists the contextualised operations on data stagers, implemented by both the service and by the client proxy.

Field Summary

static String

DATA_RESOURCE_TYPE

Method Summary

void	addOwnerRule(MatchRule rule) Deprecated. see PolicyManagement
DataStagerStatus	checkData() Reports on the status of the data stager.
boolean	checkReadAccess(SubjectDescription delegateUser) Checks if the quoted delegate may read from this data stager.
boolean	checkWriteAccess(SubjectDescription delegateUser) Checks if the quoted delegate may write to this data stager
void	copyFrom(org.apache.axis.message.addressing.EndpointReferenceType source) Copy data from another data stager.
void	copyFromURL(String source) Copy data from a normal web resource identified by a URL.
void	copyTo(org.apache.axis.message.addressing.EndpointReferenceType target) Copy data to another data stager.
void	deleteContents() Delete data in the staging area.
void	disableR(MatchRule delegateUser) Deprecated. see PolicyManagement
void	disableW(MatchRule delegateUser) Deprecated. see PolicyManagement
void	enableR(MatchRule delegateUser) Deprecated. see PolicyManagement
void	enableW(MatchRule delegateUser) Deprecated. see PolicyManagement
void	finishData() Deprecated. Use WSResourceLifetime.destroy() instead.
MatchRule[]	getManagerRules() Deprecated. see PolicyManagement
MatchRule[]	getOwnerRules() Deprecated. see PolicyManagement
MatchRule[]	getReaderRules() Deprecated. see PolicyManagement
MatchRule[]	getWriterRules() Deprecated. see PolicyManagement
javax.activation.DataHandler	read() Read data from the stager.
void	removeOwnerRule(MatchRule rule) Deprecated. see PolicyManagement
void	save(javax.activation.DataHandler data) Store data in the stager.
void	writeEnable() Write enable the staging area.
void	writeProtect() Write protect the staging area.

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.wsrf.WSResourceLifetime

destroy

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

Field Detail

DATA_RESOURCE_TYPE

static final String DATA_RESOURCE_TYPE

See Also:

Constant Field Values

Method Detail

save

@WebMethod
void save(javax.activation.DataHandler data)
          throws RemoteException

Store data in the stager.

Parameters:

data - - data handler for the SOAP attachment

Throws:

RemoteException

read

@WebMethod
javax.activation.DataHandler read()
                                  throws RemoteException

Read data from the stager.

Returns:

DataHandler

Throws:

RemoteException

copyFrom

@WebMethod
void copyFrom(org.apache.axis.message.addressing.EndpointReferenceType source)
              throws RemoteException

Copy data from another data stager.

Parameters:

source - the data stager from which the data will be fetched

Throws:

RemoteException

copyFromURL

@WebMethod
void copyFromURL(String source)
                 throws RemoteException

Copy data from a normal web resource identified by a URL. If the protocol is HTTPS then this service provider needs to trust the CA for the source's certificate. For HTTP and FTP protocols, there is no security (integrity or confidentiality). Note: to copy from a GRIA data stager, use copyFrom(org.apache.axis.message.addressing.EndpointReferenceType) instead.

Parameters:

source - the source from which the data will be fetched

Throws:

RemoteException

copyTo

@WebMethod
void copyTo(org.apache.axis.message.addressing.EndpointReferenceType target)
            throws RemoteException

Copy data to another data stager.

Parameters:

target - the data stager to which this stager's data will be copied

Throws:

RemoteException

writeEnable

@WebMethod
void writeEnable()
                 throws RemoteException

Write enable the staging area.

Throws:

RemoteException

See Also:

writeProtect()

writeProtect

@WebMethod
void writeProtect()
                  throws RemoteException

Write protect the staging area. The save() and delete() operations cannot be performed after this, until writeEnable is used.

Throws:

RemoteException

enableR

@WebMethod
@Deprecated
void enableR(MatchRule delegateUser)
             throws RemoteException

Deprecated. see PolicyManagement

Enable read for the staging area and a delegate.

Parameters:

delegateUser - - delegate user

Throws:

RemoteException

disableR

@WebMethod
@Deprecated
void disableR(MatchRule delegateUser)
              throws RemoteException

Deprecated. see PolicyManagement

Disable read for the staging area and a delegate.

Parameters:

delegateUser - - delegate user

Throws:

RemoteException

enableW

@WebMethod
@Deprecated
void enableW(MatchRule delegateUser)
             throws RemoteException

Deprecated. see PolicyManagement

Enable write for the staging area and a delegate.

Parameters:

delegateUser - - delegate user

Throws:

RemoteException

disableW

@WebMethod
@Deprecated
void disableW(MatchRule delegateUser)
              throws RemoteException

Deprecated. see PolicyManagement

Disable write for the staging area and a delegate.

Parameters:

delegateUser - - delegate user

Throws:

RemoteException

getReaderRules

@WebMethod
@Deprecated
MatchRule[] getReaderRules()
                           throws RemoteException

Deprecated. see PolicyManagement

List the current reader rules.

Throws:

RemoteException

getWriterRules

@WebMethod
@Deprecated
MatchRule[] getWriterRules()
                           throws RemoteException

Deprecated. see PolicyManagement

List the current writer rules.

Throws:

RemoteException

getManagerRules

@WebMethod
@Deprecated
MatchRule[] getManagerRules()
                            throws RemoteException

Deprecated. see PolicyManagement

List the current manager rules.

Throws:

RemoteException

getOwnerRules

@WebMethod
@Deprecated
MatchRule[] getOwnerRules()
                          throws RemoteException

Deprecated. see PolicyManagement

List the current owner rules.

Throws:

RemoteException

deleteContents

@WebMethod
void deleteContents()
                    throws RemoteException

Delete data in the staging area.

Throws:

RemoteException

checkReadAccess

@WebMethod
boolean checkReadAccess(SubjectDescription delegateUser)
                        throws RemoteException

Checks if the quoted delegate may read from this data stager.

Parameters:

delegateUser - - delegate user

Returns:

boolean - success / failure

Throws:

RemoteException

checkWriteAccess

@WebMethod
boolean checkWriteAccess(SubjectDescription delegateUser)
                         throws RemoteException

Checks if the quoted delegate may write to this data stager

Parameters:

delegateUser - - delegate user

Returns:

boolean - success / failure

Throws:

RemoteException

checkData

@WebMethod
DataStagerStatus checkData()
                           throws RemoteException

Reports on the status of the data stager.

Throws:

RemoteException

addOwnerRule

@WebMethod
@Deprecated
void addOwnerRule(MatchRule rule)
                  throws RemoteException

Deprecated. see PolicyManagement

Adds a rule to the ACL for the 'owner' role.

Parameters:

rule - the rule to add

Throws:

RemoteException

removeOwnerRule

@WebMethod
@Deprecated
void removeOwnerRule(MatchRule rule)
                     throws RemoteException

Deprecated. see PolicyManagement

Removes a rule from the ACL for the 'owner' role.

Parameters:

rule - the rule to add

Throws:

RemoteException

finishData

@Deprecated
@WebMethod(destroy=true)
void finishData()
                throws RemoteException

Deprecated. Use WSResourceLifetime.destroy() instead.

Finishes the staging area.

Throws:

RemoteException