uk.ac.soton.ecs.iam.grid.client.staterepos
Class DataConversationImpl

java.lang.Object
  uk.ac.soton.ecs.iam.grid.client.staterepos.DataConversationImpl

All Implemented Interfaces:

Comparable<StorableInStateRepository>, Conversation, DataConversation, DestroyableConversation, StorableInStateRepository, DataStagerResource, WSResourceLifetime, PolicyManagement, ResourceMetadata, Signallable

Deprecated. - see RemoteResourceProxy

@Deprecated
public class DataConversationImpl
extends Object
implements DataConversation

The default implementation of DataConversation.

Field Summary

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

DATA_RESOURCE_TYPE

Constructor Summary

DataConversationImpl(StateRepository repository, org.apache.axis.message.addressing.EndpointReferenceType EPR)
Deprecated.

Method Summary

void	addAccessControlRule(MatchRule rule) Deprecated.
void	addOwnerRule(MatchRule rule) Deprecated. Adds a rule to the ACL for the 'owner' role.
void	addPolicyRule(PolicyRule rule) Deprecated. Add an access control rule to this resource's dynamic access control policy.
DataStagerStatus	checkData() Deprecated. Reports on the status of the data stager.
boolean	checkReadAccess(SubjectDescription user) Deprecated. Checks if the quoted delegate may read from this data stager.
boolean	checkWriteAccess(SubjectDescription user) Deprecated. Checks if the quoted delegate may write to this data stager
int	compareTo(StorableInStateRepository other) Deprecated.
void	copyFrom(DataConversation source) Deprecated. Copy from another data stager to this one.
void	copyFrom(org.apache.axis.message.addressing.EndpointReferenceType source) Deprecated. Copy data from another data stager.
void	copyFromURL(String source) Deprecated. Copy data from a normal web resource identified by a URL.
void	copyTo(DataConversation target) Deprecated. Copy to another data stager from this one.
void	copyTo(org.apache.axis.message.addressing.EndpointReferenceType target) Deprecated. Copy data to another data stager.
void	deleteContents() Deprecated. Delete data in the staging area.
void	destroy() Deprecated.
void	disableR(MatchRule rule) Deprecated. Disable read for the staging area and a delegate.
void	disableW(MatchRule rule) Deprecated. Disable write for the staging area and a delegate.
void	enableR(MatchRule rule) Deprecated. Enable read for the staging area and a delegate.
void	enableW(MatchRule rule) Deprecated. Enable write for the staging area and a delegate.
void	finish() Deprecated. Indicate that this conversation is no longer required.
void	finishData() Deprecated. Finishes the staging area.
MatchRule[]	getAccessControlRules() Deprecated.
String[]	getAvailableSignals() Deprecated. List the signals which are available given the resource's current state.
StorableInStateRepository[]	getChildConversations() Deprecated. Returns an array of all conversations having this one as a parent.
String	getDescription() Deprecated. Returns a textual description of the object.
org.apache.axis.message.addressing.EndpointReferenceType	getEndpointRef() Deprecated. Return an EndpointReferenceType for this conversation.
org.apache.axis.message.addressing.EndpointReferenceType	getEPR() Deprecated. Get the EPR for this resource.
Class	getInterface() Deprecated. Returns the type of this object.
MatchRule[]	getManagerRules() Deprecated. List the current manager rules.
MatchRule[]	getOwnerRules() Deprecated. List the current owner rules.
URL	getParentURL() Deprecated. Returns the URL of this object's parent.
PolicyRule[]	getPolicyRules() Deprecated. Get the access control rules in this resource's dynamic access control policy.
MatchRule[]	getReaderRules() Deprecated. List the current reader rules.
StateRepository	getRepository() Deprecated. Get the StateRepository holding this object.
RemoteService	getService() Deprecated. Return the conversation's RemoteService.
URL	getURL() Deprecated. Returns the globally unique identifier.
String[]	getValidRoles() Deprecated. List the roles the caller is permitted to see.
MatchRule[]	getWriterRules() Deprecated. List the current writer rules.
boolean	isFinished() Deprecated. Returns true if the finish method has been called.
void	outOfDate() Deprecated. Used by the StateRepository if the server returns new resource with our ID.
javax.activation.DataHandler	read() Deprecated. Read data from the stager.
void	read(File file) Deprecated. Download from the data conversation.
void	removeAccessControlRule(MatchRule rule) Deprecated.
void	removeOwnerRule(MatchRule rule) Deprecated. Removes a rule from the ACL for the 'owner' role.
void	removePolicyRule(PolicyRule rule) Deprecated. Remove an access control rule from this resource's dynamic access control policy.
void	save(javax.activation.DataHandler input) Deprecated. Store data in the stager.
void	setDescription(String description) Deprecated. Change the textual description, as returned by getDescription.
void	setLabel(String label) Deprecated. Change the resource's label.
String	signal(String signalName) Deprecated. Signal an event to the resource's PBAC process.
void	writeEnable() Deprecated. Write enable the staging area.
void	writeProtect() Deprecated. Write protect the staging area.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataConversationImpl

