uk.org.ogsadai.client.toolkit.wsrf
Class ConfigurableWSRFDataService

java.lang.Object
  |
  +--uk.org.ogsadai.client.toolkit.wsrf.WSRFDataService
        |
        +--uk.org.ogsadai.client.toolkit.wsrf.ConfigurableWSRFDataService

All Implemented Interfaces:

ConfigurableDataService, DAIService, DataService, DataTransport, Properties, Service

public class ConfigurableWSRFDataService

extends WSRFDataService

implements ConfigurableDataService

Client-side stub for a configurable OGSA-DAI WSRF 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.wsrf.WSRFDataService

mResourceID

Constructor Summary

ConfigurableWSRFDataService(java.lang.String url)
Construct a new configurable data service stub for the service at the given URL.

ConfigurableWSRFDataService(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.wsrf.WSRFDataService

addAddressingHeaders, closeSession, createDataTransport, createSession, getActivityMetaData, getBlock, getCallFactory, getDataResourceInfo, getDataTransportURL, getFully, getNBlocks, getProperties, getProperty, getResourceID, getResourceIDs, getSessionStreamID, getStatus, getSupportedActivities, getURL, getVersion, perform, perform, ping, pollUntilRequestCompleted, pollUntilRequestCompleted, pollUntilRequestCompleted, putBlock, putClosingBlock, putFully, setConnectionProperty, setProperty, setResourceID, setSessionStreamID, setTimeout, 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

ConfigurableWSRFDataService

public ConfigurableWSRFDataService(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.

ConfigurableWSRFDataService

public ConfigurableWSRFDataService(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.