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

All Known Subinterfaces:

ConfigurableDataService, DAIService, DataService, Registry

All Known Implementing Classes:

ConfigurableWSIDataService, ConfigurableWSRFDataService, WSIDataService, WSRFDataService

public interface Service

A generic service interface for client-side proxies.

Author:

The OGSA-DAI Team.

Method Summary

ResourceID[]	getResourceIDs() Obtain the resource IDs of the resources that are exposed by this service.
java.net.URL	getURL() Obtain the URL of the service
void	ping() Contacts the service to check it is running.
void	setConnectionProperty(ConnectionProperty property) Configure the connection with a property.
void	setResourceID(ResourceID id) Set the default resource.

Method Detail

getURL

public java.net.URL getURL()

Obtain the URL of the service

Returns:

the URL

getResourceIDs

public ResourceID[] getResourceIDs()
                            throws ServiceCommsException,
                                   ServerException

Obtain the resource IDs of the resources that are exposed by this service.

Returns:

an array of resource IDs

Throws:

ServerException - If there was an error server-side.

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

setResourceID

public void setResourceID(ResourceID id)

Set the default resource. Any resource-specific requests will be targetted at the resource with this ID.

Parameters:

id - Resource ID

setConnectionProperty

public void setConnectionProperty(ConnectionProperty property)

Configure the connection with a property.

Parameters:

property - A connection property

ping

public void ping()
          throws ServiceCommsException

Contacts the service to check it is running.

Throws:

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