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_SPDS_UTIL 00037 #define INCL_SPDS_UTIL 00038 /** @cond DEV */ 00039 00040 #include "base/util/ArrayList.h" 00041 #include "spds/constants.h" 00042 #include "spds/SyncItem.h" 00043 #include "spds/SyncItemStatus.h" 00044 #include "base/util/StringBuffer.h" 00045 00046 BEGIN_NAMESPACE 00047 00048 /** 00049 * returns the SyncMode corresponding to the string, 00050 * SYNC_NONE if string is invalid 00051 * 00052 * @param syncMode one of the keywords valid as config parameter (see documentation of config) 00053 */ 00054 SyncMode syncModeCode(const char* syncMode); 00055 00056 /** 00057 * returns the config keyword corresponding to the sync mode, 00058 * empty string if invalid 00059 */ 00060 const char *syncModeKeyword(SyncMode syncMode); 00061 00062 /* 00063 * Translates an ArrayList object into an array of SyncItemStatus*. 00064 * 00065 * @param items the item list 00066 */ 00067 SyncItemStatus** toSyncItemStatusArray(ArrayList& items); 00068 00069 /* 00070 * Translates an ArrayList into an array of SyncItem*. 00071 * 00072 * @param items the item list 00073 */ 00074 SyncItem** toSyncItemArray(ArrayList& items); 00075 00076 00077 /** 00078 * This functions works for standard encoded files with new line every 00079 * 72 characters. It does not work if the line length is not multiple of 4. 00080 * 00081 * @param const char* msg the message to decode 00082 * @param char** binmsg new allocated decoded message 00083 * @param size_t* binlen the lenght of the decoded message 00084 * @return int 0 if successful 00085 */ 00086 int uudecode(const char *msg, char **binmsg, size_t *binlen); 00087 00088 /** 00089 * Encode the message in base64, splitting the result in lines of 72 columns 00090 * each. 00091 * 00092 * @param const char* msg the message to encode (can be binary data) 00093 * @param int len the lenght of the message 00094 * @return char* new allocated string or NULL in case of error 00095 */ 00096 char *uuencode(const char *msg, int len); 00097 00098 /** 00099 * It converts the content using the encoding specified. If all 00100 * is correct it saves the converted content into a file. 00101 * @param filename the file name in which the converted data is saved 00102 * @param s the data that will be converted 00103 * @param encoding the encoding used to convert to data 00104 * @return -1 if the filename is NULL or s is NULL; 00105 * 0 if all is correct 00106 */ 00107 int convertAndSave(const char *filename, const char *str, 00108 const char *encoding = "UTF-8"); 00109 00110 /** 00111 * Load a file and convert its content according to encoding. 00112 * @param filename the file name in which the converted content is saved 00113 * @param encoding the encoding that will be used 00114 * @return the content of the file 00115 */ 00116 char *loadAndConvert(const char *filename, 00117 const char *encoding = "UTF-8"); 00118 00119 /** 00120 * indent a string encoded in bb4 00121 * 00122 * @param StringBuffer& the string to indent 00123 * @param int space how much to indent 00124 * @return 0 if successful 00125 */ 00126 int indent(StringBuffer& content, int space = 8); 00127 00128 END_NAMESPACE 00129 00130 /** @endcond */ 00131 #endif