public abstract class SDFactory extends Object
Discoverer
objects. It is expected that
an implementation will have a method for obtaining a default value for the
URL of the information system.Constructor and Description |
---|
SDFactory() |
Modifier and Type | Method and Description |
---|---|
static Discoverer |
createDiscoverer()
Creates a
Discoverer with the default Session
and URL . |
static Discoverer |
createDiscoverer(Session session)
Creates a
Discoverer with a specified session and a default
and URL . |
static Discoverer |
createDiscoverer(Session session,
URL url)
Creates a
Discoverer . |
static Discoverer |
createDiscoverer(String sagaFactoryClassname)
Creates a
Discoverer with the default Session
and URL . |
static Discoverer |
createDiscoverer(String sagaFactoryClassname,
Session session)
Creates a
Discoverer with a specified session and a default
and URL . |
static Discoverer |
createDiscoverer(String sagaFactoryClassname,
Session session,
URL url)
Creates a
Discoverer . |
protected abstract Discoverer |
doCreateDiscoverer(Session session)
Creates a
Discoverer with the default URL . |
protected abstract Discoverer |
doCreateDiscoverer(Session session,
URL url)
Creates a
Discoverer . |
protected abstract Discoverer doCreateDiscoverer(Session session) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
with the default URL
.
To be provided by the implementation.session
- the session handleAuthenticationFailedException
- 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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outprotected abstract Discoverer doCreateDiscoverer(Session session, URL url) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
. To be provided by the
implementation.session
- the session handleurl
- the URL to guide the implementationAuthenticationFailedException
- 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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer() throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
with the default Session
and URL
.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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer(String sagaFactoryClassname) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
with the default Session
and URL
.sagaFactoryClassname
- the class name of the Saga factory to be used.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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer(Session session) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
with a specified session and a default
and URL
.session
- the session, or nullAuthenticationFailedException
- 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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer(String sagaFactoryClassname, Session session) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NoSuccessException, NotImplementedException, TimeoutException
Discoverer
with a specified session and a default
and URL
.sagaFactoryClassname
- the class name of the Saga factory to be used.session
- the session handle, may be nullAuthenticationFailedException
- 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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer(Session session, URL url) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NotImplementedException, NoSuccessException, TimeoutException
Discoverer
. The url specified as an input
parameter is to assist the implementation to locate the underlying
information system such that it can be queried.session
- the session handle, may be null
url
- the URL to guide the implementation, may be null
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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outpublic static Discoverer createDiscoverer(String sagaFactoryClassname, Session session, URL url) throws AuthenticationFailedException, AuthorizationFailedException, DoesNotExistException, IncorrectURLException, NotImplementedException, NoSuccessException, TimeoutException
Discoverer
. The url specified as an input
parameter is to assist the implementation to locate the underlying
information system such that it can be queried.sagaFactoryClassname
- the class name of the Saga factory to be used.session
- the session handle, may be null
url
- the URL to guide the implementation, may be null
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.DoesNotExistException
- if the url is syntactically valid, but no service can be
contacted at that URLIncorrectURLException
- if an implementation cannot handle the specified protocol, or
that access to the specified entity via the given protocol is
impossibleNoSuccessException
- if no result can be returned because of information system or
other internal problemsNotImplementedException
- if not implemented by that SAGA implementation at allTimeoutException
- if a remote operation did not complete successfully because
the network communication or the remote service timed outCopyright © 2016 Open Grid Forum. All rights reserved.