pl.mn.communicator
Interface IContactListService

All Known Implementing Classes:

DefaultContactListService

public interface IContactListService

Through this service client can either clear, export or import contact list to the Gadu-Gadu server.

Created on 2004-11-27

Version:

$Id: IContactListService.java,v 1.1 2005/11/05 23:34:52 winnetou25 Exp $

Author:

Mateusz Szczap

Method Summary

void	addContactListListener(ContactListListener contactListListener) Adds ContactListListener object to the list of listeners to be notified of events such as successfuly importing or exporting contact list.
void	clearContactList() Clears user's contact list from the Gadu-Gadu server.
void	exportContactList(java.util.Collection users) Exports user's contact list to the Gadu-Gadu server.
void	importContactList() Imports user's contact list from the Gadu-Gadu server.
void	removeContactListlistener(ContactListListener contactListListener) Removes ContactListListener object from the list of listeners that are notified of events such as successfuly importing or exporting contact list.

Method Detail

clearContactList

void clearContactList()
                      throws GGException

Clears user's contact list from the Gadu-Gadu server.

Throws:

GGException - if there is an error while exporting contact.

GGSessionException - if we are currently not logged in.

exportContactList

void exportContactList(java.util.Collection users)
                       throws GGException

Exports user's contact list to the Gadu-Gadu server.

Parameters:

users - collection of LocalUser objects.

Throws:

GGException - if where is an error while exporting contact list.

GGSessionException - if we are currently not logged in.

java.lang.NullPointerException - if users collection is null.

importContactList

void importContactList()
                       throws GGException

Imports user's contact list from the Gadu-Gadu server.

Throws:

GGException - if there is an error while importing contact list.

GGSessionException - if we are currently not logged in.

addContactListListener

void addContactListListener(ContactListListener contactListListener)

Adds ContactListListener object to the list of listeners to be notified of events such as successfuly importing or exporting contact list.

Parameters:

contactListListener - the listener to be notified of contact list events.

removeContactListlistener

void removeContactListlistener(ContactListListener contactListListener)

Removes ContactListListener object from the list of listeners that are notified of events such as successfuly importing or exporting contact list.

Parameters:

contactListListener - the listener object to be removed from contact list events notification.