org.dvb.internet

Interface UsenetClient

All Superinterfaces:

InternetClient, 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

Methods

Modifier and Type	Method and Description
void	selectGroup(URL group) Select and display messages in the specified newsgroup.
void	selectMessage(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(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:

SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL

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(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:

SecurityException - if the caller does not have a SocketPermission for the host part of the specified URL.

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.