]> source.dussan.org Git - vaadin-framework.git/commitdiff
Allow storing values in VaadinSession (#9514)
authorLeif Åstrand <leif@vaadin.com>
Sun, 9 Sep 2012 18:49:19 +0000 (21:49 +0300)
committerLeif Åstrand <leif@vaadin.com>
Sun, 9 Sep 2012 18:49:19 +0000 (21:49 +0300)
server/src/com/vaadin/server/VaadinSession.java
uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.html [new file with mode: 0644]
uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.java [new file with mode: 0644]

index c6b2d91f2907d8c01ad994cc5d77f62fa58f5f93..a91c011ddfce6653012cb771fa2065e70ac33a0a 100644 (file)
@@ -204,6 +204,8 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable {
 
     private transient WrappedSession session;
 
+    private final Map<String, Object> attributes = new HashMap<String, Object>();
+
     /**
      * @see javax.servlet.http.HttpSessionBindingListener#valueBound(HttpSessionBindingEvent)
      */
@@ -1306,4 +1308,111 @@ public class VaadinSession implements HttpSessionBindingListener, Serializable {
         return lock;
     }
 
+    /**
+     * Stores a value in this vaadin session. This can be used to associate data
+     * with the current user so that it can be retrieved at a later point from
+     * some other part of the application. Setting the value to
+     * <code>null</code> clears the stored value.
+     * 
+     * @see #getAttribute(String)
+     * 
+     * @param name
+     *            the name to associate the value with, can not be
+     *            <code>null</code>
+     * @param value
+     *            the value to associate with the name, or <code>null</code> to
+     *            remove a previous association.
+     */
+    public void setAttribute(String name, Object value) {
+        if (name == null) {
+            throw new IllegalArgumentException("name can not be null");
+        }
+        if (value != null) {
+            attributes.put(name, value);
+        } else {
+            attributes.remove(name);
+        }
+    }
+
+    /**
+     * Stores a value in this vaadin session. This can be used to associate data
+     * with the current user so that it can be retrieved at a later point from
+     * some other part of the application. Setting the value to
+     * <code>null</code> clears the stored value.
+     * <p>
+     * The fully qualified name of the type is used as the name when storing the
+     * value. The outcome of calling this method is thus the same as if calling<br />
+     * <br />
+     * <code>setAttribute(type.getName(), value);</code>
+     * 
+     * @see #getAttribute(Class)
+     * @see #setAttribute(String, Object)
+     * 
+     * @param type
+     *            the type that the stored value represents, can not be null
+     * @param value
+     *            the value to associate with the type, or <code>null</code> to
+     *            remove a previous association.
+     */
+    public <T> void setAttribute(Class<T> type, T value) {
+        if (type == null) {
+            throw new IllegalArgumentException("type can not be null");
+        }
+        if (value != null && !type.isInstance(value)) {
+            throw new IllegalArgumentException("value of type "
+                    + type.getName() + " expected but got "
+                    + value.getClass().getName());
+        }
+        setAttribute(type.getName(), value);
+    }
+
+    /**
+     * Gets a stored attribute value. If a value has been stored for the
+     * session, that value is returned. If no value is stored for the name,
+     * <code>null</code> is returned.
+     * 
+     * @see #setAttribute(String, Object)
+     * 
+     * @param name
+     *            the name of the value to get, can not be <code>null</code>.
+     * @return the value, or <code>null</code> if no value has been stored or if
+     *         it has been set to null.
+     */
+    public Object getAttribute(String name) {
+        if (name == null) {
+            throw new IllegalArgumentException("name can not be null");
+        }
+        return attributes.get(name);
+    }
+
+    /**
+     * Gets a stored attribute value. If a value has been stored for the
+     * session, that value is returned. If no value is stored for the name,
+     * <code>null</code> is returned.
+     * <p>
+     * The fully qualified name of the type is used as the name when getting the
+     * value. The outcome of calling this method is thus the same as if calling<br />
+     * <br />
+     * <code>getAttribute(type.getName());</code>
+     * 
+     * @see #setAttribute(Class, Object)
+     * @see #getAttribute(String)
+     * 
+     * @param type
+     *            the type of the value to get, can not be <code>null</code>.
+     * @return the value, or <code>null</code> if no value has been stored or if
+     *         it has been set to null.
+     */
+    public <T> T getAttribute(Class<T> type) {
+        if (type == null) {
+            throw new IllegalArgumentException("type can not be null");
+        }
+        Object value = getAttribute(type.getName());
+        if (value == null) {
+            return null;
+        } else {
+            return type.cast(value);
+        }
+    }
+
 }
diff --git a/uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.html b/uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.html
new file mode 100644 (file)
index 0000000..e03027f
--- /dev/null
@@ -0,0 +1,31 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head profile="http://selenium-ide.openqa.org/profiles/test-case">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
+<link rel="selenium.base" href="" />
+<title>New Test</title>
+</head>
+<body>
+<table cellpadding="1" cellspacing="1" border="1">
+<thead>
+<tr><td rowspan="1" colspan="3">New Test</td></tr>
+</thead><tbody>
+<tr>
+       <td>open</td>
+       <td>/run/com.vaadin.tests.application.VaadinSessionAttribute?restartApplication&amp;attachMainFirst</td>
+       <td></td>
+</tr>
+<tr>
+       <td>click</td>
+       <td>vaadin=runcomvaadintestsapplicationVaadinSessionAttribute::/VVerticalLayout[0]/VOrderedLayout$Slot[1]/VVerticalLayout[0]/VOrderedLayout$Slot[0]/VButton[0]/domChild[0]/domChild[0]</td>
+       <td></td>
+</tr>
+<tr>
+       <td>assertText</td>
+       <td>//body/div[2]</td>
+       <td>42 &amp; 84</td>
+</tr>
+</tbody></table>
+</body>
+</html>
diff --git a/uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.java b/uitest/src/com/vaadin/tests/application/VaadinSessionAttribute.java
new file mode 100644 (file)
index 0000000..ad48ef0
--- /dev/null
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2011 Vaadin Ltd.
+ * 
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not
+ * use this file except in compliance with the License. You may obtain a copy of
+ * the License at
+ * 
+ * http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+ * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+ * License for the specific language governing permissions and limitations under
+ * the License.
+ */
+
+package com.vaadin.tests.application;
+
+import com.vaadin.server.WrappedRequest;
+import com.vaadin.tests.components.AbstractTestUI;
+import com.vaadin.ui.Button;
+import com.vaadin.ui.Button.ClickEvent;
+import com.vaadin.ui.Notification;
+
+public class VaadinSessionAttribute extends AbstractTestUI {
+
+    private static final String ATTR_NAME = "myAttribute";
+
+    @Override
+    protected void setup(WrappedRequest request) {
+        getSession().setAttribute(ATTR_NAME, Integer.valueOf(42));
+        getSession().setAttribute(Integer.class, Integer.valueOf(42 * 2));
+
+        addComponent(new Button("Show attribute values",
+                new Button.ClickListener() {
+                    @Override
+                    public void buttonClick(ClickEvent event) {
+                        Notification.show(getSession().getAttribute(ATTR_NAME)
+                                + " & "
+                                + getSession().getAttribute(Integer.class));
+                    }
+                }));
+    }
+
+    @Override
+    protected String getTestDescription() {
+        return "Test to verify that session attributes are saved between requests.";
+    }
+
+    @Override
+    protected Integer getTicketNumber() {
+        return Integer.valueOf(9514);
+    }
+
+}