Add javadoc for AbstractField.getInternalValue().

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.
      */