public DataConversationImpl(StateRepository repository,
                            org.apache.axis.message.addressing.EndpointReferenceType EPR)
                     throws ObjectAlreadyExists

Deprecated.

Throws:

ObjectAlreadyExists

Method Detail

getInterface

public Class getInterface()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns the type of this object. When loading the object, a StateRepository locates a class implementing the interface and uses that for the object.

Specified by:

getInterface in interface StorableInStateRepository

outOfDate

public void outOfDate()

Deprecated.

Description copied from interface: Conversation

Used by the StateRepository if the server returns new resource with our ID.

Specified by:

outOfDate in interface Conversation

getChildConversations

public StorableInStateRepository[] getChildConversations()

Deprecated.

Description copied from interface: Conversation

Returns an array of all conversations having this one as a parent.

Specified by:

getChildConversations in interface Conversation

finish

public void finish()

Deprecated.

Description copied from interface: Conversation

Indicate that this conversation is no longer required. It will be removed from the StateRepository. No other methods on a Conversation can be called once finish() has been invoked.

Note that this does not close the conversation with the remote supplier. You should normally call a different method, such as WSResourceLifetime.destroy().

Specified by:

finish in interface Conversation

isFinished

public boolean isFinished()

Deprecated.

Description copied from interface: Conversation

Returns true if the finish method has been called.

Specified by:

isFinished in interface Conversation

getURL

public URL getURL()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns the globally unique identifier. No two distinct objects may have the same URL, even if they have different types.

Specified by:

getURL in interface StorableInStateRepository

getEndpointRef

public org.apache.axis.message.addressing.EndpointReferenceType getEndpointRef()

Deprecated.

Description copied from interface: StorableInStateRepository

Return an EndpointReferenceType for this conversation. This contains both the endpoint address of the service, and the resource itself.

Specified by:

getEndpointRef in interface StorableInStateRepository

getParentURL

public URL getParentURL()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns the URL of this object's parent. Returns null if this is a top-level (service) object.

Specified by:

getParentURL in interface StorableInStateRepository

getDescription

public String getDescription()

Deprecated.

Description copied from interface: StorableInStateRepository

Returns a textual description of the object. This can be presented to the user when choosing from a list, for example.

Specified by:

getDescription in interface StorableInStateRepository

setDescription

public void setDescription(String description)

Deprecated.

Description copied from interface: StorableInStateRepository

Change the textual description, as returned by getDescription.

Specified by:

setDescription in interface StorableInStateRepository

getRepository

public StateRepository getRepository()

Deprecated.

Description copied from interface: StorableInStateRepository

Get the StateRepository holding this object.

Specified by:

getRepository in interface StorableInStateRepository

getEPR

public org.apache.axis.message.addressing.EndpointReferenceType getEPR()

Deprecated.

Description copied from interface: ResourceMetadata

Get the EPR for this resource. The EPR gives the canonical endpoint for the service, and various meta-data items.

Specified by:

getEPR in interface ResourceMetadata

See Also:

the label set with {@link setLabel}, a unique type URI, the state of the resource, the resource which manages this one (e.g. an SLA manages a job), the resource which contains this one (e.g. a job service is the parent of a job)

save

public void save(javax.activation.DataHandler input)
          throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Store data in the stager.

Specified by:

save in interface DataStagerResource

Parameters:

input - - data handler for the SOAP attachment

Throws:

RemoteException

copyFrom

public void copyFrom(DataConversation source)
              throws RemoteException

Deprecated.

