tecgraf.openbus.browser.scs_offers

Class SingleServiceFinder

Object

SingleServiceFinder

public final class SingleServiceFinder
extends Object

Utilitário para buscar ofertas bem específicas no serviço de registro do Openbus. É útil quando se deseja recuperar alguma faceta onde se espera apenas uma instância, dado o critério de busca.

Os métodos desta classe otimizam o tempo de retorno da busca, evitando demoras causadas por temporizações nas tentativas de chamadas remotas de ofertas inválidas.

Author:

Daltro Gama (daltro@tecgraf.puc-rio.br)

Method Summary

Methods

Modifier and Type	Method and Description
static ServiceOfferDesc	findFirstOffer(Connection cnn, ServiceProperty[] properties)
static ServiceOfferDesc	findSingleOffer(Component parentForUI, ManagedConnection cnn, ServiceProperty[] properties, boolean mayFindNothing) Recuperar a única oferta de serviço no serviço de ofertas que atende aos critérios especificados.
static ServiceOfferDesc	findSingleOffer(ManagedConnection cnn, ServiceProperty[] properties, boolean mayFindNothing) Recuperar a única oferta de serviço no serviço de ofertas que atende aos critérios especificados.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

findFirstOffer

public static ServiceOfferDesc findFirstOffer(Connection cnn,
                              ServiceProperty[] properties)
                                       throws InterruptedException,
                                              ServiceFailure

Throws:

InterruptedException

ServiceFailure

findSingleOffer

public static ServiceOfferDesc findSingleOffer(ManagedConnection cnn,
                               ServiceProperty[] properties,
                               boolean mayFindNothing)
                                        throws ServiceFailure,
                                               InterruptedException

Recuperar a única oferta de serviço no serviço de ofertas que atende aos critérios especificados.

Se este método identificar mais de uma oferta com o critério, um popup será exibido para que o usuário escolha entre as ofertas encontradas.

Parameters:

cnn - Conexão Openbus a ser usada para realizar a busca

properties - Filtro que deve retornar apenas uma oferta

mayFindNothing - Se for false, exibe um popup para o usuário informando que nada foi encontrado.

Returns:

A única oferta de serviço encontrada ou null caso nenhuma seja encontrada.

Throws:

ServiceFailure

InterruptedException

findSingleOffer

public static ServiceOfferDesc findSingleOffer(Component parentForUI,
                               ManagedConnection cnn,
                               ServiceProperty[] properties,
                               boolean mayFindNothing)
                                        throws ServiceFailure,
                                               InterruptedException

Recuperar a única oferta de serviço no serviço de ofertas que atende aos critérios especificados.

Se este método identificar mais de uma oferta com o critério, um popup será exibido para que o usuário escolha entre as ofertas encontradas.

Parameters:

parentForUI - Componente pai para os possíveis popups gerados por este método.

cnn - Conexão Openbus a ser usada para realizar a busca

properties - Filtro que deve retornar apenas uma oferta

mayFindNothing - Se for false, exibe um popup para o usuário informando que nada foi encontrado.

Returns:

A única oferta de serviço encontrada ou null caso nenhuma seja encontrada.

Throws:

ServiceFailure

InterruptedException