From 716ec03be1f2c73b564d6c16edd4139ee73ffa30 Mon Sep 17 00:00:00 2001 From: Artur Date: Tue, 13 Dec 2016 13:56:54 +0200 Subject: [PATCH] Enable changing the backing bean for BeanItem (#4302) (#77) When storing a bean to the database, you typically get a new and updated bean instance back. By allowing to change the bean instance, we make it possible to just update the single BeanItem instance which can be used in many places. --- .../java/com/vaadin/data/util/BeanItem.java | 46 +++++++++++- .../com/vaadin/data/util/MethodProperty.java | 31 ++++++++ .../data/util/NestedMethodProperty.java | 34 ++++++++- .../com/vaadin/data/util/BeanItemTest.java | 37 +++++++++ .../vaadin/data/util/MethodPropertyTest.java | 75 +++++++++++++++++++ .../data/util/NestedMethodPropertyTest.java | 23 ++++++ 6 files changed, 244 insertions(+), 2 deletions(-) create mode 100644 server/src/test/java/com/vaadin/data/util/MethodPropertyTest.java diff --git a/server/src/main/java/com/vaadin/data/util/BeanItem.java b/server/src/main/java/com/vaadin/data/util/BeanItem.java index 78010a14c0..99853d458c 100644 --- a/server/src/main/java/com/vaadin/data/util/BeanItem.java +++ b/server/src/main/java/com/vaadin/data/util/BeanItem.java @@ -26,6 +26,8 @@ import java.util.List; import java.util.Map; import java.util.Set; +import com.vaadin.data.Property; + /** * A wrapper class for adding the Item interface to any Java Bean. * @@ -38,7 +40,7 @@ public class BeanItem extends PropertysetItem { /** * The bean which this Item is based on. */ - private final BT bean; + private BT bean; /** *

@@ -261,4 +263,46 @@ public class BeanItem extends PropertysetItem { return bean; } + /** + * Changes the Java Bean this item is based on. + *

+ * This will cause any existing properties to be re-mapped to the new bean. + * Any added custom properties which are not of type {@link MethodProperty} + * or {@link NestedMethodProperty} will not be updated to reflect the change + * of bean. + *

+ * Changing the bean will fire value change events for all properties of + * type {@link MethodProperty} or {@link NestedMethodProperty}. + * + * @param bean + * The new bean to use for this item, not null + */ + public void setBean(BT bean) { + if (bean == null) { + throw new IllegalArgumentException("Bean cannot be null"); + } + + if (getBean().getClass() != bean.getClass()) { + throw new IllegalArgumentException( + "The new bean class " + bean.getClass().getName() + + " does not match the old bean class " + + getBean().getClass()); + } + + // Remap properties + for (Object propertyId : getItemPropertyIds()) { + Property p = getItemProperty(propertyId); + if (p instanceof MethodProperty) { + MethodProperty mp = (MethodProperty) p; + assert (mp.getInstance() == getBean()); + mp.setInstance(bean); + } else if (p instanceof NestedMethodProperty) { + NestedMethodProperty nmp = (NestedMethodProperty) p; + assert (nmp.getInstance() == getBean()); + nmp.setInstance(bean); + } + } + + this.bean = bean; + } } diff --git a/server/src/main/java/com/vaadin/data/util/MethodProperty.java b/server/src/main/java/com/vaadin/data/util/MethodProperty.java index 70ee735d96..829e37e321 100644 --- a/server/src/main/java/com/vaadin/data/util/MethodProperty.java +++ b/server/src/main/java/com/vaadin/data/util/MethodProperty.java @@ -767,6 +767,37 @@ public class MethodProperty extends AbstractProperty { super.fireValueChange(); } + /** + * The instance used by this property + * + * @return the instance used for fetching the property value + */ + public Object getInstance() { + return instance; + } + + /** + * Sets the instance used by this property. + *

+ * The new instance must be of the same type as the old instance + *

+ * To be consistent with {@link #setValue(Object)}, this method will fire a + * value change event even if the value stays the same + * + * @param instance + * the instance to use + */ + public void setInstance(Object instance) { + if (this.instance.getClass() != instance.getClass()) { + throw new IllegalArgumentException("The new instance is of type " + + instance.getClass().getName() + + " which does not match the old instance type " + + this.instance.getClass().getName()); + } + this.instance = instance; + fireValueChange(); + } + private static final Logger getLogger() { return Logger.getLogger(MethodProperty.class.getName()); } diff --git a/server/src/main/java/com/vaadin/data/util/NestedMethodProperty.java b/server/src/main/java/com/vaadin/data/util/NestedMethodProperty.java index 0b39efef5c..0ed4f085f6 100644 --- a/server/src/main/java/com/vaadin/data/util/NestedMethodProperty.java +++ b/server/src/main/java/com/vaadin/data/util/NestedMethodProperty.java @@ -192,9 +192,10 @@ public class NestedMethodProperty extends AbstractProperty { /** * Gets the value stored in the Property. The value is resolved by calling - * the specified getter method with the argument specified at instantiation. + * the specified getter methods on the current instance: * * @return the value of the Property + * @see #getInstance() */ @Override public T getValue() { @@ -266,4 +267,35 @@ public class NestedMethodProperty extends AbstractProperty { return Collections.unmodifiableList(getMethods); } + /** + * The instance used by this property + * + * @return the instance used for fetching the property value + */ + public Object getInstance() { + return instance; + } + + /** + * Sets the instance used by this property. + *

+ * The new instance must be of the same type as the old instance + *

+ * To be consistent with {@link #setValue(Object)}, this method will fire a + * value change event even if the value stays the same + * + * @param instance + * the instance to use + */ + public void setInstance(Object instance) { + if (this.instance.getClass() != instance.getClass()) { + throw new IllegalArgumentException("The new instance is of type " + + instance.getClass().getName() + + " which does not match the old instance type " + + this.instance.getClass().getName()); + } + this.instance = instance; + fireValueChange(); + } + } diff --git a/server/src/test/java/com/vaadin/data/util/BeanItemTest.java b/server/src/test/java/com/vaadin/data/util/BeanItemTest.java index 1bbe74818c..09e5daca97 100644 --- a/server/src/test/java/com/vaadin/data/util/BeanItemTest.java +++ b/server/src/test/java/com/vaadin/data/util/BeanItemTest.java @@ -386,4 +386,41 @@ public class BeanItemTest { // Should not be exception property.setValue(null); } + + @Test + public void testChangeBean() { + BeanItem beanItem = new BeanItem( + new MyClass("Foo")); + beanItem.setBean(new MyClass("Bar")); + Assert.assertEquals("Bar", beanItem.getItemProperty("name").getValue()); + } + + @Test + public void testChangeBeanNestedProperty() { + BeanItem beanItem = new BeanItem( + new MyClass("Foo")); + beanItem.setBean(new MyClass("Bar")); + Assert.assertEquals("Bar", beanItem.getItemProperty("name").getValue()); + } + + @Test(expected = IllegalArgumentException.class) + public void testChangeBeanToIncompatibleOne() { + BeanItem beanItem = new BeanItem(new MyClass("Foo")); + beanItem.setBean(new Generic()); + } + + @Test(expected = IllegalArgumentException.class) + public void testChangeBeanToSubclass() { + BeanItem beanItem = new BeanItem( + new MyClass("Foo")); + beanItem.setBean(new MyClass("Bar")); + beanItem.setBean(new MyClass2("foo")); + } + + @Test(expected = IllegalArgumentException.class) + public void testChangeBeanToNull() { + BeanItem beanItem = new BeanItem(new MyClass("Foo")); + beanItem.setBean(null); + } + } diff --git a/server/src/test/java/com/vaadin/data/util/MethodPropertyTest.java b/server/src/test/java/com/vaadin/data/util/MethodPropertyTest.java new file mode 100644 index 0000000000..962b19a2cb --- /dev/null +++ b/server/src/test/java/com/vaadin/data/util/MethodPropertyTest.java @@ -0,0 +1,75 @@ +/* + * Copyright 2000-2014 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.data.util; + +import org.junit.Assert; +import org.junit.Before; +import org.junit.Test; + +import com.vaadin.data.util.NestedMethodPropertyTest.Address; + +public class MethodPropertyTest { + + private Address testObject; + + @Before + public void setup() { + testObject = new NestedMethodPropertyTest.Address("some street", 123); + } + + @Test + public void getValue() { + MethodProperty mp = new MethodProperty(testObject, + "street"); + Assert.assertEquals("some street", mp.getValue()); + } + + @Test + public void getValueAfterBeanUpdate() { + MethodProperty mp = new MethodProperty(testObject, + "street"); + testObject.setStreet("Foo street"); + Assert.assertEquals("Foo street", mp.getValue()); + } + + @Test + public void setValue() { + MethodProperty mp = new MethodProperty(testObject, + "street"); + mp.setValue("Foo street"); + Assert.assertEquals("Foo street", testObject.getStreet()); + } + + @Test + public void changeInstance() { + MethodProperty mp = new MethodProperty(testObject, + "street"); + Address newStreet = new Address("new street", 999); + mp.setInstance(newStreet); + Assert.assertEquals("new street", mp.getValue()); + Assert.assertEquals("some street", testObject.getStreet()); + + } + + @Test(expected = IllegalArgumentException.class) + public void changeInstanceToIncompatible() { + MethodProperty mp = new MethodProperty(testObject, + "street"); + mp.setInstance("foobar"); + + } + +} diff --git a/server/src/test/java/com/vaadin/data/util/NestedMethodPropertyTest.java b/server/src/test/java/com/vaadin/data/util/NestedMethodPropertyTest.java index 4a1e2a1784..e1f59ea896 100644 --- a/server/src/test/java/com/vaadin/data/util/NestedMethodPropertyTest.java +++ b/server/src/test/java/com/vaadin/data/util/NestedMethodPropertyTest.java @@ -348,4 +348,27 @@ public class NestedMethodPropertyTest { Assert.assertTrue(booleanProperty.isReadOnly()); } + @Test + public void testChangeInstance() { + NestedMethodProperty streetProperty = new NestedMethodProperty( + vaadin, "manager.address.street"); + + Address somewhere = new Address("The street", 1234); + Person someone = new Person("Someone", somewhere); + Team someteam = new Team("The team", someone); + streetProperty.setInstance(someteam); + + Assert.assertEquals("The street", streetProperty.getValue()); + Assert.assertEquals("Ruukinkatu 2-4", vaadin.getManager().getAddress() + .getStreet()); + } + + @Test(expected = IllegalArgumentException.class) + public void testChangeInstanceToIncompatible() { + NestedMethodProperty streetProperty = new NestedMethodProperty( + vaadin, "manager.address.street"); + + streetProperty.setInstance("bar"); + } + } -- 2.39.5