Description copied from interface: DataConversation

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.

Specified by:

copyFrom in interface DataConversation

Throws:

RemoteException

copyFrom

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

Deprecated.

Description copied from interface: DataStagerResource

Copy data from another data stager.

Specified by:

copyFrom in interface DataStagerResource

Parameters:

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

Throws:

RemoteException

copyFromURL

public void copyFromURL(String source)
                 throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

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 DataStagerResource.copyFrom(org.apache.axis.message.addressing.EndpointReferenceType) instead.

Specified by:

copyFromURL in interface DataStagerResource

Parameters:

source - the source from which the data will be fetched

Throws:

RemoteException

read

public void read(File file)
          throws RemoteException

Deprecated.

Description copied from interface: DataConversation

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

Specified by:

read in interface DataConversation

Throws:

RemoteException

read

public javax.activation.DataHandler read()
                                  throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Read data from the stager.

Specified by:

read in interface DataStagerResource

Returns:

DataHandler

Throws:

RemoteException

copyTo

public void copyTo(DataConversation target)
            throws RemoteException

Deprecated.

Description copied from interface: DataConversation

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.

Specified by:

copyTo in interface DataConversation

Throws:

RemoteException

copyTo

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

Deprecated.

Description copied from interface: DataStagerResource

Copy data to another data stager.

Specified by:

copyTo in interface DataStagerResource

Parameters:

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

Throws:

RemoteException

checkData

public DataStagerStatus checkData()
                           throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Reports on the status of the data stager.

Specified by:

checkData in interface DataStagerResource

Throws:

RemoteException

writeProtect

public void writeProtect()
                  throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

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

Specified by:

writeProtect in interface DataStagerResource

Throws:

RemoteException

writeEnable

public void writeEnable()
                 throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Write enable the staging area.

Specified by:

writeEnable in interface DataStagerResource

Throws:

RemoteException

See Also:

DataStagerResource.writeProtect()

finishData

public void finishData()
                throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Finishes the staging area.

Specified by:

finishData in interface DataStagerResource

Throws:

RemoteException

addOwnerRule

public void addOwnerRule(MatchRule rule)
                  throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

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

Specified by:

addOwnerRule in interface DataStagerResource

Parameters:

rule - the rule to add

Throws:

RemoteException

removeOwnerRule

public void removeOwnerRule(MatchRule rule)
                     throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

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

Specified by:

removeOwnerRule in interface DataStagerResource

Parameters:

rule - the rule to add

Throws:

RemoteException

enableR

public void enableR(MatchRule rule)
             throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Enable read for the staging area and a delegate.

Specified by:

enableR in interface DataStagerResource

Parameters:

rule - - delegate user

Throws:

RemoteException

disableR

public void disableR(MatchRule rule)
              throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Disable read for the staging area and a delegate.

Specified by:

disableR in interface DataStagerResource

Parameters:

rule - - delegate user

Throws:

RemoteException

enableW

public void enableW(MatchRule rule)
             throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Enable write for the staging area and a delegate.

Specified by:

enableW in interface DataStagerResource

Parameters:

rule - - delegate user

Throws:

RemoteException

disableW

public void disableW(MatchRule rule)
              throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Disable write for the staging area and a delegate.

Specified by:

disableW in interface DataStagerResource

Parameters:

rule - - delegate user

Throws:

RemoteException

getReaderRules

public MatchRule[] getReaderRules()
                           throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

List the current reader rules.

Specified by:

getReaderRules in interface DataStagerResource

Throws:

RemoteException

getWriterRules

public MatchRule[] getWriterRules()
                           throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

List the current writer rules.

Specified by:

getWriterRules in interface DataStagerResource

Throws:

RemoteException

getOwnerRules

public MatchRule[] getOwnerRules()
                          throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

List the current owner rules.

Specified by:

getOwnerRules in interface DataStagerResource

Throws:

RemoteException

getManagerRules

public MatchRule[] getManagerRules()
                            throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

List the current manager rules.

Specified by:

getManagerRules in interface DataStagerResource

Throws:

RemoteException

addAccessControlRule

public void addAccessControlRule(MatchRule rule)
                          throws RemoteException

Deprecated.

Throws:

RemoteException

removeAccessControlRule

public void removeAccessControlRule(MatchRule rule)
                             throws RemoteException

