From: Artur Signell <artur@vaadin.com>
Date: Thu, 8 Mar 2012 16:04:14 +0000 (+0200)
Subject: Update documentation and add isEnabled as it is mandatory at least on
X-Git-Tag: 7.0.0.alpha2~357
X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=618aa03e04d399b53a1815181ab024fbc3e4bf15;p=vaadin-framework.git

Update documentation and add isEnabled as it is mandatory at least on
server side.
---

diff --git a/src/com/vaadin/terminal/gwt/client/Connector.java b/src/com/vaadin/terminal/gwt/client/Connector.java
index 67202ce02b..77c29a24fd 100644
--- a/src/com/vaadin/terminal/gwt/client/Connector.java
+++ b/src/com/vaadin/terminal/gwt/client/Connector.java
@@ -38,8 +38,10 @@ public interface Connector {
      * 
      * @param state
      *            The new state
-     * 
+     * @deprecated This should be removed. Framework should update what is
+     *             returned by getState() instead of setting a new state object.
      */
+    @Deprecated
     public void setState(SharedState state);
 
     /**
@@ -59,20 +61,22 @@ public interface Connector {
     public ApplicationConnection getConnection();
 
     /**
-     * Tests whether the component is enabled or not. A user can not interact
-     * with disabled components. Disabled components are rendered in a style
-     * that indicates the status, usually in gray color. Children of a disabled
-     * component are also disabled.
+     * Tests whether the connector is enabled or not. Disabled connectors will
+     * ignore all attempts at communications. Received messages will be
+     * discarded. This method must check that the connector is enabled in
+     * context, that is if it's parent is disabled, this method must return
+     * false.
      * 
-     * @return true if the component is enabled, false otherwise
+     * @return true if the connector is enabled, false otherwise
      */
-    // public boolean isEnabled();
+    public boolean isEnabled();
 
     /**
      * 
      * Called once by the framework to initialize the connector.
      * 
-     * Note that the shared state is not yet available at this point.
+     * Note that the shared state is not yet available at this point nor any
+     * hierarchy information.
      */
     public void doInit(String connectorId, ApplicationConnection connection);