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

All Superinterfaces:

Comparable<StorableInStateRepository>, StorableInStateRepository

All Known Implementing Classes:

DataStagerManagerImpl

public interface DataStagerManager
extends StorableInStateRepository

A DataStagerManager implementation is able to intercept usage reports and start/continue activity requests generated by a data stager, before they are sent to the SLA service. An implementation can accumulate usage reports from multiple stagers and send them as a singe usage report.

Field Summary

static QName

PROXY_IFACE Qualified name for the "proxyiface" element.

Method Summary

void	dataStagerAddCumulativeUsageReport(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR, Metric metric, double value) Called when a data stager generates a cumulative usage report such as an update in the amount of data transfer used.
void	dataStagerContinueActivity(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR, Constraint[] constraints) Called when a data stager makes a continueActivity request.
void	dataStagerInstantaneousUsageChanged(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR, Metric metric) Called when a data stager generates an instantaneous usage report.
void	dataStagerStartActivity(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR, Constraint[] constraints, UsageReport[] usageReports) Called when a data stager makes a startActivity request.

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

getDescription, getEndpointRef, getInterface, getParentURL, getRepository, getURL, setDescription

Methods inherited from interface java.lang.Comparable

compareTo

Field Detail

PROXY_IFACE

static final QName PROXY_IFACE

Qualified name for the "proxyiface" element.

Method Detail

dataStagerStartActivity

void dataStagerStartActivity(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR,
                             Constraint[] constraints,
                             UsageReport[] usageReports)

Called when a data stager makes a startActivity request. This would usually be called on the SLA service.

Parameters:

stagerEPR - The EPR of the data stager making the request

constraints - An array of constraints that must be satisfied if the stager is to be created successfully.

usageReports - An array of initial usage reports.

dataStagerContinueActivity

void dataStagerContinueActivity(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR,
                                Constraint[] constraints)
                                throws RemoteException

Called when a data stager makes a continueActivity request. This would usually be called on the SLA service.

Parameters:

stagerEPR - The EPR of the data stager making the request

constraints - An array of constraints that must be satisfied.

Throws:

RemoteException

dataStagerAddCumulativeUsageReport

void dataStagerAddCumulativeUsageReport(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR,
                                        Metric metric,
                                        double value)

Called when a data stager generates a cumulative usage report such as an update in the amount of data transfer used.

Parameters:

stagerEPR - The EPR of the data stager generating the usage report

metric - The metric type of the resource being used

value - The cumulative increase in use of the metric

dataStagerInstantaneousUsageChanged

void dataStagerInstantaneousUsageChanged(org.apache.axis.message.addressing.EndpointReferenceType stagerEPR,
                                         Metric metric)
                                         throws GridFailureException

Called when a data stager generates an instantaneous usage report. This method does not include a value parameter as the implementation is supposed to total up the combined usage of this metric from all data stagers and send a single usage report.

Parameters:

stagerEPR - The EPR of the data stager generating the usage report

metric - The metric type of the resource being used

Throws:

GridFailureException