uk.org.ogsadai.client.toolkit.service
Interface ConfigurableDataService

All Superinterfaces:

DAIService, DataService, DataTransport, Properties, Service

All Known Implementing Classes:

ConfigurableWSIDataService, ConfigurableWSRFDataService

public interface ConfigurableDataService

extends DataService

Interface for data service proxies that provides the dynamic resource deployment operations of a configurable data service.

Author:

The OGSA-DAI Project Team

Method Summary

void	deploy(java.lang.String name) Instruct a data service to expose a new data service resource of the given name.
void	undeploy(java.lang.String name) Instruct a data service to no longer expose a data service resource of the given name.

Methods inherited from interface uk.org.ogsadai.client.toolkit.service.DataService

closeSession, createDataTransport, createSession, getActivityMetaData, getDataResourceInfo, getStatus, getSupportedActivities, perform, perform, pollUntilRequestCompleted, pollUntilRequestCompleted, terminate

Methods inherited from interface uk.org.ogsadai.client.toolkit.service.DAIService

getVersion

Methods inherited from interface uk.org.ogsadai.client.toolkit.service.Service

getResourceIDs, getURL, ping, setConnectionProperty, setResourceID

Methods inherited from interface uk.org.ogsadai.client.toolkit.service.Properties

getProperties, getProperty

Methods inherited from interface uk.org.ogsadai.client.toolkit.service.DataTransport

getBlock, getDataTransportURL, getFully, getNBlocks, getResourceID, getSessionStreamID, putBlock, putClosingBlock, putFully, setConnectionProperty, setResourceID, setSessionStreamID

Method Detail

deploy

public void deploy(java.lang.String name)
            throws AuthorisationException,
                   RequestException,
                   ServerException,
                   ServiceCommsException

Instruct a data service to expose a new data service resource of the given name. The server is expected to have the configuration of the resource available server-side.

Parameters:

name - data service resource name.

Throws:

RequestException - If there is a problem with the client's request e.g there is no such session.

AuthorisationException - If the client is not authorised to access the service, resource, session or stream.

ServerException - If there was an error server-side.

ServiceCommsException - If there was an error communicating with the service.

java.lang.IllegalArgumentException - If name is null.

undeploy

public void undeploy(java.lang.String name)
              throws AuthorisationException,
                     ServerException,
                     ServiceCommsException,
                     ResourceBusyException,
                     ResourceUnknownException

Instruct a data service to no longer expose a data service resource of the given name.

Parameters:

name - data service resource name.

Throws:

ResourceBusyException - If the resource is busy.

ResourceUnknownException - If the resource is unknown to the service.

AuthorisationException - If the client is not authorised to access the service, resource, session or stream.

ServerException - If there was an error server-side.

ServiceCommsException - If there was an error communicating with the service.

java.lang.IllegalArgumentException - If name is null.