00001 /* 00002 * Funambol is a mobile platform developed by Funambol, Inc. 00003 * Copyright (C) 2003 - 2007 Funambol, Inc. 00004 * 00005 * This program is free software; you can redistribute it and/or modify it under 00006 * the terms of the GNU Affero General Public License version 3 as published by 00007 * the Free Software Foundation with the addition of the following permission 00008 * added to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED 00009 * WORK IN WHICH THE COPYRIGHT IS OWNED BY FUNAMBOL, FUNAMBOL DISCLAIMS THE 00010 * WARRANTY OF NON INFRINGEMENT OF THIRD PARTY RIGHTS. 00011 * 00012 * This program is distributed in the hope that it will be useful, but WITHOUT 00013 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS 00014 * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more 00015 * details. 00016 * 00017 * You should have received a copy of the GNU Affero General Public License 00018 * along with this program; if not, see http://www.gnu.org/licenses or write to 00019 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, 00020 * MA 02110-1301 USA. 00021 * 00022 * You can contact Funambol, Inc. headquarters at 643 Bair Island Road, Suite 00023 * 305, Redwood City, CA 94063, USA, or at email address info@funambol.com. 00024 * 00025 * The interactive user interfaces in modified source and object code versions 00026 * of this program must display Appropriate Legal Notices, as required under 00027 * Section 5 of the GNU Affero General Public License version 3. 00028 * 00029 * In accordance with Section 7(b) of the GNU Affero General Public License 00030 * version 3, these Appropriate Legal Notices must retain the display of the 00031 * "Powered by Funambol" logo. If the display of the logo is not reasonably 00032 * feasible for technical reasons, the Appropriate Legal Notices must display 00033 * the words "Powered by Funambol". 00034 */ 00035 00036 #ifndef INCL_CLIENTAPPLICATION 00037 #define INCL_CLIENTAPPLICATION 00038 00044 #include "outlook/defs.h" 00045 #include "outlook/ClientFolder.h" 00046 #include "outlook/ClientItem.h" 00047 #include "outlook/ClientMail.h" 00048 #include "outlook/ClientContact.h" 00049 #include "outlook/ClientAppointment.h" 00050 #include "outlook/ClientTask.h" 00051 #include "outlook/ClientNote.h" 00052 00053 #include <string> 00054 00055 00066 class ClientApplication { 00067 00068 private: 00069 00071 static ClientApplication* pinstance; 00072 00074 std::wstring version; 00076 std::wstring programName; 00077 00078 00079 // Pointers to microsoft outlook objects. 00080 _ApplicationPtr pApp; 00081 _NameSpacePtr pMAPI; 00082 MAPIFolderPtr pFolder; 00083 00084 // Pointer to Redemption safe objects. 00085 Redemption::IMAPIUtilsPtr pRedUtils; 00086 Redemption::IRDOSessionPtr rdoSession; 00087 00088 00089 // Internal ClientObjects: 00090 // 'get..()' methods always return references to these objects 00091 ClientFolder* folder; 00092 ClientMail* mail; 00093 ClientContact* contact; 00094 ClientAppointment* appointment; 00095 ClientTask* task; 00096 ClientNote* note; 00097 00098 00100 HRESULT hr; 00101 00102 void createSafeInstances(); 00103 00104 00105 protected: 00106 00107 // Constructor 00108 ClientApplication(); 00109 00110 00111 public: 00112 00113 // Method to get the sole instance of ClientApplication 00114 static ClientApplication* getInstance(); 00115 00116 // Returns true if static instance is not NULL. 00117 static bool isInstantiated(); 00118 00119 // Destructor 00120 ~ClientApplication(); 00121 00122 00123 const std::wstring& getVersion(); 00124 const std::wstring& getName(); 00125 00126 00127 ClientFolder* getDefaultFolder (const std::wstring& itemType); 00128 ClientFolder* getFolderFromID (const std::wstring& folderID); 00129 ClientFolder* pickFolder (); 00130 ClientFolder* pickFolder (const std::wstring& itemType); 00131 ClientFolder* getFolderFromPath (const std::wstring& itemType, const std::wstring& path); 00132 ClientFolder* getDefaultRootFolder (); 00133 ClientFolder* getRootFolder (const int index); 00134 ClientFolder* getRootFolderFromName(const std::wstring& folderName); 00135 00136 ClientItem* getItemFromID (const std::wstring& itemID, const std::wstring& itemType); 00137 00138 00139 // Utility to release shared objects of Outlook session. 00140 HRESULT cleanUp(); 00141 00142 // Utility to convert an Exchange mail address into a SMTP address. 00143 std::wstring getSMTPfromEX(const std::wstring& EXAddress); 00144 00145 // Utility to get body of a specified item (used for notes body which is protected). 00146 std::wstring getBodyFromID(const std::wstring& itemID); 00147 00148 // Utility to retrieve the userName of current profile used. 00149 std::wstring getCurrentProfileName(); 00150 00151 // Returns true if Outlook MAPI object is logged on. 00152 const bool isLoggedOn(); 00153 }; 00154 00157 #endif