1 /*

     2 * Copyright (c) 2010 Sasken Communication Technologies Ltd.

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of the "{License}"

     6 * which accompanies  this distribution, and is available

     7 * at the URL "{LicenseUrl}".

     8 *

     9 * Initial Contributors:

    10 * Chandradeep Gandhi, Sasken Communication Technologies Ltd - Initial contribution

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 * Interface spefication for list of contacts from a site

    16 *

    17 */

    18 

    19 #ifndef SMFCONTACTHETCHER_H

    20 #define SMFCONTACTHETCHER_H

    21 

    22 class SmfProvider; //base-class for service provider

    23 class SmfContact; //class for Contact in a social network

    24 class SmfGroup; //class for a group in social network

    25 

    26 

    27 /**

    28  * Interface to search for contacts/connections from a service provider. This class

    29  * provides basic functionality to allow applications to obtain list of

    30  * contacts or friends in a social networking service.

    31  *

    32  * Note that branding information for the particular service implementation

    33  * is available from base-class functions. See also:

    34  * SmfProvider::serviceName(), SmfProvider::serviceIcon(), SmfProvider::description()

    35  *

    36  * All of the functionality described here should be implemented by a service

    37  * specific plug-in object.

    38  */

    39 class SmfContactFetcher : public SmfProvider

    40 {

    41   Q_OBJECT;

    42 

    43 public:

    44   // Seeing as this is a plug-in implementation, these will realistically

    45   // be generated by SMF factory of some kind

    46   SmfContactFetcher(QObject* parent = 0);

    47   ~SmfContactFetcher();

    48 

    49 public:

    50   // Get the friend listing - might be made asynchrnous later

    51   virtual QList<SmfContact> friends() = 0; // list of contact objects

    52   virtual QList<SmfContact> followers() = 0; // list of contact objects

    53   virtual QList<SmfContact> search(SmfContact) = 0; // list of contact objects

    54   virtual QList<SmfGroup>   groups() = 0; // list of group objects

    55   virtual QList<SmfContact> searchInGroup(SmfGroup) = 0; // list of contact objects

    56 

    57   virtual SmfContactModel   model() = 0; // maybe we can make a QItemModel-derived model?

    58 

    59 

    60 slots:

    61 

    62 signals:

    63   // Notification of remote changes to the contactlist,

    64   // probably should be done through model

    65   virtual void friendsChanged() = 0;

    66   virtual void followersChanged() = 0;

    67   virtual void groupChanged() = 0;

    68 };

    69 

    70 

    71 

    72 #endif // SMFCONTACTHETCHER_H