net.java.sip.communicator.plugin.addrbook.msoutlook
Class MsOutlookAddrBookContactQuery

java.lang.Object
  net.java.sip.communicator.service.contactsource.AbstractContactQuery<T>
      net.java.sip.communicator.service.contactsource.AsyncContactQuery<MsOutlookAddrBookContactSourceService>
          net.java.sip.communicator.plugin.addrbook.msoutlook.MsOutlookAddrBookContactQuery

All Implemented Interfaces:

ContactQuery

public class MsOutlookAddrBookContactQuery
extends AsyncContactQuery<MsOutlookAddrBookContactSourceService>

Implements ContactQuery for the Address Book of Microsoft Outlook.

Author:

Lyubomir Marinov

Field Summary

Fields inherited from class net.java.sip.communicator.service.contactsource.AsyncContactQuery

query

Fields inherited from interface net.java.sip.communicator.service.contactsource.ContactQuery

QUERY_CANCELED, QUERY_COMPLETED, QUERY_ERROR, QUERY_IN_PROGRESS

Constructor Summary

MsOutlookAddrBookContactQuery(MsOutlookAddrBookContactSourceService msoabcss, Pattern query)
Initializes a new MsOutlookAddrBookContactQuery instance to be performed by a specific MsOutlookAddrBookContactSourceService.

Method Summary

protected String	normalizePhoneNumber(String phoneNumber) Normalizes a String phone number by converting alpha characters to their respective digits on a keypad and then stripping non-digit characters.
protected boolean	phoneNumberMatches(String phoneNumber) Determines whether a specific String phone number matches the AsyncContactQuery.query of this AsyncContactQuery.
protected void	run() Performs this AsyncContactQuery in a background Thread.
protected void	stopped(boolean completed) Notifies this AsyncContactQuery that it has stopped performing in the associated background Thread.

Methods inherited from class net.java.sip.communicator.service.contactsource.AsyncContactQuery

addQueryResult, getPhoneNumberQuery, getQueryResultCount, getQueryResults, getQueryString, start

Methods inherited from class net.java.sip.communicator.service.contactsource.AbstractContactQuery

addContactQueryListener, cancel, fireContactReceived, fireQueryStatusChanged, getContactSource, getStatus, removeContactQueryListener, setStatus

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MsOutlookAddrBookContactQuery

public MsOutlookAddrBookContactQuery(MsOutlookAddrBookContactSourceService msoabcss,
                                     Pattern query)

Initializes a new MsOutlookAddrBookContactQuery instance to be performed by a specific MsOutlookAddrBookContactSourceService.

Parameters:

msoabcss - the MsOutlookAddrBookContactSourceService which is to perform the new ContactQuery

query - the Pattern for which msoabcss is being queried

Method Detail

run

protected void run()

Performs this AsyncContactQuery in a background Thread.

Specified by:

run in class AsyncContactQuery<MsOutlookAddrBookContactSourceService>

See Also:

AsyncContactQuery.run()

stopped

protected void stopped(boolean completed)

Notifies this AsyncContactQuery that it has stopped performing in the associated background Thread.

Overrides:

stopped in class AsyncContactQuery<MsOutlookAddrBookContactSourceService>

Parameters:

completed - true if this ContactQuery has successfully completed, false if an error has been encountered during its execution

See Also:

AsyncContactQuery.stopped(boolean)

normalizePhoneNumber

protected String normalizePhoneNumber(String phoneNumber)

Normalizes a String phone number by converting alpha characters to their respective digits on a keypad and then stripping non-digit characters.

Specified by:

normalizePhoneNumber in class AsyncContactQuery<MsOutlookAddrBookContactSourceService>

Parameters:

phoneNumber - a String which represents a phone number to normalize

Returns:

a String which is a normalized form of the specified phoneNumber

phoneNumberMatches

protected boolean phoneNumberMatches(String phoneNumber)

Determines whether a specific String phone number matches the AsyncContactQuery.query of this AsyncContactQuery.

Specified by:

phoneNumberMatches in class AsyncContactQuery<MsOutlookAddrBookContactSourceService>

Parameters:

phoneNumber - the String which represents the phone number to match to the query of this AsyncContactQuery

Returns:

true if the specified phoneNumber matches the query of this AsyncContactQuery; otherwise, false