|
Home | |
The Messaging Framework Client library provides a set of APIs for accessing messaging data. Interfaces are provided to create, modify, store, and retrieve messages. The library does not directly support sending or retrieving messages; these actions are currently supported via a service request mechanism.
The Client library provides unified access to the messaging data on a device including concurrent access to messaging data by multiple applications, and independence from the mechanism used to store the messaging data on the device.
For detailed class information refer to: Messaging Classes.
The library is augmented by two related, more specific libraries:
The Client library provides a number of classes to assist with the composition and manipulation of message data. Messages of all supported types are represented uniformly, although not all transport mechanisms are able to deliver more complex message formulations. Messages can be composed of multiple parts and constructed hierarchically. The Client library supports composition of multipart messages from individual part objects.
Classes to assist with composition and manipulation of messages:
| Class | Description |
|---|---|
| QMailMessageId | Represents the mail store identifiers for message records. |
| QMailMessageMetaData | Represents a message stored by the Messaging Framework. |
| QMailMessage | Convenient interface for working with messages. |
| QMailMessagePart | Convenient interface for working with message attachments. |
| QMailMessagePartContainer | Access to a collection of message parts. |
| QMailMessageBody | The body element of a message or message part. |
| QMailMessageHeaderField | Encapsulates the parsing of message header fields. |
| QMailMessageContentDisposition | Encapsulates the parsing of the RFC 2822 'Content-Disposition' header field. |
| QMailMessageContentType | Encapsulates the parsing of the RFC 2822 'Content-Type' header field. |
| QMailAddress | Interface for manipulating message address strings. |
| QMailTimeStamp | Manages message time stamps. |
| QMailCodec | Base class for classes implementing codecs used in message composition. |
The Client Library provides classes for storing information about messaging accounts both outgoing and incoming.
Classes relating to messaging accounts:
| Class | Description |
|---|---|
| QMailAccountId | Represents the mail store identifiers for account records. |
| QMailAccount | Stores attributes for a messaging account. |
| QMailFolderId | Represents the mail store identifiers for folder records. |
| QMailFolder | Represents a folder for messages on the mail store. |
| QMailMessageRemovalRecord | Represents a message deleted from the local mail store. |
| QMailAccountConfiguration | Contains the configuration details for an account. |
The Client Library provides classes for storing information about message threads (a.k.a. conversations).
Classes relating to message threads:
| Class | Description |
|---|---|
| QMailThreadId | Represents the mail store identifiers for thread records. |
| QMailThread | Stores attributes for a message thread. |
The Client library provides classes to assist with displaying lists of message data. These classes allow clients to display lists of messages and accounts with minimal effort, and with minimal resource consumption.
Classes to assist with listing messages:
| Class | Description |
|---|---|
| QMailAccountListModel | Provides a model representing the accounts stored by the Messaging Framework. |
| QMailMessageListModel | Provides a model representing the messages stored by the Messaging Framework. |
The Client library provides classes to assist with partitioning and navigating message data according to the intrinsic message properties. The classes allow clients to display a hierarchical taxonomy of message data, using standard or arbitrary categorization criteria.
Classes to assist with navigating messages:
| Class | Description |
|---|---|
| QMailMessageSet | Provides a representation for a subset of the store's messages, suitable for display in a tree view. |
| QMailAccountMessageSet | Provides a message set implementation grouping messages by their parent account ID. |
| QMailFolderMessageSet | Provides a message set implementation grouping messages by their parent folder ID. |
| QMailFilterMessageSet | Provides a message set implementation grouping messages by arbitrary criteria. |
| QMailMessageSetModel | Provides a model representing arbitrary message sets in a tree arrangement. |
The Client library provides a number of sort and search functions to aid in selecting data most useful to the view requested. This reduces the burden on the application for managing the messaging data, as well as allowing better use of the underlying storage mechanism.
Sorting is accomplished by providing a sorting key, specifying the sort order, and the message property upon which to sort.
Searching is accomplished by providing a search condition, specifying a value, the message property to match, and the desired relation between the value and the message property. Search conditions can be combined to produce searches of arbitrary complexity.
Classes to assist with sorting and searching messages:
| Class | Description |
|---|---|
| QMailStore | Represents the main interface for storage and retrieval of messages and folders on the mail store. |
| QMailAccountKey | Defines the parameters used for querying a subset of all available accounts from the mail store. |
| QMailAccountSortKey | Defines the parameters used for sorting accounts queried from the mail store. |
| QMailFolderKey | Defines the parameters used for querying a subset of all available mail folders from the mail store. |
| QMailFolderSortKey | Defines the parameters used for sorting mail folders queried from the mail store. |
| QMailThreadKey | Defines the parameters used for querying a subset of all available threads from the mail store. |
| QMailThreadSortKey | Defines the parameters used for sorting threads queried from the mail store. |
| QMailMessageKey | Defines the parameters used for querying a subset of all available mail messages from the mail store. |
| QMailMessageSortKey | Defines the parameters used for sorting messages queried from the mail store. |
The Client library uses a plugin system to register components that provide message content management services. Message content can be stored externally to the QMailStore that contains the message meta data; plugins can be implemented to provide the Message Library with access to this content.
Classes supporting the use of plugins for message content management:
| Class | Description |
|---|---|
| QMailContentManager | Defines the interface to objects that provide a message content management service |
| QMailContentManagerFactory | Creates objects implementing the QMailContentManager interface |
| QMailContentManagerPlugin | Defines a base class for implementing message content management plug-ins |
| QMailContentManagerPluginInterface | Defines the interface to plug-ins that provide message content managers |
The Client library provides the QMailMessageServer class, which provides an interface for a messaging client application to communicate with the system's messaging server. The messaging server provides services relating to the transmission and retrieval of messages from various sources defined by QMailAccount objects. Using QMailMessageServer, clients can communicate with the messaging server via local-process signals and slots, without having any direct contact with the server process.
The QMailServiceAction class provides a convenient abstraction above the QMailMessageServer interface, allowing clients to handle only events relating to a specific action requested from the messaging server. QMailRetrievalAction, QMailTransmitAction, QMailStorageAction, QMailSearchAction and QMailProtocolAction specialize QMailServiceAction to implement specific exchanges between a client application and the messaging server.
The Client library provides a level of concurrent access to messaging data by multiple applications. The concurrent access does guarantee that data won't be corrupted by concurrent access, however does not give any guarantees as to performance of messaging data access if accessed concurrently by multiple applications.
The Client library abstracts the storage method used to store messaging data. On a device the Client library will only read and write the primary storage mechanism and synchronizing mechanism.
The performance of the Client library is tested using the reference messageserver implementation included with the Messaging Framework. Various tasks are performed using different amounts and sizes of message to determine the effect these parameters have on the library's performance. Placeholder: The results of these tests would be available <here>, if those results were currently exported.
The Client library requires SQL support either through the included SQLite or through some other SQL engine.
The QMF package contains some example programs that demonstrate how to use the library's functionality.
| Name | Description |
|---|---|
| qtmail | Demonstrates how to build a mail client application. |
| messagingaccounts | Demonstrates how to build a stand alone accounts configuration application. |
| serverobserver | Demonstrates how to build a stand alone application that observes actions being performed by the messageserver process. |
Historical changes in the Client library API are listed in CHANGES.qdoc.
| Copyright © 2010 QtSoftware | Messaging Framework |