1 files changed, 96 insertions, 0 deletions
diff --git a/plugins/org.eclipse.net4j.util/src/org/eclipse/net4j/util/properties/Property.java b/plugins/org.eclipse.net4j.util/src/org/eclipse/net4j/util/properties/Property.java
new file mode 100644
index 0000000000..2c8c660dfe
--- /dev/null
+++ b/plugins/org.eclipse.net4j.util/src/org/eclipse/net4j/util/properties/Property.java
@@ -0,0 +1,96 @@
+/**
+ * Copyright (c) 2004 - 2011 Eike Stepper (Berlin, Germany) and others.
+ * All rights reserved. This program and the accompanying materials
+ * are made available under the terms of the Eclipse Public License v1.0
+ * which accompanies this distribution, and is available at
+ * http://www.eclipse.org/legal/epl-v10.html
+ * 
+ * Contributors:
+ *    Eike Stepper - initial API and implementation
+ */
+package org.eclipse.net4j.util.properties;
+
+import org.eclipse.net4j.util.ObjectUtil;
+
+/**
+ * Describes a property of a receiver object and extracts its value.
+ * 
+ * @author Eike Stepper
+ * @since 3.2
+ */
+public abstract class Property<RECEIVER>
+{
+  private final String name;
+
+  private final String label;
+
+  private final String description;
+
+  private final String category;
+
+  public Property(String name, String label, String description, String category)
+  {
+    this.name = name;
+    this.label = label;
+    this.description = description;
+    this.category = category;
+  }
+
+  public Property(String name, String label, String description)
+  {
+    this(name, label, description, null);
+  }
+
+  public Property(String name)
+  {
+    this(name, null, null);
+  }
+
+  public final String getName()
+  {
+    return name;
+  }
+
+  public final String getLabel()
+  {
+    return label;
+  }
+
+  public final String getDescription()
+  {
+    return description;
+  }
+
+  public final String getCategory()
+  {
+    return category;
+  }
+
+  public boolean testValue(RECEIVER receiver, Object[] args, Object expectedValue)
+  {
+    Object value = getValue(receiver);
+    return ObjectUtil.equals(value, expectedValue);
+  }
+
+  public final Object getValue(RECEIVER receiver)
+  {
+    Object value = eval(receiver);
+    if (value == null || value.getClass().isPrimitive())
+    {
+      return value;
+    }
+
+    if (value.getClass().isPrimitive())
+    {
+      return value;
+    }
+
+    return value.toString();
+  }
+
+  /**
+   * Returns the receiver's value for this property, either a {@link String} or a boxed primitive type. Return values of
+   * all other types are converted with {@link #toString()} in {@link #eval(Object)}.
+   */
+  protected abstract Object eval(RECEIVER receiver);
+}