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 00037 #ifndef INCL_PIM_CONTACT 00038 #define INCL_PIM_CONTACT 00039 /** @cond DEV */ 00040 00041 #include "base/fscapi.h" 00042 #include "base/util/ArrayList.h" 00043 #include "vocl/VObject.h" 00044 #include "vocl/vCard/BusinessDetail.h" 00045 #include "vocl/vCard/Name.h" 00046 #include "vocl/vCard/Note.h" 00047 #include "vocl/vCard/Title.h" 00048 #include "vocl/vCard/PersonalDetail.h" 00049 #include "vocl/vCard/Phone.h" 00050 #include "vocl/vCard/Email.h" 00051 #include "vocl/vCard/WebPage.h" 00052 00053 #define MAX_TITLES 10 00054 #define MAX_VPROPERTY_VALUE 200 00055 #define BUSINESS 0 00056 #define HOME 1 00057 #define OTHER 2 00058 #include "base/globalsdef.h" 00059 00060 BEGIN_NAMESPACE 00061 00062 class Contact : public VObject { 00063 00064 // ------------------------------------------------------------ Private data 00065 00066 private: 00067 Name* name; 00068 PersonalDetail* personalDetail; 00069 BusinessDetail* businessDetail; 00070 ArrayList* notes; 00071 00072 /** 00073 * Sets internal members releasing the currently allocated memory (if 00074 * any was allocate). The passed value is doplicated so that the caller 00075 * can independently release it. 00076 * 00077 * @param property the address of the pointer to set to the new 00078 * allocated memory 00079 * @param v the value to set into the property 00080 */ 00081 void set(WCHAR** p, WCHAR* v); 00082 vCardProperty* getPropertyFromVProperty(VProperty* vp); 00083 VProperty* getVPropertyFromProperty(WCHAR* name, vCardProperty* prop); 00084 VProperty* composeVAddress(Address* adr); 00085 Address* composeAddress(VProperty* vp, int type); 00086 Address* addLabelAddress(VProperty* vp, int type); 00087 00088 //--------------------------------------------- Constructors and Destructors 00089 00090 public: 00091 Contact(); 00092 ~Contact(); 00093 00094 // ---------------------------------------------------------- Public methods 00095 00096 /** 00097 * Returns the UID of this contact 00098 * 00099 * @return the uid of this contact or NULL if not specified 00100 */ 00101 WCHAR* getUID(WCHAR* buf = NULL, int size = -1); 00102 00103 /** 00104 * Returns the timezone for this contact 00105 * 00106 * @param buf if not NULL, the value is copied in this buffer 00107 * @param size buffer size 00108 * 00109 * @return the timezone for this contact or NULL if not specified 00110 */ 00111 WCHAR* getTimezone (WCHAR* buf = NULL, int size = -1); 00112 00113 /** 00114 * Returns the note for this contact 00115 * 00116 * @return the note for this contact or NULL if not specified 00117 */ 00118 ArrayList* getNotes(); 00119 00120 /** 00121 * Sets the notes. The given ArrayList is cloned, so that the 00122 * caller can independently release it as needed. 00123 */ 00124 void setNotes(ArrayList& list); 00125 00126 /** 00127 * Returns the revision of this contact 00128 * 00129 * @param buf if not NULL, the value is copied in this buffer 00130 * @param size buffer size 00131 * 00132 * @return the revision of this contact of NULL if not specified 00133 */ 00134 WCHAR* getRevision(WCHAR* buf = NULL, int size = -1); 00135 00136 /** 00137 * Returns the name of this contact 00138 * 00139 * @return the name of this contact or NULL if not specified 00140 */ 00141 Name* getName(); 00142 00143 /** 00144 * Sets the contact name. The given Name is cloned, so that the 00145 * caller can independently release it as needed. 00146 */ 00147 void setName(Name& n); 00148 00149 /** 00150 * Returns the business details of this contact 00151 * 00152 * @return the business details of this contact of NULL if not specified 00153 */ 00154 BusinessDetail* getBusinessDetail (); 00155 00156 /** 00157 * Sets the business detail. The given BusinessDetail is cloned, so that the 00158 * caller can independently release it as needed. 00159 */ 00160 void setBusinessDetail(BusinessDetail& d); 00161 00162 /** 00163 * Returns the personal details of this contact 00164 * 00165 * @return the personaldetails of this contact or NULL if not specified 00166 */ 00167 PersonalDetail* getPersonalDetail(); 00168 00169 /** 00170 * Sets the personal detail. The given PersonalDetail is cloned, so that the 00171 * caller can independently release it as needed. 00172 */ 00173 void setPersonalDetail(PersonalDetail& d); 00174 00175 /** 00176 * Sets the UID of this contact 00177 * 00178 * @param uid the UID to set 00179 */ 00180 void setUID (WCHAR* uid); 00181 00182 /** 00183 * Sets the timezone for this contact 00184 * 00185 * @param timezone the timezone to set 00186 */ 00187 void setTimezone (WCHAR* tz); 00188 00189 /** 00190 * Sets the revision of this contact 00191 * 00192 * @param revision the revision to set 00193 */ 00194 void setRevision (WCHAR* revision); 00195 00196 Contact* clone(); 00197 WCHAR* toString(); 00198 }; 00199 00200 00201 END_NAMESPACE 00202 00203 /** @endcond */ 00204 #endif