emailservices/nmclientapi/src/nmapimessagemanager.cpp
changeset 74 6c59112cfd31
parent 68 83cc6bae1de8
--- a/emailservices/nmclientapi/src/nmapimessagemanager.cpp	Wed Sep 15 17:47:19 2010 +0300
+++ b/emailservices/nmclientapi/src/nmapimessagemanager.cpp	Thu Sep 30 11:43:07 2010 +0300
@@ -35,42 +35,43 @@
 
 NmApiMessageManager::~NmApiMessageManager()
 {
-	delete d;
 }
    
-
-    // creates a new email message
-    // signaled with draftMessageCreated(NmApiMessage *message,int result) 
-    //    * ownership transferred
-bool NmApiMessageManager::createDraftMessage(const QVariant *initData)
+/*!
+ \fn createDraftMessage 
+ \param initData Initializing data. Can contain NULL value.
+ \return Create draft message operation.
+ 
+ Creates a new email message. Returns create draft message operation. 
+ */
+QPointer<NmApiOperation> NmApiMessageManager::createDraftMessage(const QVariant *initData)
 {
     NM_FUNCTION;
-    Q_UNUSED(initData);
-	return false;
+    return d->createDraftMessage(initData);
 }
     
     // creates fw message
     // signaled with forwardMessageCreated(NmApiMessage *message,int result) 
     //    * ownership transferred
- bool NmApiMessageManager::createForwardMessage(NmApiMessage *orig,const QVariant *initData)
+QPointer<NmApiOperation> NmApiMessageManager::createForwardMessage(NmApiMessage *orig,const QVariant *initData)
  {
     NM_FUNCTION;
     Q_UNUSED(initData);
     Q_UNUSED(orig);
-	return false;
+	return 0;
  }
     
     // creates reply message
     // signaled with replyMessageCreated(NmApiMessage *message,int result) 
     //    * ownership transferred
-bool NmApiMessageManager::createReplyMessage(const NmApiMessage *orig,
+QPointer<NmApiOperation> NmApiMessageManager::createReplyMessage(const NmApiMessage *orig,
         const QVariant *initData,bool replyAll)
 {
     NM_FUNCTION;
     Q_UNUSED(orig);
     Q_UNUSED(initData);
     Q_UNUSED(replyAll);
-	return false;
+	return 0;
 }
  
 /*!
@@ -83,7 +84,7 @@
  Starts async move operation for given messages.  
  Completion signalled with messagesMoved(int result).
  */
-bool NmApiMessageManager::moveMessages(const QList<quint64> messageIds,
+QPointer<NmApiOperation> NmApiMessageManager::moveMessages(const QList<quint64> messageIds,
 									quint64 sourceFolderId,
 									quint64 targetFolderId)
 {    
@@ -91,68 +92,82 @@
     Q_UNUSED(messageIds);
     Q_UNUSED(sourceFolderId);
     Q_UNUSED(targetFolderId);
-    return false;
+    return 0;
 	//return d->moveMessages(messageIds,sourceFolderId,targetFolderId);
 }
     
-// signaled with messageSaved(quint64 messageId, int result)
-bool NmApiMessageManager::saveMessage(const NmApiMessage &message)
+/*!
+ \fn saveMessage 
+ \param message Message to be saved (note that message must exists to complete successfully).
+ \return Save message operation.
+ 
+ Saves email message. Message must be created before this operation with createDraftMessage/createForwardMessage/
+ createReplyMessage operation. Operation will run unsuccessfully, if message haven't created before. 
+ Returns save message operation. 
+ */
+QPointer<NmApiOperation> NmApiMessageManager::saveMessage(const NmApiMessage &message)
 {
-    Q_UNUSED(message);
-	return false;
+    return d->saveMessage(message);
 }
     
 // deletes message
 // signaled with messagesDeleted(int result)
-bool NmApiMessageManager::deleteMessages(const QList<quint64> messageIds)
+QPointer<NmApiOperation> NmApiMessageManager::deleteMessages(const QList<quint64> messageIds)
 {
     Q_UNUSED(messageIds);
-	return false;
+	return 0;
 }
     
     // starts fetching rest of message body from server
     // signaled with messageFetched(quint64 messageId, int result)
-bool NmApiMessageManager::fetchMessage(quint64 messageId)
+QPointer<NmApiOperation> NmApiMessageManager::fetchMessage(quint64 messageId)
 {
     Q_UNUSED(messageId);
-	return false;
+	return 0;
 }
     
-    // moves message to outbox. Actual sending time may be immediate or scheduled
-    // signaled with messageSent(quint64 messageId, int result)
-bool NmApiMessageManager::sendMessage(const NmApiMessage &message)
+/*!
+ \fn sendMessage 
+ \param message Message to be sent (note that message must exists to complete successfully).
+ \return Send message operation.
+ 
+ Sends email message. Message must be created before this operation with createDraftMessage/createForwardMessage/
+ createReplyMessage operation. Operation will run unsuccessfully, if message haven't created before. 
+ Returns send message operation. 
+ */
+QPointer<NmApiOperation> NmApiMessageManager::sendMessage(const NmApiMessage &message)
 {
-    Q_UNUSED(message);
-	return false;
+    NM_FUNCTION;
+    return d->sendMessage(message);
 }
 
 // creates new attachment for a message. Currently attachment can be specified as file name (attachmentSpec is QString)
 // signaled with attachmentCreated(quint64 attachemntId)
 //  * 
-bool NmApiMessageManager::createAttachment(NmApiMessage &message,
+QPointer<NmApiOperation> NmApiMessageManager::createAttachment(NmApiMessage &message,
 										const QVariant &attachmenSpec)
 {
     Q_UNUSED(message);
     Q_UNUSED(attachmenSpec);
-    return false;
+    return 0;
 }
                                                       
 // removes attachment from a message
 // signaled with attachmentRemoved(int result)
-bool NmApiMessageManager::removeAttachment(NmApiMessage &message,
+QPointer<NmApiOperation> NmApiMessageManager::removeAttachment(NmApiMessage &message,
 quint64 attachmentId)
 {    
     Q_UNUSED(message);
     Q_UNUSED(attachmentId);
-    return false;
+    return 0;
 }
 
-bool NmApiMessageManager::fetchAttachment(const NmApiMessage &relatedMessage,
+QPointer<NmApiOperation> NmApiMessageManager::fetchAttachment(const NmApiMessage &relatedMessage,
         quint64 attachmentId)
 {
     Q_UNUSED(relatedMessage);
     Q_UNUSED(attachmentId);
-    return false;
+    return 0;
 }
  
 } // namespace EmailClientApi