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

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

All Implemented Interfaces:

Comparable<StorableInStateRepository>, Conversation, SLAConversation, StorableInStateRepository, SLAResource, WSResourceLifetime, WSTrust, PolicyManagement, ResourceMetadata, Signallable

Deprecated.

@Deprecated
public class SLAConversationImpl
extends Object
implements SLAConversation, Comparable<StorableInStateRepository>

The default implementation of SLAConversation.

Field Summary

Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.sla.SLAResource

SLA_RESOURCE_TYPE

Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.wstrust.WSTrust

DEFAULT_WSTRUST_ISSUER, requestSecurityToken, VALIDATE_SUBJECT_DESCRIPTION, WSTRUST_REQUEST_TYPE_ISSUANCE, WSTRUST_REQUEST_TYPE_VALIDATION, WSTRUST_SAML_1_1, WSTRUST_STATUS, WSTRUST_STATUS_INVALID, WSTRUST_STATUS_VALID, XMLNS_WSTRUST, XMLNS_WSU

Constructor Summary

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

Method Summary

void	addOwnerRule(MatchRule rule) Deprecated. Add a rule controlling who has the 'owner' role.
void	addPolicyRule(PolicyRule rule) Deprecated. Add an access control rule to this resource's dynamic access control policy.
void	addUserRule(MatchRule rule) Deprecated. Enable access to an SLA to another user
boolean	checkUser(SubjectDescription user) Deprecated. Test whether this user has the 'user' role.
void	close() Deprecated.
void	closeSLA() Deprecated. Close an SLA
int	compareTo(StorableInStateRepository other) Deprecated.
void	continueActivity(org.apache.axis.message.addressing.EndpointReferenceType activityEPR, Constraint[] constraints) Deprecated. Checks that a change in an activity should be permitted.
void	destroy() Deprecated.
void	finish() Deprecated. Indicate that this conversation is no longer required.
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[]	getOwnerRules() Deprecated. List the current rules used to determine whether someone has the 'owner' role (which allows them to charge to this account.
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.
StateRepository	getRepository() Deprecated. Get the StateRepository holding this object.
RemoteService	getService() Deprecated. Return the conversation's RemoteService.
String	getSLAState() Deprecated. Gets the state of an SLA
SLATemplate	getSLATerms() Deprecated. Gets the Terms for an SLA
URL	getURL() Deprecated. Returns the globally unique identifier.
SLAUsageSummary	getUsage(Date start, Date end, long interval, long maxReports) Deprecated. Gets usage reports from an sla
Document	getUsageSummary() Deprecated. Old way to get usage.
MatchRule[]	getUserRules() Deprecated. List the current rules used to determine whether someone has the 'user' role (which allows them to charge to this account.
String[]	getValidRoles() Deprecated. List the roles the caller is permitted to see.
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.
void	removeOwnerRule(MatchRule rule) Deprecated. Remove a rule controlling who has the 'owner' role.
void	removePolicyRule(PolicyRule rule) Deprecated. Remove an access control rule from this resource's dynamic access control policy.
void	removeUserRule(MatchRule rule) Deprecated. Disable access to an SLA for a user
Document	RequestSecurityToken(Element doc) Deprecated. Request a security token, as defined by the WS-Trust specification.
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	startActivity(org.apache.axis.message.addressing.EndpointReferenceType activityEPR, Constraint[] constraints, UsageReport[] reports) Deprecated. Check that an activity should be started.

Methods inherited from class java.lang.Object

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

Constructor Detail

SLAConversationImpl

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

Deprecated.

Throws:

ObjectAlreadyExists

Method Detail

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

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

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

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

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

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

getService

public RemoteService getService()

Deprecated.

Description copied from interface: Conversation

Return the conversation's RemoteService.

Specified by:

getService in interface Conversation

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

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)

startActivity

public void startActivity(org.apache.axis.message.addressing.EndpointReferenceType activityEPR,
                          Constraint[] constraints,
                          UsageReport[] reports)
                   throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Check that an activity should be started.

Specified by:

startActivity in interface SLAResource

Parameters:

activityEPR - the new resource (must implement ReportAPI port type).

constraints - requirements

Throws:

RemoteException - if the activity should not be started

continueActivity

public void continueActivity(org.apache.axis.message.addressing.EndpointReferenceType activityEPR,
                             Constraint[] constraints)
                      throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Checks that a change in an activity should be permitted.

Specified by:

continueActivity in interface SLAResource

Parameters:

activityEPR - the new resource (must implement ReportAPI port type).

constraints - the new requirements

Throws:

RemoteException - if the change should be refused

closeSLA

public void closeSLA()
              throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Close an SLA

Specified by:

closeSLA in interface SLAResource

Throws:

RemoteException

addOwnerRule

public void addOwnerRule(MatchRule rule)
                  throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Add a rule controlling who has the 'owner' role.

Specified by:

addOwnerRule in interface SLAResource

Parameters:

rule - the rule to add

Throws:

RemoteException

removeOwnerRule

public void removeOwnerRule(MatchRule rule)
                     throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Remove a rule controlling who has the 'owner' role.

Specified by:

removeOwnerRule in interface SLAResource

Parameters:

rule - the rule to add

Throws:

RemoteException

getOwnerRules

public MatchRule[] getOwnerRules()
                          throws RemoteException

Deprecated.

Description copied from interface: SLAResource

List the current rules used to determine whether someone has the 'owner' role (which allows them to charge to this account.

Specified by:

getOwnerRules in interface SLAResource

Throws:

RemoteException

addUserRule

public void addUserRule(MatchRule rule)
                 throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Enable access to an SLA to another user

Specified by:

addUserRule in interface SLAResource

Parameters:

rule - the rule to add

Throws:

RemoteException

removeUserRule

public void removeUserRule(MatchRule rule)
                    throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Disable access to an SLA for a user

Specified by:

removeUserRule in interface SLAResource

Parameters:

rule - the rule to add

Throws:

RemoteException

getUserRules

public MatchRule[] getUserRules()
                         throws RemoteException

Deprecated.

Description copied from interface: SLAResource

List the current rules used to determine whether someone has the 'user' role (which allows them to charge to this account.

Specified by:

getUserRules in interface SLAResource

Throws:

RemoteException

getSLATerms

public SLATemplate getSLATerms()
                        throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Gets the Terms for an SLA

Specified by:

getSLATerms in interface SLAResource

Throws:

RemoteException

getSLAState

public String getSLAState()
                   throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Gets the state of an SLA

Specified by:

getSLAState in interface SLAResource

Throws:

RemoteException

close

public void close()
           throws RemoteException

Deprecated.

Throws:

RemoteException

checkUser

public boolean checkUser(SubjectDescription user)
                  throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Test whether this user has the 'user' role.

Specified by:

checkUser in interface SLAResource

Parameters:

user - user to test.

Returns:

true if this is a valid user of the SLA, or false if not

Throws:

RemoteException - if the caller is not permitted to check

getUsageSummary

public Document getUsageSummary()
                         throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Old way to get usage.

Specified by:

getUsageSummary in interface SLAResource

Throws:

RemoteException

getUsage

public SLAUsageSummary getUsage(Date start,
                                Date end,
                                long interval,
                                long maxReports)
                         throws RemoteException

Deprecated.

Description copied from interface: SLAResource

Gets usage reports from an sla

Specified by:

getUsage in interface SLAResource

Parameters:

start - the start time of the usage interval to request.

end - the end time of the usage interval to request.

interval - the specified time between reports in milliseconds.

maxReports - the max number of reports to return.

Throws:

RemoteException

compareTo

public int compareTo(StorableInStateRepository other)

Deprecated.

Specified by:

compareTo in interface Comparable<StorableInStateRepository>

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)

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)

RequestSecurityToken

public Document RequestSecurityToken(Element doc)
                              throws RemoteException

Deprecated.

Description copied from interface: WSTrust

Request a security token, as defined by the WS-Trust specification.

Specified by:

RequestSecurityToken in interface WSTrust

Parameters:

doc - a <RequestSecurityToken>

Returns:

a <RequestSecurityTokenResponse>

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)

destroy

public void destroy()
             throws ResourceUnknownFault,
                    ResourceNotDestroyedFault,
                    RemoteException

Deprecated.

Specified by:

destroy in interface WSResourceLifetime

Throws:

ResourceUnknownFault

ResourceNotDestroyedFault

RemoteException