Changeset 1685

Timestamp:

2008-03-09 14:13:40 (7 months ago)

Author:

th-schwarz

Message:

added #setProperty

Files:

• FCKeditor.Java/branches/2.4/src/main/java/net/fckeditor/handlers/PropertiesLoader.java (modified) (3 diffs)

FCKeditor.Java/branches/2.4/src/main/java/net/fckeditor/handlers/PropertiesLoader.java

@@ -26 +26 @@
 import java.util.Properties;
 
+import net.fckeditor.tool.Utils;
+
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -33 +35 @@
  * The main default file is 'default.properties' in the deepth of the classpath and should be
  * untouched. If there is a file named 'fckeditor.properties' in the root of the classpath, it will
- * be loaded. Values which are loaded before, will be overwritten.
+ * be loaded. Values which are loaded before, will be overwritten.<br>
+ * If you won't use an extra properties file to adjust the defaults, you can use
+ * {@link #setProperty(String, String)} instead.
  * 
  * @version $Id$
@@ -66 +70 @@
         }
 
+        /**
+         * Getter for a property of 'key'.
+         * 
+         * @param key
+         *            the propery key
+         * @return the value in this property list with the specified key value.
+         * @see Properties#getProperty(String)
+         */
         public static String getProperty(final String key) {
                 return properties.getProperty(key);
         }
+
+        /**
+         * Setter for a property. If the property already exists, the value will be overwritten.<br>
+         * Hint: This method is intended for an alternative way to set user defaults programmatically
+         * instead of using the 'fckeditor.properties'. It should never used inside FCKeditor.Java !!!
+         * 
+         * @param key
+         *            key the propery key
+         * @param value
+         * @throws IllegalArgumentException
+         *             if 'key' is empty.
+         * @see Properties#setProperty(String, String)
+         */
+        public static void setProperty(final String key, final String value) {
+                if (Utils.isEmpty(key))
+                        new IllegalArgumentException("The 'key' of a property schouldn't be null!");
+                properties.setProperty(key, value);
+        }
 }