uk.org.ogsadai.client.toolkit.wsi
Class ConfigurableWSIDataService

java.lang.Object
  |
  +--uk.org.ogsadai.client.toolkit.wsi.WSIDataService
        |
        +--uk.org.ogsadai.client.toolkit.wsi.ConfigurableWSIDataService
All Implemented Interfaces:
ConfigurableDataService, DAIService, DataService, DataTransport, Properties, Service

public class ConfigurableWSIDataService
extends WSIDataService
implements ConfigurableDataService

Client-side stub for a configurable OGSA-DAI WSI data service.

Author:
The OGSA-DAI Team.

Field Summary
private static java.lang.String COPYRIGHT_NOTICE
          Copyright statement
 
Fields inherited from class uk.org.ogsadai.client.toolkit.wsi.WSIDataService
mResourceID
 
Constructor Summary
ConfigurableWSIDataService(java.lang.String url)
          Construct a new configurable data service stub for the service at the given URL.
ConfigurableWSIDataService(java.lang.String url, ResourceID id)
          Construct a new configurable data service stub for the service at the given URL and set up to communicate with a data service resource exposed by the service.
 
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 class uk.org.ogsadai.client.toolkit.wsi.WSIDataService
closeSession, createDataTransport, createSession, getActivityMetaData, getBlock, getCallFactory, getDataResourceInfo, getDataTransportURL, getFully, getNBlocks, getProperties, getProperty, getResourceID, getResourceIDs, getSessionStreamID, getStatus, getSupportedActivities, getURL, getVersion, perform, perform, ping, pollUntilRequestCompleted, pollUntilRequestCompleted, putBlock, putClosingBlock, putFully, setConnectionProperty, setResourceID, setSessionStreamID, terminate
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
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
 

Field Detail

COPYRIGHT_NOTICE

private static final java.lang.String COPYRIGHT_NOTICE
Copyright statement

See Also:
Constant Field Values
Constructor Detail

ConfigurableWSIDataService

public ConfigurableWSIDataService(java.lang.String url)
                           throws java.net.MalformedURLException
Construct a new configurable data service stub for the service at the given URL.

Parameters:
url - Data service URL.
Throws:
java.net.MalformedURLException - If the URL is malformed.

ConfigurableWSIDataService

public ConfigurableWSIDataService(java.lang.String url,
                                  ResourceID id)
                           throws java.net.MalformedURLException
Construct a new configurable data service stub for the service at the given URL and set up to communicate with a data service resource exposed by the service.

Parameters:
url - Data service URL.
id - Data service resource name - may be null
Throws:
java.net.MalformedURLException - If the URL is malformed.
Method Detail

deploy

public void deploy(java.lang.String name)
            throws AuthorisationException,
                   RequestException,
                   ServerException,
                   ServiceCommsException
Description copied from interface: ConfigurableDataService
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.

Specified by:
deploy in interface ConfigurableDataService
Parameters:
name - data service resource name.
Throws:
ServiceCommsException - If there was an error communicating with the service.
ServerException - If there was an error server-side.
AuthorisationException - If the client is not authorised to access the service, resource, session or stream.
RequestException - If there is a problem with the client's request e.g there is no such session.

undeploy

public void undeploy(java.lang.String name)
              throws AuthorisationException,
                     ServerException,
                     ServiceCommsException,
                     ResourceBusyException,
                     ResourceUnknownException
Description copied from interface: ConfigurableDataService
Instruct a data service to no longer expose a data service resource of the given name.

Specified by:
undeploy in interface ConfigurableDataService
Parameters:
name - data service resource name.
Throws:
ResourceBusyException - If the resource is busy.
ServerException - If there was an error server-side.
ResourceUnknownException - If the resource is unknown to the service.
ServiceCommsException - If there was an error communicating with the service.
AuthorisationException - If the client is not authorised to access the service, resource, session or stream.