de.fzj.unicore.uas.client
Interface IRegistryQuery

All Known Implementing Classes:

ExternalRegistryClient, RegistryClient

public interface IRegistryQuery

query methods on a registry

Author:

schuller

Nested Class Summary

static interface

IRegistryQuery.ServiceListFilter allows to specify custom filtering conditions on the service list returned by the registry client

Field Summary

static java.lang.String

STATUS_OK

Method Summary

boolean	checkConnection() check the connection to the service
boolean	checkConnection(int timeout) check the connection to the WSRF service by calling getCurrentTime().
java.lang.String	getConnectionStatus() check the connection status to the service
java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType>	listAccessibleServices(javax.xml.namespace.QName porttype) list services implementing a given porttype that are accessible to the current client (using getCurrentTime() as test)
java.util.List<org.oasisOpen.docs.wsrf.sg2.EntryType>	listEntries() list the entries in this registry
java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType>	listServices(javax.xml.namespace.QName porttype) list services implementing a given porttype this uses XPath to query the registry, and relies on the entry having the structure sg: ServiceGroupRP/sg:Entry/sg:MemberServiceEPR/ad:Metadata/meta:InterfaceName with an ws addressing metadata entry listing the "final porttype" that the service implements
java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType>	listServices(javax.xml.namespace.QName porttype, IRegistryQuery.ServiceListFilter acceptFilter)

Field Detail

STATUS_OK

static final java.lang.String STATUS_OK

See Also:

Constant Field Values

Method Detail

listServices

java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType> listServices(javax.xml.namespace.QName porttype)
                                                                               throws java.lang.Exception

list services implementing a given porttype
this uses XPath to query the registry, and relies on the entry having the structure
sg: ServiceGroupRP/sg:Entry/sg:MemberServiceEPR/ad:Metadata/meta:InterfaceName with an ws addressing metadata entry listing the "final porttype" that the service implements

Parameters:

QName - the porttype to look for

Returns:

List of EPRs

Throws:

java.lang.Exception

listServices

java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType> listServices(javax.xml.namespace.QName porttype,
                                                                               IRegistryQuery.ServiceListFilter acceptFilter)
                                                                               throws java.lang.Exception

Parameters:

porttype - - the porttype

acceptFilter - - for filtering the list

Returns:

List of EPRs

Throws:

java.lang.Exception

listAccessibleServices

java.util.List<org.w3.x2005.x08.addressing.EndpointReferenceType> listAccessibleServices(javax.xml.namespace.QName porttype)
                                                                                         throws java.lang.Exception

list services implementing a given porttype
that are accessible to the current client (using getCurrentTime() as test)

Parameters:

porttype -

Returns:

List of EPRs

Throws:

java.lang.Exception

listEntries

java.util.List<org.oasisOpen.docs.wsrf.sg2.EntryType> listEntries()
                                                                  throws java.lang.Exception

list the entries in this registry

Throws:

java.lang.Exception

getConnectionStatus

java.lang.String getConnectionStatus()
                                     throws de.fzj.unicore.wsrflite.exceptions.ClientException

check the connection status to the service

Returns:

STATUS_OK (i.e. the string "OK") if connection is OK, an error message otherwise

Throws:

de.fzj.unicore.wsrflite.exceptions.ClientException

checkConnection

boolean checkConnection()
                        throws de.fzj.unicore.wsrflite.exceptions.ClientException

check the connection to the service

Returns:

true if service can be accessed

Throws:

de.fzj.unicore.wsrflite.exceptions.ClientException

checkConnection

boolean checkConnection(int timeout)
                        throws de.fzj.unicore.wsrflite.exceptions.ClientException

check the connection to the WSRF service by calling getCurrentTime(). If the service does not reply within the given timeout, returns false

Parameters:

timeout - - connection timeout in milliseconds

Returns:

false in case of problems contacting the remote service

Throws:

de.fzj.unicore.wsrflite.exceptions.ClientException - in case of client-side errors