/*******************************************************************************
* Copyright (c) 2005, 2007 Remy Suen
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* Remy Suen <remy.suen@gmail.com> - initial API and implementation
******************************************************************************/
package org.eclipse.ecf.protocol.msn.events;
import org.eclipse.ecf.protocol.msn.Contact;
import org.eclipse.ecf.protocol.msn.Group;
/**
* <p>
* The IContactListListener monitors events pertaining to the addition and
* removal of contacts on the user's client.
* </p>
*
* <p>
* <b>Note:</b> This class/interface is part of an interim API that is still
* under development and expected to change significantly before reaching
* stability. It is being made available at this early stage to solicit feedback
* from pioneering adopters on the understanding that any code that uses this
* API will almost certainly be broken (repeatedly) as the API evolves.
* </p>
*/
public interface IContactListListener {
/**
* This method is invoked when a contact has been added to the user's list.
*
* @param contact
* the contact that has been added
*/
public void contactAdded(Contact contact);
/**
* This method is invoked when a contact has been removed from the user's
* list.
*
* @param contact
* the contact that has been added
*/
public void contactRemoved(Contact contact);
/**
* This method is invoked when a contact has added the user to his or her
* contact list.
*
* @param email
* the email of the contact
*/
public void contactAddedUser(String email);
/**
* This method is invoked when a contact has removed the user from his or
* her contact list.
*
* @param email
* the email of the contact
*/
public void contactRemovedUser(String email);
/**
* This method is invoked when a group has been added to the contact list.
*
* @param group
* the group that has been added
*/
public void groupAdded(Group group);
}