aboutsummaryrefslogtreecommitdiffstats
path: root/server/src/com/vaadin/ui/UI.java
diff options
context:
space:
mode:
authorLeif Ã…strand <leif@vaadin.com>2013-07-08 17:23:49 +0300
committerJohannes Dahlström <johannesd@vaadin.com>2013-07-10 10:32:38 +0000
commit20162dbe200111a514ab0849963dcf3eea1a9c83 (patch)
treedeb40c8ef3b6ec2c5f620d1a02658050fbac8dbb /server/src/com/vaadin/ui/UI.java
parente4011c6fa4d7a00b718551885339854ceacc0cf0 (diff)
downloadvaadin-framework-20162dbe200111a514ab0849963dcf3eea1a9c83.tar.gz
vaadin-framework-20162dbe200111a514ab0849963dcf3eea1a9c83.zip
Set current instances when calling UI.push from VaadinSession.unlock (#12168)
Change-Id: I27795ab9ae3e3692f508e847936ccaa5a1ebadd4
Diffstat (limited to 'server/src/com/vaadin/ui/UI.java')
-rw-r--r--server/src/com/vaadin/ui/UI.java9
1 files changed, 6 insertions, 3 deletions
diff --git a/server/src/com/vaadin/ui/UI.java b/server/src/com/vaadin/ui/UI.java
index 6c9551ea81..403bb31f63 100644
--- a/server/src/com/vaadin/ui/UI.java
+++ b/server/src/com/vaadin/ui/UI.java
@@ -1294,15 +1294,18 @@ public abstract class UI extends AbstractSingleComponentContainer implements
* Pushes the pending changes and client RPC invocations of this UI to the
* client-side.
* <p>
- * As with all UI methods, it is not safe to call push() without holding the
- * {@link VaadinSession#lock() session lock}.
+ * As with all UI methods, the session must be locked when calling this
+ * method. It is also recommended that {@link UI#getCurrent()} is set up to
+ * return this UI since writing the response may invoke logic in any
+ * attached component or extension. The recommended way of fulfilling these
+ * conditions is to use {@link #access(Runnable)}.
*
* @throws IllegalStateException
* if push is disabled.
* @throws UIDetachedException
* if this UI is not attached to a session.
*
- * @see #getPushMode()
+ * @see #getPushConfiguration()
*
* @since 7.1
*/