summaryrefslogtreecommitdiffstats
path: root/src/com
diff options
context:
space:
mode:
Diffstat (limited to 'src/com')
-rw-r--r--src/com/vaadin/ui/AbstractField.java13
1 files changed, 12 insertions, 1 deletions
diff --git a/src/com/vaadin/ui/AbstractField.java b/src/com/vaadin/ui/AbstractField.java
index 339741545d..daef4c0ddb 100644
--- a/src/com/vaadin/ui/AbstractField.java
+++ b/src/com/vaadin/ui/AbstractField.java
@@ -1333,8 +1333,17 @@ public abstract class AbstractField<T> extends AbstractComponent implements
}
/**
+ * Returns the internal field value, which might not match the data source
+ * value e.g. if the field has been modified and is not in write-through
+ * mode.
+ *
+ * This method can be overridden by subclasses together with
+ * {@link #setInternalValue(Object)} to compute internal field value at
+ * runtime. When doing so, typically also {@link #isModified()} needs to be
+ * overridden and care should be taken in the management of the empty state
+ * and buffering support.
*
- * @return
+ * @return internal field value
*/
protected T getInternalValue() {
return value;
@@ -1346,6 +1355,8 @@ public abstract class AbstractField<T> extends AbstractComponent implements
* It can be overridden by the inheriting classes to update all dependent
* variables.
*
+ * Subclasses can also override {@link #getInternalValue()} if necessary.
+ *
* @param newValue
* the new value to be set.
*/