org.dvb.internet
Interface UsenetClient

All Superinterfaces:
InternetClient, javax.tv.service.selection.ServiceContentHandler

public interface UsenetClient
extends InternetClient

This interface supports the operations required on a Usenet news client.

Any URLs passed to methods in this interface should correspond to the usenet news URL format specified in RFC 1738


Method Summary
 void selectGroup(java.net.URL group)
          Select and display messages in the specified newsgroup.
 void selectMessage(java.net.URL message)
          Select and display a message with the given message ID.
 
Methods inherited from interface org.dvb.internet.InternetClient
addInternetClientListener, getService, getServiceContentLocators, removeInternetClientListener
 

Method Detail

selectMessage

void selectMessage(java.net.URL message)
                   throws ClientNotRunningException
Select and display a message with the given message ID. If the news client is not running, then this method will not cause it to be started and the call will fail.

This is an asynchronous operation, whose success or failure will be indicated by an InternetClientSuccessEvent or InternetClientFailureEvent or one of their subclasses.

Parameters:
message - the URL of the message. This may or may not include the address of a news server.
Throws:
java.lang.SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL
java.lang.IllegalArgumentException - if the specified URL does not include a Usenet news message ID or does not correspond to the Usenet news URL format specified in RFC 1738
ClientNotRunningException - if the client is not currently running.

selectGroup

void selectGroup(java.net.URL group)
                 throws ClientNotRunningException
Select and display messages in the specified newsgroup. If the news client is not running, then this method will not cause it to be started and the call will fail.

This is an asynchronous operation, whose success or failure will be indicated by an InternetClientSuccessEvent or InternetClientFailureEvent or one of their subclasses.

Parameters:
group - the URL of the group. This may or may not include the address of a news server.
Throws:
java.lang.SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL.
java.lang.IllegalArgumentException - if the specified URL does not correspond to the Usenet news URL format specified in RFC 1738
ClientNotRunningException - if the client is not currently running.