sample
Interface SampleService

All Superinterfaces:

GridService, ManagedGridService, ReportAPI, WebAdmin

All Known Subinterfaces:

RemoteSampleService

All Known Implementing Classes:

SampleServiceImpl

@WebServiceWSDL(targetNamespace="http://www.it-innovation.soton.ac.uk/2006/grid/sample",
                portTypeName="SampleService",
                serviceName="SampleService",
                bindingName="SampleServiceSoapBinding")
public interface SampleService
extends ManagedGridService, ReportAPI, GridService, WebAdmin

The public interface for the SampleService. This includes all service operations which don't take a context (i.e., they operation on the service itself rather than on a particular resource). Extending ManagedGridService allows the service administrator to add to, remove from, and query the service's list of trusted account services. When spending money, a user must have access to an account at one of these. Extending ReportAPI allows the SLA service to get usage reports from us. Extending GridService provides operations to get our identity and query for resources.

Field Summary

static String

SAMPLE_SERVICE_RESOURCE_TYPE A unique string to represent the type of the service itself.

Fields inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService

FREE_SERVICE

Method Summary

org.apache.axis.message.addressing.EndpointReferenceType

createSampleResource(String label, MatchPattern owner) Create a new resource.

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.management.ManagedGridService

addTrustedAccountService, getTrustedAccountServices, removeTrustedAccountService

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.reportapi.ReportAPI

getMessages, getMessagesN

Methods inherited from interface uk.ac.soton.itinnovation.grid.types.GridService

getResources, getServiceProviderID, getServiceProviderIssuer

Methods inherited from interface uk.ac.soton.itinnovation.grid.comms.webadmin.WebAdmin

ensurePoliciesDeployed, getAtomFeed

Field Detail

SAMPLE_SERVICE_RESOURCE_TYPE

static final String SAMPLE_SERVICE_RESOURCE_TYPE

A unique string to represent the type of the service itself. The PBAC policy with this name is used to protect operations on the service which have no context.

See Also:

ConversationID.getResourceType(org.apache.axis.message.addressing.EndpointReferenceType), Constant Field Values

Method Detail

createSampleResource

@WebMethod(usesBillingHeader=true)
org.apache.axis.message.addressing.EndpointReferenceType createSampleResource(String label,
                                                                                                         MatchPattern owner)
                                                                              throws RemoteException

Create a new resource. Calling this may require an account or an SLA to be specified in the SOAP header (or may require nothing at all), depending on how the service has been configured.

On success, the EPR of the new resource is returned. Anyone who matches the 'owner' rule can access the resource as its owner. Typically, this rule just matches the identity of the person creating the resource.

Parameters:

label - A label for the new resource

owner - A pattern to allow access by the new resource's owner

Returns:

the EPR of the new resource

Throws:

RemoteException