Documented WidgetFactory

svn changeset:1715/svn branch:trunk

diff --git a/src/com/itmill/toolkit/terminal/gwt/client/WidgetFactory.java b/src/com/itmill/toolkit/terminal/gwt/client/WidgetFactory.java
index b4a32c4059810ea5423aec5cc8fc8764353ee74d..72b327df197503c4e9baccf6e38fb7389300b53c 100644 (file)
--- a/src/com/itmill/toolkit/terminal/gwt/client/WidgetFactory.java
+++ b/src/com/itmill/toolkit/terminal/gwt/client/WidgetFactory.java
@@ -4,8 +4,18 @@ import com.google.gwt.user.client.ui.Widget;
 
 public interface WidgetFactory {
 
+       /** Create an uninitialized component that best matches given UIDL.
+        * 
+        * @param uidl UIDL to be painted with returned component.
+        * @return New uninitialized and unregistered component that can paint given UIDL.
+        */
        Widget createWidget(UIDL uidl);
 
+       /** Test if the given component implementation conforms to UIDL.
+        * 
+        * @param currentWidget Current implementation of the component
+        * @param uidl UIDL to test against
+        * @return true iff createWidget would return a new component of the same class than currentWidget
+        */
        boolean isCorrectImplementation(Widget currentWidget, UIDL uidl);
-       
 }