public interface ServiceDescription extends SagaObject, Attributes
Read access to the top level data of the service and a means to navigate to
related services. This class implements the
org.ogf.saga.attributes.Attributes
interface and offers getter methods to obtain details of that service. The
attributes are based on those found in GLUE. They are:
Capabilities
ImplementationVersion
Implementor
InterfaceVersion
Name
RelatedServices
getRelatedServices
which returns an array of ServiceDescription
s.Site
Type
Uid
Url
getUrl
method obtains
the same information.In addition there is an attribute that contains the url of the information service that was used to obtain the data.
InformationServiceUrl
This class has no CONSTRUCTOR as objects of this type are created only by other objects in the service discovery API.
Modifier and Type | Field and Description |
---|---|
static String |
CAPABILITIES
Attribute name, identifiable aspects of functionality.
|
static String |
IMPLEMENTATION_VERSION
Attribute name, the version of the service implementation.
|
static String |
IMPLEMENTOR
Attribute name, name of the organisation providing the implementation of
the service.
|
static String |
INFORMATION_SERVICE_URL
Attribute name, url of the information service used to obtain this service_description.
|
static String |
INTERFACE_VERSION
Attribute name, the version of the service interface.
|
static String |
NAME
Attribute name, name of service - not necessarily unique.
|
static String |
RELATED_SERVICES
Attribute name, uids of related services.
|
static String |
SITE
Attribute name, name of site.
|
static String |
TYPE
Attribute name, type of service.
|
static String |
UID
Attribute name, unique identifier of service.
|
static String |
URL
Attribute name, url to contact the service.
|
NO_WAIT, WAIT_FOREVER
Modifier and Type | Method and Description |
---|---|
ServiceData |
getData()
Returns a
ServiceData object with the service data
key/value pairs. |
Set<ServiceDescription> |
getRelatedServices()
Returns the set of related services.
|
String |
getUrl()
Returns the
URL to contact the service. |
clone, getId, getSession
existsAttribute, findAttributes, getAttribute, getVectorAttribute, isReadOnlyAttribute, isRemovableAttribute, isVectorAttribute, isWritableAttribute, listAttributes, removeAttribute, setAttribute, setVectorAttribute
static final String CAPABILITIES
static final String IMPLEMENTATION_VERSION
static final String IMPLEMENTOR
static final String INFORMATION_SERVICE_URL
static final String INTERFACE_VERSION
static final String NAME
static final String RELATED_SERVICES
static final String SITE
static final String TYPE
static final String UID
static final String URL
String getUrl()
URL
to contact the service. The
URL
may also be obtained using the
org.ogf.saga.attributes.Attributes
interface.Set<ServiceDescription> getRelatedServices() throws AuthenticationFailedException, AuthorizationFailedException, NoSuccessException, TimeoutException
org.ogf.saga.attributes.Attributes
interface may be used
to get the uids of the related services.AuthenticationFailedException
- if none of the available session contexts could successfully
be used for authenticationAuthorizationFailedException
- if none of the available contexts of the used session could
be used for successful authorization. That error indicates
that the resource could not be accessed at all, and not that
an operation was not available due to restricted permissions.NoSuccessException
- if no result can be returned because of information system or
other internal problemsTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outServiceData getData()
ServiceData
object with the service data
key/value pairs.Copyright © 2016 Open Grid Forum. All rights reserved.