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 |
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.DataTransport |
getBlock, getDataTransportURL, getFully, getNBlocks, getResourceID, getSessionStreamID, putBlock, putClosingBlock, putFully, setConnectionProperty, setResourceID, setSessionStreamID |
COPYRIGHT_NOTICE
private static final java.lang.String COPYRIGHT_NOTICE
-
Copyright statement
- See Also:
- Constant Field Values
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.
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.