com.compoze.collab.groupware
Interface IAddressEntryContainer

All Superinterfaces

IContainer, IItem, Serializable

public interface IAddressEntryContainer
extends IContainer

This interface provides the necessary functionality to get addresses from an address list. The container class is container.address_entry.

Field Summary

static ContainerClass

CLASS The ContainerClass that represents an IAddressEntryContainer.

Fields inherited from interface com.compoze.collab.IContainer

CONTAINER_CLASS, HAS_SUBCONTAINERS, HOLDS_ITEMS, HOLDS_SUBCONTAINERS, KEYID_CONTAINER_CLASS, KEYID_HAS_SUBCONTAINERS, KEYID_HOLDS_ITEMS, KEYID_HOLDS_SUBCONTAINERS, KEYID_NAME, KEYID_SUBCONTAINER_COUNT, MINIMUM_CONTAINER_KEYS, NAME, SUBCONTAINER_COUNT

Fields inherited from interface com.compoze.collab.IItem

ID, ITEM_CLASS, KEYID_ID, KEYID_ITEM_CLASS, KEYID_PARENT_ID, MINIMUM_ITEM_KEYS, PARENT_ID

Method Summary

IAddressEntry[]	getEntries() Gets the address entries from the address container.
IAddressEntry[]	getEntries(QueryProfile queryProfile) Gets the address entries from the address container matching a QueryProfile.
IAddressEntryList	getEntries(QueryProfile queryProfile, int iPageSize, int iPage) Gets the address entries from the address container matching a QueryProfile.
IAddressEntry[]	resolve(String sInfo, FetchProfile fp) Resolves the string to address entries.

Methods inherited from interface com.compoze.collab.IContainer

add, add, add, addSubcontainer, copyTo, getContainerClass, getItemCount, getItemCount, getItems, getItems, getItems, getItems, getItems, getName, getSubcontainer, getSubcontainer, getSubcontainers, getSubcontainers, hasSubcontainer, holdsItems, holdsSubcontainers, isUnder, moveTo, setName

Methods inherited from interface com.compoze.collab.IItem

commit, containsKey, containsKey, copyProperties, delete, fetchProperties, getAttribute, getEnum, getID, getInputStream, getItemClass, getOutputStream, getParent, getParent, getParentID, getProperties, getProperties, getProperties, getProperty, getProperty, getProperty, getReader, getRootContainer, getSession, getWriter, isMissing, removeAttribute, removeProperty, setAttribute, setProperties, setProperty, setProperty, setProperty

Field Detail

CLASS

static final ContainerClass CLASS

The ContainerClass that represents an IAddressEntryContainer.

Method Detail

getEntries

IAddressEntry[] getEntries()
                           throws CollaborationException

Gets the address entries from the address container.

Returns

an array of address entries from the address container.

Throws

CollaborationException - if there was an error getting the entries

getEntries

IAddressEntry[] getEntries(QueryProfile queryProfile)
                           throws CollaborationException

Gets the address entries from the address container matching a QueryProfile.

Parameters

queryProfile - the query profile to match

Returns

an array of address entries from the address container.

Throws

CollaborationException - if there was an error getting the entries

getEntries

IAddressEntryList getEntries(QueryProfile queryProfile,
                             int iPageSize,
                             int iPage)
                             throws CollaborationException

Gets the address entries from the address container matching a QueryProfile.

Parameters

queryProfile - the query profile to match

iPageSize - the count of address entries that make a 'page' (<=0 for all)

iPage - the page number to fetch (must be >=1)

Returns

the address entries

Throws

CollaborationException - if there was an error getting the entries

resolve

IAddressEntry[] resolve(String sInfo,
                        FetchProfile fp)
                        throws CollaborationException

Resolves the string to address entries. The user information can be a name or part of the SMTP address. The steps are taken to resolve a name against the address list:

• If the info contains an '@', create a prefix, no-case content restriction with IAddressEntry.SMTP_ADDRESS.
• Otherwise use an OR restriction of (all ignoring case):
  • IAddressEntry.FIRST_NAME prefix.
  • IAddressEntry.LAST_NAME prefix.
  • IAddressEntry.SMTP_ADDRESS prefix.

Parameters

sInfo - the user info to resolve

fp - the fetch profile to use when fetching

Returns

an array of address entries (length = 0, unresolved; length = 1, resolved; >1, ambiguous entries

Throws

CollaborationException - if there was an error resolving the info