com.liferay.portal.service.persistence
Interface ContactPersistence

All Superinterfaces:

BasePersistence<Contact>

@ProviderType
public interface ContactPersistence
extends BasePersistence<Contact>

The persistence interface for the contact service.

Caching information and settings can be found in portal.properties

See Also:

ContactPersistenceImpl, ContactUtil

Method Summary

void	cacheResult(Contact contact) Caches the contact in the entity cache if it is enabled.
void	cacheResult(List<Contact> contacts) Caches the contacts in the entity cache if it is enabled.
int	countAll() Returns the number of contacts.
int	countByAccountId(long accountId) Returns the number of contacts where accountId = ?.
int	countByC_C(long classNameId, long classPK) Returns the number of contacts where classNameId = ? and classPK = ?.
int	countByCompanyId(long companyId) Returns the number of contacts where companyId = ?.
Contact	create(long contactId) Creates a new contact with the primary key.
Contact	fetchByAccountId_First(long accountId, OrderByComparator orderByComparator) Returns the first contact in the ordered set where accountId = ?.
Contact	fetchByAccountId_Last(long accountId, OrderByComparator orderByComparator) Returns the last contact in the ordered set where accountId = ?.
Contact	fetchByC_C_First(long classNameId, long classPK, OrderByComparator orderByComparator) Returns the first contact in the ordered set where classNameId = ? and classPK = ?.
Contact	fetchByC_C_Last(long classNameId, long classPK, OrderByComparator orderByComparator) Returns the last contact in the ordered set where classNameId = ? and classPK = ?.
Contact	fetchByCompanyId_First(long companyId, OrderByComparator orderByComparator) Returns the first contact in the ordered set where companyId = ?.
Contact	fetchByCompanyId_Last(long companyId, OrderByComparator orderByComparator) Returns the last contact in the ordered set where companyId = ?.
Contact	fetchByPrimaryKey(long contactId) Returns the contact with the primary key or returns null if it could not be found.
List<Contact>	findAll() Returns all the contacts.
List<Contact>	findAll(int start, int end) Returns a range of all the contacts.
List<Contact>	findAll(int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the contacts.
Contact	findByAccountId_First(long accountId, OrderByComparator orderByComparator) Returns the first contact in the ordered set where accountId = ?.
Contact	findByAccountId_Last(long accountId, OrderByComparator orderByComparator) Returns the last contact in the ordered set where accountId = ?.
Contact[]	findByAccountId_PrevAndNext(long contactId, long accountId, OrderByComparator orderByComparator) Returns the contacts before and after the current contact in the ordered set where accountId = ?.
List<Contact>	findByAccountId(long accountId) Returns all the contacts where accountId = ?.
List<Contact>	findByAccountId(long accountId, int start, int end) Returns a range of all the contacts where accountId = ?.
List<Contact>	findByAccountId(long accountId, int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the contacts where accountId = ?.
Contact	findByC_C_First(long classNameId, long classPK, OrderByComparator orderByComparator) Returns the first contact in the ordered set where classNameId = ? and classPK = ?.
Contact	findByC_C_Last(long classNameId, long classPK, OrderByComparator orderByComparator) Returns the last contact in the ordered set where classNameId = ? and classPK = ?.
Contact[]	findByC_C_PrevAndNext(long contactId, long classNameId, long classPK, OrderByComparator orderByComparator) Returns the contacts before and after the current contact in the ordered set where classNameId = ? and classPK = ?.
List<Contact>	findByC_C(long classNameId, long classPK) Returns all the contacts where classNameId = ? and classPK = ?.
List<Contact>	findByC_C(long classNameId, long classPK, int start, int end) Returns a range of all the contacts where classNameId = ? and classPK = ?.
List<Contact>	findByC_C(long classNameId, long classPK, int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the contacts where classNameId = ? and classPK = ?.
Contact	findByCompanyId_First(long companyId, OrderByComparator orderByComparator) Returns the first contact in the ordered set where companyId = ?.
Contact	findByCompanyId_Last(long companyId, OrderByComparator orderByComparator) Returns the last contact in the ordered set where companyId = ?.
Contact[]	findByCompanyId_PrevAndNext(long contactId, long companyId, OrderByComparator orderByComparator) Returns the contacts before and after the current contact in the ordered set where companyId = ?.
List<Contact>	findByCompanyId(long companyId) Returns all the contacts where companyId = ?.
List<Contact>	findByCompanyId(long companyId, int start, int end) Returns a range of all the contacts where companyId = ?.
List<Contact>	findByCompanyId(long companyId, int start, int end, OrderByComparator orderByComparator) Returns an ordered range of all the contacts where companyId = ?.
Contact	findByPrimaryKey(long contactId) Returns the contact with the primary key or throws a NoSuchContactException if it could not be found.
Contact	remove(long contactId) Removes the contact with the primary key from the database.
void	removeAll() Removes all the contacts from the database.
void	removeByAccountId(long accountId) Removes all the contacts where accountId = ? from the database.
void	removeByC_C(long classNameId, long classPK) Removes all the contacts where classNameId = ? and classPK = ? from the database.
void	removeByCompanyId(long companyId) Removes all the contacts where companyId = ? from the database.
Contact	updateImpl(Contact contact)

Methods inherited from interface com.liferay.portal.service.persistence.BasePersistence

clearCache, clearCache, clearCache, closeSession, countWithDynamicQuery, countWithDynamicQuery, fetchByPrimaryKey, findByPrimaryKey, findWithDynamicQuery, findWithDynamicQuery, findWithDynamicQuery, flush, getCurrentSession, getDataSource, getListeners, getModelClass, openSession, processException, registerListener, remove, remove, setDataSource, unregisterListener, update, update, update, update

Method Detail

findByCompanyId

List<Contact> findByCompanyId(long companyId)
                              throws SystemException

Returns all the contacts where companyId = ?.

Parameters:

companyId - the company ID

Returns:

the matching contacts

Throws:

SystemException - if a system exception occurred

findByCompanyId

List<Contact> findByCompanyId(long companyId,
                              int start,
                              int end)
                              throws SystemException

Returns a range of all the contacts where companyId = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

companyId - the company ID

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

Returns:

the range of matching contacts

Throws:

SystemException - if a system exception occurred

findByCompanyId

List<Contact> findByCompanyId(long companyId,
                              int start,
                              int end,
                              OrderByComparator orderByComparator)
                              throws SystemException

Returns an ordered range of all the contacts where companyId = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

companyId - the company ID

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of matching contacts

Throws:

SystemException - if a system exception occurred

findByCompanyId_First

Contact findByCompanyId_First(long companyId,
                              OrderByComparator orderByComparator)
                              throws NoSuchContactException,
                                     SystemException

Returns the first contact in the ordered set where companyId = ?.

Parameters:

companyId - the company ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByCompanyId_First

Contact fetchByCompanyId_First(long companyId,
                               OrderByComparator orderByComparator)
                               throws SystemException

Returns the first contact in the ordered set where companyId = ?.

Parameters:

companyId - the company ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByCompanyId_Last

Contact findByCompanyId_Last(long companyId,
                             OrderByComparator orderByComparator)
                             throws NoSuchContactException,
                                    SystemException

Returns the last contact in the ordered set where companyId = ?.

Parameters:

companyId - the company ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByCompanyId_Last

Contact fetchByCompanyId_Last(long companyId,
                              OrderByComparator orderByComparator)
                              throws SystemException

Returns the last contact in the ordered set where companyId = ?.

Parameters:

companyId - the company ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByCompanyId_PrevAndNext

Contact[] findByCompanyId_PrevAndNext(long contactId,
                                      long companyId,
                                      OrderByComparator orderByComparator)
                                      throws NoSuchContactException,
                                             SystemException

Returns the contacts before and after the current contact in the ordered set where companyId = ?.

Parameters:

contactId - the primary key of the current contact

companyId - the company ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the previous, current, and next contact

Throws:

NoSuchContactException - if a contact with the primary key could not be found

SystemException - if a system exception occurred

removeByCompanyId

void removeByCompanyId(long companyId)
                       throws SystemException

Removes all the contacts where companyId = ? from the database.

Parameters:

companyId - the company ID

Throws:

SystemException - if a system exception occurred

countByCompanyId

int countByCompanyId(long companyId)
                     throws SystemException

Returns the number of contacts where companyId = ?.

Parameters:

companyId - the company ID

Returns:

the number of matching contacts

Throws:

SystemException - if a system exception occurred

findByAccountId

List<Contact> findByAccountId(long accountId)
                              throws SystemException

Returns all the contacts where accountId = ?.

Parameters:

accountId - the account ID

Returns:

the matching contacts

Throws:

SystemException - if a system exception occurred

findByAccountId

List<Contact> findByAccountId(long accountId,
                              int start,
                              int end)
                              throws SystemException

Returns a range of all the contacts where accountId = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

accountId - the account ID

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

Returns:

the range of matching contacts

Throws:

SystemException - if a system exception occurred

findByAccountId

List<Contact> findByAccountId(long accountId,
                              int start,
                              int end,
                              OrderByComparator orderByComparator)
                              throws SystemException

Returns an ordered range of all the contacts where accountId = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

accountId - the account ID

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of matching contacts

Throws:

SystemException - if a system exception occurred

findByAccountId_First

Contact findByAccountId_First(long accountId,
                              OrderByComparator orderByComparator)
                              throws NoSuchContactException,
                                     SystemException

Returns the first contact in the ordered set where accountId = ?.

Parameters:

accountId - the account ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByAccountId_First

Contact fetchByAccountId_First(long accountId,
                               OrderByComparator orderByComparator)
                               throws SystemException

Returns the first contact in the ordered set where accountId = ?.

Parameters:

accountId - the account ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByAccountId_Last

Contact findByAccountId_Last(long accountId,
                             OrderByComparator orderByComparator)
                             throws NoSuchContactException,
                                    SystemException

Returns the last contact in the ordered set where accountId = ?.

Parameters:

accountId - the account ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByAccountId_Last

Contact fetchByAccountId_Last(long accountId,
                              OrderByComparator orderByComparator)
                              throws SystemException

Returns the last contact in the ordered set where accountId = ?.

Parameters:

accountId - the account ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByAccountId_PrevAndNext

Contact[] findByAccountId_PrevAndNext(long contactId,
                                      long accountId,
                                      OrderByComparator orderByComparator)
                                      throws NoSuchContactException,
                                             SystemException

Returns the contacts before and after the current contact in the ordered set where accountId = ?.

Parameters:

contactId - the primary key of the current contact

accountId - the account ID

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the previous, current, and next contact

Throws:

NoSuchContactException - if a contact with the primary key could not be found

SystemException - if a system exception occurred

removeByAccountId

void removeByAccountId(long accountId)
                       throws SystemException

Removes all the contacts where accountId = ? from the database.

Parameters:

accountId - the account ID

Throws:

SystemException - if a system exception occurred

countByAccountId

int countByAccountId(long accountId)
                     throws SystemException

Returns the number of contacts where accountId = ?.

Parameters:

accountId - the account ID

Returns:

the number of matching contacts

Throws:

SystemException - if a system exception occurred

findByC_C

List<Contact> findByC_C(long classNameId,
                        long classPK)
                        throws SystemException

Returns all the contacts where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

Returns:

the matching contacts

Throws:

SystemException - if a system exception occurred

findByC_C

List<Contact> findByC_C(long classNameId,
                        long classPK,
                        int start,
                        int end)
                        throws SystemException

Returns a range of all the contacts where classNameId = ? and classPK = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

classNameId - the class name ID

classPK - the class p k

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

Returns:

the range of matching contacts

Throws:

SystemException - if a system exception occurred

findByC_C

List<Contact> findByC_C(long classNameId,
                        long classPK,
                        int start,
                        int end,
                        OrderByComparator orderByComparator)
                        throws SystemException

Returns an ordered range of all the contacts where classNameId = ? and classPK = ?.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

classNameId - the class name ID

classPK - the class p k

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of matching contacts

Throws:

SystemException - if a system exception occurred

findByC_C_First

Contact findByC_C_First(long classNameId,
                        long classPK,
                        OrderByComparator orderByComparator)
                        throws NoSuchContactException,
                               SystemException

Returns the first contact in the ordered set where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByC_C_First

Contact fetchByC_C_First(long classNameId,
                         long classPK,
                         OrderByComparator orderByComparator)
                         throws SystemException

Returns the first contact in the ordered set where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the first matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByC_C_Last

Contact findByC_C_Last(long classNameId,
                       long classPK,
                       OrderByComparator orderByComparator)
                       throws NoSuchContactException,
                              SystemException

Returns the last contact in the ordered set where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact

Throws:

NoSuchContactException - if a matching contact could not be found

SystemException - if a system exception occurred

fetchByC_C_Last

Contact fetchByC_C_Last(long classNameId,
                        long classPK,
                        OrderByComparator orderByComparator)
                        throws SystemException

Returns the last contact in the ordered set where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the last matching contact, or null if a matching contact could not be found

Throws:

SystemException - if a system exception occurred

findByC_C_PrevAndNext

Contact[] findByC_C_PrevAndNext(long contactId,
                                long classNameId,
                                long classPK,
                                OrderByComparator orderByComparator)
                                throws NoSuchContactException,
                                       SystemException

Returns the contacts before and after the current contact in the ordered set where classNameId = ? and classPK = ?.

Parameters:

contactId - the primary key of the current contact

classNameId - the class name ID

classPK - the class p k

orderByComparator - the comparator to order the set by (optionally null)

Returns:

the previous, current, and next contact

Throws:

NoSuchContactException - if a contact with the primary key could not be found

SystemException - if a system exception occurred

removeByC_C

void removeByC_C(long classNameId,
                 long classPK)
                 throws SystemException

Removes all the contacts where classNameId = ? and classPK = ? from the database.

Parameters:

classNameId - the class name ID

classPK - the class p k

Throws:

SystemException - if a system exception occurred

countByC_C

int countByC_C(long classNameId,
               long classPK)
               throws SystemException

Returns the number of contacts where classNameId = ? and classPK = ?.

Parameters:

classNameId - the class name ID

classPK - the class p k

Returns:

the number of matching contacts

Throws:

SystemException - if a system exception occurred

cacheResult

void cacheResult(Contact contact)

Caches the contact in the entity cache if it is enabled.

Parameters:

contact - the contact

cacheResult

void cacheResult(List<Contact> contacts)

Caches the contacts in the entity cache if it is enabled.

Parameters:

contacts - the contacts

create

Contact create(long contactId)

Creates a new contact with the primary key. Does not add the contact to the database.

Parameters:

contactId - the primary key for the new contact

Returns:

the new contact

remove

Contact remove(long contactId)
               throws NoSuchContactException,
                      SystemException

Removes the contact with the primary key from the database. Also notifies the appropriate model listeners.

Parameters:

contactId - the primary key of the contact

Returns:

the contact that was removed

Throws:

NoSuchContactException - if a contact with the primary key could not be found

SystemException - if a system exception occurred

updateImpl

Contact updateImpl(Contact contact)
                   throws SystemException

Throws:

SystemException

findByPrimaryKey

Contact findByPrimaryKey(long contactId)
                         throws NoSuchContactException,
                                SystemException

Returns the contact with the primary key or throws a NoSuchContactException if it could not be found.

Parameters:

contactId - the primary key of the contact

Returns:

the contact

Throws:

NoSuchContactException - if a contact with the primary key could not be found

SystemException - if a system exception occurred

fetchByPrimaryKey

Contact fetchByPrimaryKey(long contactId)
                          throws SystemException

Returns the contact with the primary key or returns null if it could not be found.

Parameters:

contactId - the primary key of the contact

Returns:

the contact, or null if a contact with the primary key could not be found

Throws:

SystemException - if a system exception occurred

findAll

List<Contact> findAll()
                      throws SystemException

Returns all the contacts.

Returns:

the contacts

Throws:

SystemException - if a system exception occurred

findAll

List<Contact> findAll(int start,
                      int end)
                      throws SystemException

Returns a range of all the contacts.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

Returns:

the range of contacts

Throws:

SystemException - if a system exception occurred

findAll

List<Contact> findAll(int start,
                      int end,
                      OrderByComparator orderByComparator)
                      throws SystemException

Returns an ordered range of all the contacts.

Useful when paginating results. Returns a maximum of end - start instances. start and end are not primary keys, they are indexes in the result set. Thus, 0 refers to the first result in the set. Setting both start and end to QueryUtil.ALL_POS will return the full result set. If orderByComparator is specified, then the query will include the given ORDER BY logic. If orderByComparator is absent and pagination is required (start and end are not QueryUtil.ALL_POS), then the query will include the default ORDER BY logic from ContactModelImpl. If both orderByComparator and pagination are absent, for performance reasons, the query will not have an ORDER BY clause and the returned result set will be sorted on by the primary key in an ascending order.

Parameters:

start - the lower bound of the range of contacts

end - the upper bound of the range of contacts (not inclusive)

orderByComparator - the comparator to order the results by (optionally null)

Returns:

the ordered range of contacts

Throws:

SystemException - if a system exception occurred

removeAll

void removeAll()
               throws SystemException

Removes all the contacts from the database.

Throws:

SystemException - if a system exception occurred

countAll

int countAll()
             throws SystemException

Returns the number of contacts.

Returns:

the number of contacts

Throws:

SystemException - if a system exception occurred