Java TV(tm) API 1.0

javax.tv.service
Interface SIRequestor


public interface SIRequestor

This interface is implemented by application classes to receive the results of asynchronous SI retrieval requests. The SIRequestor registers itself at the time of the asynchronous call for a single request and is automatically unregistered when the request is completed. Applications can disambiguate retrieval operations by registering a unique SIRequestor for each retrieval request.

The asynchronous SI retrieval mechanisms invoke the methods of this interface using system threads that are guaranteed to not hold locks on application objects.


Method Summary
 void notifyFailure(SIRequestFailureType reason)
          Notifies the SIRequestor of unsuccessful asynchronous SI retrieval.
 void notifySuccess(SIRetrievable[] result)
          Notifies the SIRequestor of successful asynchronous SI retrieval.
 

Method Detail

notifySuccess

public void notifySuccess(SIRetrievable[] result)
Notifies the SIRequestor of successful asynchronous SI retrieval.
Parameters:
result - The previously requested data.

notifyFailure

public void notifyFailure(SIRequestFailureType reason)
Notifies the SIRequestor of unsuccessful asynchronous SI retrieval.
Parameters:
reason - The reason why the asynchronous request failed.

Java TV(tm) API 1.0

Copyright © 1998 - 2000 Sun Microsystems, Inc.