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

All Known Subinterfaces:

ConfigurableDataService, DAIService, DataService, Registry

All Known Implementing Classes:

ConfigurableWSIDataService, ConfigurableWSRFDataService, WSIDataService, WSRFDataService

public interface Properties

Facilitates access to the properties of a resource exposed by a service.

Author:

The OGSA-DAI Project Team.

getProperty

public Property getProperty(javax.xml.namespace.QName name)
                     throws ServiceCommsException,
                            UnknownPropertyException,
                            ResourceUnknownException,
                            ServerException,
                            AuthorisationException

Obtain a property of a resource.

Parameters:

name - Qualified name of the property

Returns:

property

Throws:

UnknownPropertyException - If the property is unknown to the resource.

ResourceUnknownException - If the resource is unknown to the service.

AuthorisationException - If the client is not authorised to access this information.

ServerException - If there was an error server-side.

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

getProperties

public Property[] getProperties(javax.xml.namespace.QName[] names)
                         throws ServiceCommsException,
                                UnknownPropertyException,
                                ResourceUnknownException,
                                ServerException,
                                AuthorisationException

Obtain multiple properties of a resource.

Parameters:

names - An array of qualified names of the properties.

Returns:

array of properties.

Throws:

UnknownPropertyException - If one of the properties is unknown to the resource.

ResourceUnknownException - If the resource is unknown to the service.

AuthorisationException - If the client is not authorised to access this information.

ServerException - If there was an error server-side.

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