uk.ac.soton.itinnovation.grid.comms.dataresource
Interface DataResourceLocal

All Known Subinterfaces:

CltMgtRegistryService, RemoteCltMgtRegistryService

All Known Implementing Classes:

CltMgtRegistryServiceImpl, ManagedDataResource, OgsaDaiServiceI2Impl, OgsaDaiServiceImpl

public interface DataResourceLocal

Method Summary

org.apache.axis.message.addressing.EndpointReferenceType	connectDataResourceRoleLocal(String parentDataResourceID, MatchRule owner, String label, Map<String,String> attributes, String metricURI) Connect an existing role.
org.apache.axis.message.addressing.EndpointReferenceType	createDataResourceRoleLocal(String parentDataResourceID, MatchRule owner, String label, Map<String,String> attributes, String metricURI) Create a role on the data resource backend.
Map<String,String>	getDataResourceAttributesLocal() Get the attribute values of this data resource.
void	modifyDataResourceLocal(String resourceId, String label, Map<String,String> attributes) Modify parts of this data resource.

Method Detail

createDataResourceRoleLocal

org.apache.axis.message.addressing.EndpointReferenceType createDataResourceRoleLocal(String parentDataResourceID,
                                                                                     MatchRule owner,
                                                                                     String label,
                                                                                     Map<String,String> attributes,
                                                                                     String metricURI)
                                                                                     throws RemoteException

Create a role on the data resource backend. Unlike #connectDataResourceRole, this method actually creates the role on the backend before returning a resource representing it. Normally this method will be hidden from SOAP users, and only called by DataResourceManager#createDefaultRoles. metricURI should typically be ignored if this method were to be called by SOAP users, as it only makes sense for the service administrator to specify metrics.

Parameters:

parentDataResourceID - The resourceID of the DataResource that this role applies to. If null, the resourceID is fetched from the context of the SOAP operation.

owner - A rule for the 'owner' PBAC role.

label - A label describing the role that is to be created.

attributes - A key-value map of attributes describing the credentials for this role. Keys should be from the set DataResourceManagement.getDataResourceRoleAttributeNames().

metricURI - The URI of a custom metric for this role. Typically ignored when provided over SOAP.

Returns:

An EPR describing the role

Throws:

RemoteException

connectDataResourceRoleLocal

org.apache.axis.message.addressing.EndpointReferenceType connectDataResourceRoleLocal(String parentDataResourceID,
                                                                                      MatchRule owner,
                                                                                      String label,
                                                                                      Map<String,String> attributes,
                                                                                      String metricURI)
                                                                                      throws RemoteException

Connect an existing role. Unlike createDataResourceRoleLocal(java.lang.String, uk.ac.soton.itinnovation.grid.types.MatchRule, java.lang.String, java.util.Map, java.lang.String), this method does not create the role on the backend and the credentials specified in attributes should describe a valid existing role. metricURI should typically be ignored when this method is called by SOAP users, as it only makes sense for the service administrator to specify metrics.

Parameters:

parentDataResourceID - The resourceID of the DataResource that this role applies to. If null, the resourceID is fetched from the context of the SOAP operation.

owner - A rule for the 'owner' PBAC role.

label - A label describing the role that is to be created.

attributes - A key-value map of attributes describing the credentials for this role. Keys should be from the set DataResourceManagement.getDataResourceRoleAttributeNames().

metricURI - The URI of a custom metric for this role. Typically ignored when provided over SOAP.

Returns:

An EPR describing the role

Throws:

RemoteException

getDataResourceAttributesLocal

Map<String,String> getDataResourceAttributesLocal()

Get the attribute values of this data resource. The return type is a key-value map of attributes. Keys will be from the set DataResourceManagement.getDataResourceAttributeNames().

modifyDataResourceLocal

void modifyDataResourceLocal(String resourceId,
                             String label,
                             Map<String,String> attributes)

Modify parts of this data resource.

Parameters:

label - The new label. If null, the label will not be changed.

attributes - A new key-value map of attributes. Any attributes not specified in this map will not be modified or removed. Keys should be of the set DataResourceManagement.getDataResourceAttributeNames().