src/include/symbian/spdm/DeviceManagementNode.h

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_SYMBIAN_DEVICE_MANAGEMENT_NODE
00037 #define INCL_SYMBIAN_DEVICE_MANAGEMENT_NODE
00038 
00040 #include <syncmldef.h>
00041 #include <string.h>
00042 
00043 #include "base/globalsdef.h"
00044 #include "base/fscapi.h"
00045 #include "base/util/ArrayElement.h"
00046 #include "spdm/ManagementNode.h"
00047 #include "base/util/StringBuffer.h"
00048 
00049 
00050 BEGIN_NAMESPACE
00051 
00052 /*
00053  * File-based implementation of ManagementNode.
00054  * Each node is mapped to one file, located in
00055  *    $HOME/.sync4j/<node>
00056  * with entries of the type
00057  * <property>\s*=\s*<value>\n
00058  *
00059  * Comments look like:
00060  * \s*# <comment>
00061  */
00062 class DeviceManagementNode : public ManagementNode {
00063 
00064 protected:
00065     ArrayList *lines;
00066     bool modified;
00067     char *prefix;
00068     static StringBuffer configFile;
00069 
00070     // the application's working directory
00071     StringBuffer currentDir;
00072 
00073     // change into directory which holds config file,
00074     // creating directories if necessary for writing
00075     //
00076     // @return true for success, false for error - call returnFromDir() in both cases
00077     bool gotoDir(bool read);
00078 
00079     // return to original directory after a gotoDir()
00080     void returnFromDir();
00081 
00082     // copy content of "lines" to or from file
00083     void update(bool read);
00084 
00085     // String compare case insensitive
00086     int strnicmp( const char *a, const char *b, int len );
00087 
00088     // Initialize current dir. Current dir is initialized as configPath +
00089     // context + name
00090     void initCurrentDir();
00091 
00092     // Rename a file in the current working directory (currentDir)
00093     int renameFileInCwd(const char* src, const char* dst);
00094 
00095 #if defined(UPDATE_NATIVE_CONFIG)
00096     // Push configuration parameters into the native configuration (only for
00097     // paramters that apply)
00098     void pushSymbianSyncMLConfigParameter(const char* property,
00099                                           const char* value);
00100 #endif
00101 
00102     private:
00103 
00104     static StringBuffer  configPath;
00105 
00106     public:
00107 
00108         // ------------------------------------------ Constructors & destructors
00109 
00118         DeviceManagementNode(const char* parent, const char *leafName);
00119         DeviceManagementNode(const char* fullName);
00120 
00121         DeviceManagementNode(const DeviceManagementNode &other);
00122         virtual ~DeviceManagementNode();
00123 
00124         static void setConfigPath(const StringBuffer &p)        { configPath = p;       }
00125         static const StringBuffer& getConfigPath()              { return configPath;    }
00126         void lookupDir();
00127         
00128         // ----------------------------------------------------- Virtual methods
00129 
00130         /*
00131          * Returns the value of the given property
00132          *
00133          * @param property - the property name
00134          */
00135         virtual char* readPropertyValue(const char* property);
00136 
00137 
00138         /*
00139          * Sets a property value.
00140          *
00141          * @param property - the property name
00142          * @param value - the property value (zero terminated string)
00143          */
00144         virtual void setPropertyValue(const char* property, const char* value);
00145 
00146         /*
00147          * Returns the children's name of the parent node.
00148          */
00149         char **getChildrenNames();
00150 
00151         /*
00152          * Find how many children are defined for this node in the underlying
00153          * config system.
00154          */
00155         virtual int getChildrenMaxCount();
00156 
00157         /*
00158          * Creates a new ManagementNode with the exact content of this object.
00159          * The new instance MUST be created with the C++ new opertator.
00160          */
00161         virtual ArrayElement* clone();
00162 
00163         static void  setServerURI(const StringBuffer& server);
00164         static const StringBuffer& getServerURI();
00165 
00166         static void  setProfileName(const StringBuffer& name);
00167         static const StringBuffer& getProfileName();
00168 
00169         static void  setUID(TSmlCreatorId uid);
00170         static TSmlCreatorId getUID();
00171 
00172         static void setCardURI(const StringBuffer& cardURI);
00173         static const StringBuffer& getCardURI();
00174 
00175         static void setCalURI(const StringBuffer& calURI);
00176         static const StringBuffer& getCalURI();
00177 
00178         static void setImapServer(const StringBuffer& imapServer);
00179         static const StringBuffer& getImapServer();
00180 
00181         static void setImapPort(unsigned int imapPort);
00182         static unsigned int getImapPort();
00183 
00184         static void setSmtpServer(const StringBuffer& smtpServer);
00185         static const StringBuffer& getSmtpServer();
00186 
00187         static void setSmtpPort(unsigned int smtpPort);
00188         static unsigned int getSmtpPort();
00189 };
00190 
00191 
00192 END_NAMESPACE
00193 
00195 #endif

Generated on Wed Jan 14 17:15:37 2009 for Funambol C++ Client Library by  doxygen 1.5.2