Deprecated.

Throws:

RemoteException

getAccessControlRules

public MatchRule[] getAccessControlRules()
                                  throws RemoteException

Deprecated.

Throws:

RemoteException

getValidRoles

public String[] getValidRoles()
                       throws RemoteException

Deprecated.

Description copied from interface: PolicyManagement

List the roles the caller is permitted to see. This is the list of roles whose rules are returned by PolicyManagement.getPolicyRules().

Specified by:

getValidRoles in interface PolicyManagement

Throws:

RemoteException

See Also:

PDP.getValidProcessRoles(java.lang.String)

deleteContents

public void deleteContents()
                    throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Delete data in the staging area.

Specified by:

deleteContents in interface DataStagerResource

Throws:

RemoteException

checkReadAccess

public boolean checkReadAccess(SubjectDescription user)
                        throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

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

Specified by:

checkReadAccess in interface DataStagerResource

Parameters:

user - - delegate user

Returns:

boolean - success / failure

Throws:

RemoteException

checkWriteAccess

public boolean checkWriteAccess(SubjectDescription user)
                         throws RemoteException

Deprecated.

Description copied from interface: DataStagerResource

Checks if the quoted delegate may write to this data stager

Specified by:

checkWriteAccess in interface DataStagerResource

Parameters:

user - - delegate user

Returns:

boolean - success / failure

Throws:

RemoteException

getService

public RemoteService getService()

Deprecated.

Description copied from interface: Conversation

Return the conversation's RemoteService.

Specified by:

getService in interface Conversation

compareTo

public int compareTo(StorableInStateRepository other)

Deprecated.

Specified by:

compareTo in interface Comparable<StorableInStateRepository>

destroy

public void destroy()
             throws RemoteException

Deprecated.

Specified by:

destroy in interface WSResourceLifetime

Throws:

RemoteException

addPolicyRule

public void addPolicyRule(PolicyRule rule)
                   throws RemoteException

Deprecated.

Description copied from interface: PolicyManagement

Add an access control rule to this resource's dynamic access control policy.

Specified by:

addPolicyRule in interface PolicyManagement

Throws:

RemoteException

See Also:

PDP.addAccessControlRule(java.lang.String, uk.ac.soton.itinnovation.grid.types.MatchRule)

removePolicyRule

public void removePolicyRule(PolicyRule rule)
                      throws RemoteException

Deprecated.

Description copied from interface: PolicyManagement

Remove an access control rule from this resource's dynamic access control policy.

Specified by:

removePolicyRule in interface PolicyManagement

Throws:

RemoteException

See Also:

PDP.removeAccessControlRule(java.lang.String, uk.ac.soton.itinnovation.grid.types.MatchRule)

getPolicyRules

public PolicyRule[] getPolicyRules()
                            throws RemoteException

Deprecated.

Description copied from interface: PolicyManagement

Get the access control rules in this resource's dynamic access control policy. Rules are only returned for the roles the caller is permitted to see. Note: The rules are filtered to only include those for roles listed by PolicyManagement.getValidRoles().

Specified by:

getPolicyRules in interface PolicyManagement

Throws:

RemoteException

See Also:

PDP.getAccessControlRules(java.lang.String, java.lang.String)

setLabel

public void setLabel(String label)
              throws RemoteException

Deprecated.

Description copied from interface: ResourceMetadata

Change the resource's label. Each resource is given a label by the client when it is created. This label is returned in the metadata from getResources, making it easier for other users to identify the resource.

Specified by:

setLabel in interface ResourceMetadata

Parameters:

label - the new label

Throws:

RemoteException

signal

public String signal(String signalName)
              throws RemoteException

Deprecated.

Description copied from interface: Signallable

Signal an event to the resource's PBAC process. The process state may be updated in response to this, according to the service policy.

Specified by:

signal in interface Signallable

Parameters:

signalName - the event causing the transition

Returns:

the new state of the resource

Throws:

RemoteException

getAvailableSignals

public String[] getAvailableSignals()
                             throws RemoteException

Deprecated.

Description copied from interface: Signallable

List the signals which are available given the resource's current state.

Specified by:

getAvailableSignals in interface Signallable

Returns:

the list of possible signals

Throws:

RemoteException

See Also:

Signallable.signal(java.lang.String)