src/include/posix/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_POSIX_DEVICE_MANAGEMENT_NODE
00037 #define INCL_POSIX_DEVICE_MANAGEMENT_NODE
00038 
00040 #include <string.h>
00041 
00042 #include "base/globalsdef.h"
00043 #include "base/fscapi.h"
00044 #include "base/util/ArrayElement.h"
00045 #include "spdm/ManagementNode.h"
00046 #include "base/util/StringBuffer.h"
00047 
00048 BEGIN_NAMESPACE
00049 
00050 /*
00051  * File-based implementation of ManagementNode.
00052  * Each node is mapped to one file, located in
00053  *    $HOME/.sync4j/<node>
00054  * with entries of the type
00055  * <property>\s*=\s*<value>\n
00056  *
00057  * Comments look like:
00058  * \s*# <comment>
00059 
00060  */
00061 class DeviceManagementNode : public ManagementNode {
00062 protected:
00063     ArrayList *lines;
00064     bool modified;
00065     char *prefix;
00066 
00067     class line : public ArrayElement {
00068         char *str;
00069 
00070         public:
00071             line(const char *newStr = NULL) { str = NULL; setLine(newStr); }
00072             ~line() { free(str); }
00073             ArrayElement *clone() { return new line(str); }
00074 
00075             const char *getLine() { return str; }
00076             void setLine(const char *newStr) { if (str) { free(str); } str = strdup(newStr ? newStr : ""); }
00077     };
00078 
00079     // the application's working directory
00080     int cwdfd;
00081 
00082     // change into directory which holds config file,
00083     // creating directories if necessary for writing
00084     //
00085     // @return true for success, false for error - call returnFromDir() in both cases
00086     bool gotoDir(bool read);
00087 
00088     // return to original directory after a gotoDir()
00089     void returnFromDir();
00090 
00091     // copy content of "lines" to or from file
00092     void update(bool read);
00093     
00094     int strnicmp( const char *a, const char *b, int len );
00095 
00096 private:
00097     static StringBuffer configPath;
00098     static StringBuffer configFile;
00099     void lookupDir();
00100 
00101     public:
00102 
00103         // ------------------------------------------ Constructors & destructors
00104 
00113         DeviceManagementNode(const char* parent, const char *leafName);
00114         DeviceManagementNode(const char* fullName);
00115 
00116         DeviceManagementNode(const DeviceManagementNode &other);
00117         virtual ~DeviceManagementNode();
00118 
00126         static void setConfigPath(const StringBuffer &p)        { configPath = p;       }
00132         static const StringBuffer& getConfigPath()              { return configPath;    }
00133         
00134         static void setCompatibilityMode(bool mode);
00135 
00136         // ----------------------------------------------------- Virtual methods
00137 
00138         /*
00139          * Returns the value of the given property
00140          *
00141          * @param property - the property name
00142          */
00143         virtual char* readPropertyValue(const char* property);
00144 
00145 
00146         /*
00147          * Sets a property value.
00148          *
00149          * @param property - the property name
00150          * @param value - the property value (zero terminated string)
00151          */
00152         virtual void setPropertyValue(const char* property, const char* value);
00153 
00154         /*
00155          * Returns the children's name of the parent node.
00156          */
00157         char **getChildrenNames();
00158 
00159         /*
00160          * Find how many children are defined for this node in the underlying
00161          * config system.
00162          */
00163         virtual int getChildrenMaxCount();
00164 
00165         /*
00166          * Creates a new ManagementNode with the exact content of this object.
00167          * The new instance MUST be created with the C++ new opertator.
00168          */
00169         virtual ArrayElement* clone();
00170 
00171 
00172 };
00173 
00174 
00175 END_NAMESPACE
00176 
00178 #endif

Generated on Tue Jun 10 17:20:22 2008 for Funambol C++ Client Library by  doxygen 1.5.2