net.java.sip.communicator.service.googlecontacts
Interface GoogleContactsService

All Known Implementing Classes:

GoogleContactsServiceImpl

public interface GoogleContactsService

Google Contacts service.

Author:

Sebastien Vincent

Method Summary

void	addContactSource(GoogleContactsConnection cnx, boolean googleTalk) Add a contact source service with the specified GoogleContactsConnection.
void	addContactSource(String login, String password) Add a contact source service with the specified GoogleContactsConnection.
GoogleContactsConnection	getConnection(String login, String password) Get a GoogleContactsConnection.
List<GoogleContactsEntry>	getContacts() Get the full contacts list.
void	removeContactSource(GoogleContactsConnection cnx) Remove a contact source service with the specified GoogleContactsConnection.
void	removeContactSource(String login) Remove a contact source service with the specified GoogleContactsConnection.
List<GoogleContactsEntry>	searchContact(GoogleContactsConnection cnx, GoogleQuery query, int count, GoogleEntryCallback callback) Perform a search for a contact using regular expression.

Method Detail

searchContact

List<GoogleContactsEntry> searchContact(GoogleContactsConnection cnx,
                                        GoogleQuery query,
                                        int count,
                                        GoogleEntryCallback callback)

Perform a search for a contact using regular expression.

Parameters:

cnx - GoogleContactsConnection to perform the query

query - Google query

count - maximum number of matched contacts

callback - object that will be notified for each new GoogleContactsEntry found

Returns:

list of GoogleContactsEntry

getConnection

GoogleContactsConnection getConnection(String login,
                                       String password)

Get a GoogleContactsConnection.

Parameters:

login - login to connect to the service

password - password to connect to the service

Returns:

GoogleContactsConnection.

getContacts

List<GoogleContactsEntry> getContacts()

Get the full contacts list.

Returns:

list of GoogleContactsEntry

addContactSource

void addContactSource(String login,
                      String password)

Add a contact source service with the specified GoogleContactsConnection.

Parameters:

login - login

password - password

addContactSource

void addContactSource(GoogleContactsConnection cnx,
                      boolean googleTalk)

Add a contact source service with the specified GoogleContactsConnection.

Parameters:

cnx - GoogleContactsConnection

googleTalk - if the contact source has been created as GoogleTalk account or via external Google Contacts

removeContactSource

void removeContactSource(GoogleContactsConnection cnx)

Remove a contact source service with the specified GoogleContactsConnection.

Parameters:

cnx - GoogleContactsConnection.

removeContactSource

void removeContactSource(String login)

Remove a contact source service with the specified GoogleContactsConnection.

Parameters:

login - login