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_SOURCE_REF 00038 #define INCL_SOURCE_REF 00039 /** @cond DEV */ 00040 00041 #include "base/fscapi.h" 00042 #include "base/util/ArrayElement.h" 00043 #include "syncml/core/Source.h" 00044 #include "base/globalsdef.h" 00045 00046 BEGIN_NAMESPACE 00047 00048 00049 class SourceRef : public ArrayElement{ 00050 00051 // ------------------------------------------------------------ Private data 00052 private: 00053 char* value; 00054 Source* source; 00055 00056 // ---------------------------------------------------------- Protected data 00057 public: 00058 SourceRef(); 00059 ~SourceRef(); 00060 00061 /** 00062 * Creates a new SourceRef object given the referenced value. A null value 00063 * is considered an empty string 00064 * 00065 * @param value the referenced value - NULL ALLOWED 00066 * 00067 */ 00068 SourceRef(const char* value); 00069 00070 /** 00071 * Creates a new SourceRef object from an existing Source. 00072 * 00073 * @param source the source to extract the reference from - NOT NULL 00074 * 00075 * 00076 */ 00077 SourceRef(Source* source); 00078 00079 // ---------------------------------------------------------- Public methods 00080 00081 /** 00082 * Returns the value 00083 * 00084 * @return the value 00085 */ 00086 const char* getValue(); 00087 00088 /** 00089 * Sets the reference value. If value is null, the empty string is adopted. 00090 * 00091 * @param value the reference value - NULL 00092 */ 00093 void setValue(const char* value); 00094 00095 /** 00096 * Gets the Source property 00097 * 00098 * @return source the Source object property 00099 */ 00100 Source* getSource(); 00101 00102 /** 00103 * Sets the Source property 00104 * 00105 * @param source the Source object property - NOT NULL 00106 */ 00107 void setSource(Source* source); 00108 00109 ArrayElement* clone(); 00110 00111 }; 00112 00113 00114 END_NAMESPACE 00115 00116 /** @endcond */ 00117 #endif