Meego Wiki
Views

Architecture/planning/evolution-data-server/email-design

From MeeGo wiki
(Difference between revisions)
Jump to: navigation, search
(QtMobility support)
(QtMobility support)
Line 51: Line 51:
3rd party apps will use QtMobility to interface with email framework than the raw DBus apis.
3rd party apps will use QtMobility to interface with email framework than the raw DBus apis.
-
The QtMessaging module is a QtMobility module providing access to messaging services.  
+
The [http://doc.qt.nokia.com/qtmobility-1.2/qtmessaging.html QtMessaging] module is a QtMobility module providing access to messaging services.  
In order to provide implementation of QtMessaging interfaces a new dynamic library should be created. <br>
In order to provide implementation of QtMessaging interfaces a new dynamic library should be created. <br>
Line 69: Line 69:
|Should be implemented from scratch
|Should be implemented from scratch
|Simple aux object. QMF implementation can be used.  
|Simple aux object. QMF implementation can be used.  
 +
 +
|-
 +
|QMessage
 +
|Camel.MessageInfo <br> CamelMessageInfoBase
 +
|Message flags are different. Some properties are missing but can be calculated.
 +
|Camel.MessageInfo can be mapped to QMessage.
 +
 +
|-
 +
|QMessageAccount
 +
|EAccount
 +
|Needed functionality is supported.
 +
|EAccount can be mapped to QMessageAccount
 +
|-
 +
|QMessageAccountFilter
 +
|Does not exist
 +
|Should be implemented from scratch
 +
|QtMessaging allows not support it or support partially.<br> Should store search parameters and QMessageManager class should cosider them while accounts querying. Implementation  of  logical operators is the most difficult part..
 +
 +
|-
 +
|QMessageAccountId
 +
|Eaccount->uid
 +
|Should be implemented from scratch
 +
|Easy-to-implement object. Will just contain 'Eaccount->uid' inside
 +
 +
|-
 +
|QMessageAccountSortOrder
 +
|Does not exist
 +
|Should be implemented from scratch
 +
|QtMessaging allows not support it or support partially.<br> Easy-to-implement object. Should store sorting mode and QMessageManager class must consider it while  account querying.
 +
|}
|}

Revision as of 12:16, 16 June 2011

EMailFactory will be a dbus daemon, that runs camel session. The camel session controls the providers of IMAP/POP/Exchange/* and keeps checking emails, and serves CamelStore/CamelFolder/CamelMimeMessage/* over DBUS to its clients. Below is a high level architecture diagram of how the various pieces fit together, displayed below.

Email-daemon-design-complete-1.png


Contents

Source

The Camel Daemon code is now in gnome git, in the email-factory branch.
http://git.gnome.org/browse/evolution-data-server/log/?h=email-factory has the code the for the daemon:

The DBus API currently provided by the Daemon is below. In a high level, it is a async wrapper around the camel's session/folder/store API.
http://git.gnome.org/browse/evolution-data-server/tree/mail/daemon/e-mail-data-folder.xml?h=email-factory
http://git.gnome.org/browse/evolution-data-server/tree/mail/daemon/e-mail-data-store.xml?h=email-factory
http://git.gnome.org/browse/evolution-data-server/tree/mail/daemon/e-mail-data-session.xml?h=email-factory

About Camel Daemon

Camel Daemon (The EMail factory) is a process that runs camel session. A high level picture of the daemon is below: Cameldesign.png

MeeGo Tablet mail integration

  • Integrate Account setup with EAccountList/EAccount in Gconf.

It could be a challenge to verify accounts. As Evolution doesn't do that yet. It runs accounts and reports error if its not right.

  • Deeply integrate the camel daemon's dbus api into the email app

Have the working C++ dbus interface for the Camel daemon, created working instances & marshaling code etc. Moved away the base objects of folderlistmodel, emailaccountlistmodel and emailmessagelist model from QMF baseclass to QAbstract*Model. Implemented these models to pick up data from Camel daemon. Modified a bit of QML set the folder/account correctly.
Pending:

  1. Modify EmailAgent, in a way it send/receives mails to Camel
  2. Modify EMailFeedModel to handle EmailMessage creation from Camel.
  3. Integrate CamelMimeMessage & mime part hierarchy for things like attachment handling, plain text and html body.
  4. Composer integration & sending mails.
  5. Mail operations handling: like create/delete mail/folder, reply/forward, mark read/unread, sort, search.


  • Camel API:

Almost complete to suffice our need, have a test code that runs through all the APIs and work well so far. Expect a few minor changes here & there on demand.

Pending:

  1. Write libcamelremote a wrapper around the DBus interface to provide sync/async apis for the camel Daemon.


  • Camel Daemon:

Works mostly, and is pretty stable than expected. But should spend some time & check on the CPU usage,dbus connection handling, and object clean ups.

  1. DBus conneciton handling & object clean ups.
  2. EMail preview support. Anjal used to extend evolution to add email preview of unquoted text. I should add
    that bit to Camel so that it can be served to the tablet email app.
  3. Gtk free the daemon. Specially the password dialog. Add signal to integrate with clients for password handling. Add better error handling and progress reporting.


QtMobility support

3rd party apps will use QtMobility to interface with email framework than the raw DBus apis.

The QtMessaging module is a QtMobility module providing access to messaging services.

In order to provide implementation of QtMessaging interfaces a new dynamic library should be created.
The library should be loaded into email client application process.
The library should expose QtMessaging interfaces and map QtMessaging api to Camel daemon dBus api.
Possibility of direct read from Camel local storage shall be discussed.

The analysis of how QtMessaging interfaces can be implemented via Camel back-end is shown on table below.

QtMessaging interface Implementation in Camel back-end Missing features Solution
QMessageDataComparator Does not exist Should be implemented from scratch Simple aux object. QMF implementation can be used.
QMessage Camel.MessageInfo
CamelMessageInfoBase
Message flags are different. Some properties are missing but can be calculated. Camel.MessageInfo can be mapped to QMessage.
QMessageAccount EAccount Needed functionality is supported. EAccount can be mapped to QMessageAccount
QMessageAccountFilter Does not exist Should be implemented from scratch QtMessaging allows not support it or support partially.
Should store search parameters and QMessageManager class should cosider them while accounts querying. Implementation of logical operators is the most difficult part..
QMessageAccountId Eaccount->uid Should be implemented from scratch Easy-to-implement object. Will just contain 'Eaccount->uid' inside
QMessageAccountSortOrder Does not exist Should be implemented from scratch QtMessaging allows not support it or support partially.
Easy-to-implement object. Should store sorting mode and QMessageManager class must consider it while account querying.


Personal tools