Replacement guide javadocs for deprecated classes

Fixes #8682

compatibility-server/src/main/java/com/vaadin/v7/data/Buffered.java

@@ -18,6 +18,7 @@ package com.vaadin.v7.data;
 
 import java.io.Serializable;
 
+import com.vaadin.data.Binder;
 import com.vaadin.server.AbstractErrorMessage;
 import com.vaadin.server.ErrorMessage;
 import com.vaadin.server.ErrorMessage.ErrorLevel;
@@ -45,6 +46,8 @@ import com.vaadin.v7.data.Validator.InvalidValueException;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ * @deprecated As of 8.0, no replacement available, see {@link Binder#writeBean(Object)}, {@link Binder#clearFields()}
+ *
  */
 @Deprecated
 public interface Buffered extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/BufferedValidatable.java

@@ -16,6 +16,8 @@
 
 package com.vaadin.v7.data;
 
+import com.vaadin.data.Binder;
+
 import java.io.Serializable;
 
 /**
@@ -27,6 +29,7 @@ import java.io.Serializable;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ * @deprecated As of 8.0, no direct replacement available. See {@link Binder}, {@link com.vaadin.data.Validator}.
  */
 @Deprecated
 public interface BufferedValidatable

compatibility-server/src/main/java/com/vaadin/v7/data/Collapsible.java

@@ -36,6 +36,8 @@ import com.vaadin.v7.data.Container.Ordered;
  * collapsed subtrees don't exist.
  * <p>
  *
+ * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+ * version of Vaadin Framework 8.
  */
 @Deprecated
 public interface Collapsible extends Hierarchical, Ordered {

compatibility-server/src/main/java/com/vaadin/v7/data/Container.java

@@ -20,6 +20,11 @@ import java.io.Serializable;
 import java.util.Collection;
 import java.util.List;
 
+import com.vaadin.data.provider.AbstractBackEndDataProvider;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
+import com.vaadin.data.provider.Query;
+import com.vaadin.server.SerializableComparator;
 import com.vaadin.v7.data.util.filter.SimpleStringFilter;
 import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
 
@@ -79,6 +84,8 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *
  * @author Vaadin Ltd
  * @since 3.0
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 public interface Container extends Serializable {
@@ -425,6 +432,10 @@ public interface Container extends Serializable {
      * Depending on the container type, sorting a container may permanently
      * change the internal order of items in the container.
      * </p>
+     *
+     * @deprecated  As of 8.0, sorting is integrated into {@link DataProvider} and {@link Query#getSortOrders()}.
+     * For in-memory case, you can use also {@link ListDataProvider#setSortComparator(SerializableComparator)}.
+     * For back-end DataProviders, see {@link AbstractBackEndDataProvider#setSortOrders(List)}.
      */
     @Deprecated
     public interface Sortable extends Ordered {
@@ -660,6 +671,9 @@ public interface Container extends Serializable {
      * <li>The Items in the hierarchy can be declared explicitly to be able or
      * unable to have children.
      * </ul>
+     *
+     * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+     * version of Vaadin Framework 8.
      */
     @Deprecated
     public interface Hierarchical extends Container {
@@ -921,6 +935,10 @@ public interface Container extends Serializable {
      * @see Filterable
      *
      * @since 6.6
+     *
+     * @deprecated  As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public interface Filter extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/ContainerHelpers.java

@@ -20,6 +20,7 @@ import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container.Indexed;
 
 /**
@@ -27,6 +28,8 @@ import com.vaadin.v7.data.Container.Indexed;
  * of containers in Vaadin.
  *
  * @since 7.0
+ *
+ * @deprecated As of 8.0, no direct replacement available, see {@link DataProvider}
  */
 @Deprecated
 public class ContainerHelpers implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/Item.java

@@ -16,6 +16,9 @@
 
 package com.vaadin.v7.data;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.provider.DataProvider;
+
 import java.io.Serializable;
 import java.util.Collection;
 
@@ -28,6 +31,7 @@ import java.util.Collection;
  *
  * @author Vaadin Ltd
  * @since 3.0
+ * @deprecated As of 8.0, no direct replacement available, see {@link Binder}, {@link DataProvider}
  */
 @Deprecated
 public interface Item extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/Property.java

@@ -16,6 +16,11 @@
 
 package com.vaadin.v7.data;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.HasValue;
+import com.vaadin.data.ValueProvider;
+import com.vaadin.server.Setter;
+
 import java.io.Serializable;
 
 /**
@@ -42,10 +47,11 @@ import java.io.Serializable;
  * needs to be changed through the implementing class.
  * </p>
  *
- * @param T
+ * @param <T>
  *            type of values of the property
  *
  * @author Vaadin Ltd
+ * @deprecated As of 8.0, replaced by {@link HasValue}, {@link ValueProvider}, {@link Setter}, see {@link Binder}
  * @since 3.0
  */
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/Validatable.java

@@ -16,6 +16,8 @@
 
 package com.vaadin.v7.data;
 
+import com.vaadin.data.Binder;
+
 import java.io.Serializable;
 import java.util.Collection;
 
@@ -29,6 +31,7 @@ import java.util.Collection;
  * @author Vaadin Ltd.
  * @since 3.0
  * @see Validator
+ * @deprecated As of 8.0, no direct replacement available. See {@link Binder}, {@link com.vaadin.data.Validator}.
  */
 @Deprecated
 public interface Validatable extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/Validator.java

@@ -18,6 +18,7 @@ package com.vaadin.v7.data;
 
 import java.io.Serializable;
 
+import com.vaadin.data.Binder;
 import com.vaadin.server.AbstractErrorMessage;
 import com.vaadin.server.AbstractErrorMessage.ContentMode;
 import com.vaadin.server.ErrorMessage;
@@ -51,6 +52,8 @@ import com.vaadin.server.VaadinServlet;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ * @deprecated As of 8.0, replaced by {@link com.vaadin.data.Validator}. The validation is performed
+ * outside components, see {@link Binder}.{@code withValidator(...)}
  */
 @Deprecated
 public interface Validator extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/BeanFieldGroup.java

@@ -20,12 +20,18 @@ import java.lang.reflect.Method;
 import java.util.HashMap;
 import java.util.Map;
 
+import com.vaadin.data.BeanValidationBinder;
+import com.vaadin.data.Binder;
 import com.vaadin.data.util.BeanUtil;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.util.BeanItem;
 import com.vaadin.v7.data.validator.BeanValidator;
 import com.vaadin.v7.ui.Field;
 
+/**
+ *
+ * @deprecated As of 8.0, replaced by {@link Binder} and {@link BeanValidationBinder}
+ */
 @Deprecated
 public class BeanFieldGroup<T> extends FieldGroup {
 

compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/Caption.java

@@ -15,11 +15,16 @@
  */
 package com.vaadin.v7.data.fieldgroup;
 
+import com.vaadin.ui.Component;
+
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
+/**
+ * @deprecated As of 8.0, no replacement available, use {@link Component#setCaption}.
+ */
 @Target({ ElementType.FIELD })
 @Retention(RetentionPolicy.RUNTIME)
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/DefaultFieldGroupFieldFactory.java

@@ -18,6 +18,8 @@ package com.vaadin.v7.data.fieldgroup;
 import java.util.Date;
 import java.util.EnumSet;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.HasValue;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.fieldgroup.FieldGroup.BindException;
 import com.vaadin.v7.ui.AbstractField;
@@ -42,6 +44,8 @@ import com.vaadin.v7.ui.TextField;
  * instance.
  *
  * @author Vaadin Ltd
+ * @deprecated As of 8.0, no direct replacement available. {@link Binder#forMemberField(HasValue)} and
+ * {@link Binder#bindInstanceFields(Object)} should be used instead.
  */
 @Deprecated
 public class DefaultFieldGroupFieldFactory implements FieldGroupFieldFactory {

compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroup.java

@@ -26,6 +26,7 @@ import java.util.List;
 import java.util.Map;
 
 import com.vaadin.annotations.PropertyId;
+import com.vaadin.data.Binder;
 import com.vaadin.util.ReflectTools;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -53,6 +54,7 @@ import com.vaadin.v7.ui.Field;
  *
  * @author Vaadin Ltd
  * @since 7.0
+ * @deprecated As of 8.0, replaced by {@link Binder}
  */
 @Deprecated
 public class FieldGroup implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/fieldgroup/FieldGroupFieldFactory.java

@@ -17,6 +17,8 @@ package com.vaadin.v7.data.fieldgroup;
 
 import java.io.Serializable;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.HasValue;
 import com.vaadin.v7.ui.Field;
 
 /**
@@ -25,6 +27,8 @@ import com.vaadin.v7.ui.Field;
  *
  * @author Vaadin Ltd.
  * @since 7.0
+ * @deprecated As of 8.0, no direct replacement available. {@link Binder#forMemberField(HasValue)} and
+ * {@link Binder#bindInstanceFields(Object)} should be used instead.
  */
 @Deprecated
 public interface FieldGroupFieldFactory extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/AbstractBeanContainer.java

@@ -23,6 +23,7 @@ import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Container.Filterable;
 import com.vaadin.v7.data.Container.PropertySetChangeNotifier;
@@ -59,6 +60,9 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *            The type of the Bean
  *
  * @since 6.5
+ *
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 public abstract class AbstractBeanContainer<IDTYPE, BEANTYPE>

compatibility-server/src/main/java/com/vaadin/v7/data/util/AbstractContainer.java

@@ -21,6 +21,7 @@ import java.util.Collections;
 import java.util.EventObject;
 import java.util.LinkedList;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container;
 
 /**
@@ -36,6 +37,8 @@ import com.vaadin.v7.data.Container;
  * make them public.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 public abstract class AbstractContainer implements Container {

compatibility-server/src/main/java/com/vaadin/v7/data/util/AbstractInMemoryContainer.java

@@ -25,6 +25,7 @@ import java.util.LinkedList;
 import java.util.List;
 import java.util.Set;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Container.ItemSetChangeNotifier;
 import com.vaadin.v7.data.Item;
@@ -91,6 +92,8 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *            {@link Item} if unknown
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 public abstract class AbstractInMemoryContainer<ITEMIDTYPE, PROPERTYIDCLASS, ITEMCLASS extends Item>

compatibility-server/src/main/java/com/vaadin/v7/data/util/AbstractProperty.java

@@ -20,6 +20,9 @@ import java.util.Collections;
 import java.util.LinkedList;
 import java.util.logging.Logger;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.ValueProvider;
+import com.vaadin.server.Setter;
 import com.vaadin.v7.data.Property;
 
 /**
@@ -29,6 +32,8 @@ import com.vaadin.v7.data.Property;
  * {@link ReadOnlyStatusChangeListener}s.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder}
  */
 @Deprecated
 public abstract class AbstractProperty<T> implements Property<T>,

compatibility-server/src/main/java/com/vaadin/v7/data/util/BeanContainer.java

@@ -15,8 +15,11 @@
  */
 package com.vaadin.v7.data.util;
 
+import com.vaadin.data.provider.DataProvider;
+
 import java.util.Collection;
 
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container;
 
 /**
@@ -69,6 +72,8 @@ import com.vaadin.v7.data.Container;
  * @see BeanItemContainer
  *
  * @since 6.5
+ *
+ * @deprecated As of 8.0, replaced by {@link ListDataProvider}
  */
 @Deprecated
 public class BeanContainer<IDTYPE, BEANTYPE>

compatibility-server/src/main/java/com/vaadin/v7/data/util/BeanItem.java

@@ -26,6 +26,8 @@ import java.util.List;
 import java.util.Map;
 import java.util.Set;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.data.util.BeanUtil;
 import com.vaadin.v7.data.Property;
 
@@ -34,6 +36,10 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no direct replacement available. You can use any bean directly as an item for {@link Binder}
+ * or {@link DataProvider} and access the item properties with lambdas like {@code binder.forField(component).bind(...)} or
+ * {@code new Grid<Bean>(dataProvider).addColumn(bean->bean.getSomething())}.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/util/BeanItemContainer.java

@@ -15,6 +15,8 @@
  */
 package com.vaadin.v7.data.util;
 
+import com.vaadin.data.provider.ListDataProvider;
+
 import java.util.Collection;
 
 /**
@@ -50,6 +52,7 @@ import java.util.Collection;
  *            The type of the Bean
  *
  * @since 5.4
+ * @deprecated As of 8.0, replaced by {@link ListDataProvider}
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/ContainerHierarchicalWrapper.java

@@ -46,6 +46,9 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+ * version of Vaadin Framework 8.
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/ContainerOrderedWrapper.java

@@ -23,6 +23,7 @@ import java.util.Iterator;
 import java.util.LinkedList;
 import java.util.List;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -42,6 +43,8 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/DefaultItemSorter.java

@@ -21,6 +21,11 @@ import java.util.Collection;
 import java.util.Comparator;
 import java.util.List;
 
+import com.vaadin.data.provider.AbstractBackEndDataProvider;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
+import com.vaadin.data.provider.Query;
+import com.vaadin.server.SerializableComparator;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Container.Sortable;
 import com.vaadin.v7.data.Item;
@@ -37,6 +42,10 @@ import com.vaadin.v7.data.Property;
  * values. The comparator can be set using the constructor. If no comparator is
  * provided a default comparator is used.
  *
+ *
+ * @deprecated As of 8.0, sorting is integrated into {@link DataProvider} and {@link Query#getSortOrders()}.
+ * For in-memory case, you can use also {@link ListDataProvider#setSortComparator(SerializableComparator)}.
+ * For back-end DataProviders, see {@link AbstractBackEndDataProvider#setSortOrders(List)}.
  */
 @Deprecated
 public class DefaultItemSorter implements ItemSorter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/FilesystemContainer.java

@@ -30,6 +30,7 @@ import java.util.Iterator;
 import java.util.LinkedList;
 import java.util.List;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.server.Resource;
 import com.vaadin.util.FileTypeResolver;
 import com.vaadin.v7.data.Container;
@@ -41,6 +42,9 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+ * version of Vaadin Framework 8.
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/GeneratedPropertyContainer.java

@@ -27,6 +27,7 @@ import java.util.Map;
 import java.util.Map.Entry;
 import java.util.Set;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.shared.data.sort.SortDirection;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Item;
@@ -58,6 +59,8 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *
  * @since 7.4
  * @author Vaadin Ltd
+ *
+ * @deprecated As of 8.0, replaced by {@link DataProvider}
  */
 @Deprecated
 public class GeneratedPropertyContainer extends AbstractContainer

compatibility-server/src/main/java/com/vaadin/v7/data/util/HierarchicalContainer.java

@@ -35,6 +35,9 @@ import com.vaadin.v7.data.Item;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+ * version of Vaadin Framework 8.
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/HierarchicalContainerOrderedWrapper.java

@@ -26,6 +26,9 @@ import com.vaadin.v7.data.Container.Hierarchical;
  * features.
  *
  * @see ContainerOrderedWrapper
+ *
+ * @deprecated As of 8.0, no replacement available yet. A new hierarchical data API is planned in an upcoming
+ * version of Vaadin Framework 8.
  */
 @Deprecated
 @SuppressWarnings({ "serial" })

compatibility-server/src/main/java/com/vaadin/v7/data/util/IndexedContainer.java

@@ -29,6 +29,7 @@ import java.util.LinkedList;
 import java.util.List;
 import java.util.Map;
 
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -54,6 +55,8 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, replaced by {@link ListDataProvider}
  */
 
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/util/ItemSorter.java

@@ -17,7 +17,13 @@ package com.vaadin.v7.data.util;
 
 import java.io.Serializable;
 import java.util.Comparator;
+import java.util.List;
 
+import com.vaadin.data.provider.AbstractBackEndDataProvider;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
+import com.vaadin.data.provider.Query;
+import com.vaadin.server.SerializableComparator;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.Container.Sortable;
 
@@ -25,6 +31,10 @@ import com.vaadin.v7.data.Container.Sortable;
  * An item comparator which is compatible with the {@link Sortable} interface.
  * The <code>ItemSorter</code> interface can be used in <code>Sortable</code>
  * implementations to provide a custom sorting method.
+ *
+ * @deprecated As of 8.0, sorting is integrated into {@link DataProvider} and {@link Query#getSortOrders()}.
+ * For in-memory case, you can use also {@link ListDataProvider#setSortComparator(SerializableComparator)}.
+ * For back-end DataProviders, see {@link AbstractBackEndDataProvider#setSortOrders(List)}.
  */
 @Deprecated
 public interface ItemSorter

compatibility-server/src/main/java/com/vaadin/v7/data/util/ListSet.java

@@ -31,6 +31,8 @@ import java.util.Iterator;
  * works.
  *
  * This class is subject to change and should not be used outside Vaadin core.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class ListSet<E> extends ArrayList<E> {

compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodProperty.java

@@ -25,6 +25,9 @@ import java.util.Arrays;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.ValueProvider;
+import com.vaadin.server.Setter;
 import com.vaadin.shared.util.SharedUtil;
 import com.vaadin.v7.data.Property;
 import com.vaadin.v7.util.SerializerHelper;
@@ -58,6 +61,8 @@ import com.vaadin.v7.util.SerializerHelper;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder}
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/MethodPropertyDescriptor.java

@@ -32,6 +32,8 @@ import com.vaadin.v7.util.SerializerHelper;
  *            bean type
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class MethodPropertyDescriptor<BT>

compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedMethodProperty.java

@@ -24,6 +24,9 @@ import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.ValueProvider;
+import com.vaadin.server.Setter;
 import com.vaadin.shared.util.SharedUtil;
 import com.vaadin.v7.data.Property;
 import com.vaadin.v7.data.util.MethodProperty.MethodException;
@@ -41,6 +44,8 @@ import com.vaadin.v7.data.util.MethodProperty.MethodException;
  * @see MethodProperty
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder}
  */
 @Deprecated
 public class NestedMethodProperty<T> extends AbstractProperty<T> {

compatibility-server/src/main/java/com/vaadin/v7/data/util/NestedPropertyDescriptor.java

@@ -28,6 +28,8 @@ import com.vaadin.v7.data.Property;
  *            bean type
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class NestedPropertyDescriptor<BT>

compatibility-server/src/main/java/com/vaadin/v7/data/util/ObjectProperty.java

@@ -16,6 +16,9 @@
 
 package com.vaadin.v7.data.util;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.ValueProvider;
+import com.vaadin.server.Setter;
 import com.vaadin.v7.data.Property;
 
 /**
@@ -24,6 +27,8 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, replaced by {@link ValueProvider}, {@link Setter}, see {@link Binder}
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/PropertyValueGenerator.java

@@ -16,7 +16,10 @@
 package com.vaadin.v7.data.util;
 
 import java.io.Serializable;
+import java.util.Map;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.sort.SortOrder;
 import com.vaadin.v7.data.Item;
@@ -30,6 +33,10 @@ import com.vaadin.v7.data.util.filter.UnsupportedFilterException;
  *            Property data type
  * @since 7.4
  * @author Vaadin Ltd
+ *
+ * @deprecated As of 8.0, no direct replacement available. You can use any bean directly as an item for {@link Binder}
+ * or {@link DataProvider} and access item properties with lambdas like {@code binder.forField(component).bind(...)} or
+ * {@code new Grid<Bean>(dataProvider).addColumn(bean->bean.getSomething())}.
  */
 @Deprecated
 public abstract class PropertyValueGenerator<T> implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/PropertysetItem.java

@@ -22,7 +22,10 @@ import java.util.EventObject;
 import java.util.HashMap;
 import java.util.Iterator;
 import java.util.LinkedList;
+import java.util.Map;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
 
@@ -34,6 +37,10 @@ import com.vaadin.v7.data.Property;
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no direct replacement available. You can use {@link Map} directly as an item for {@link Binder}
+ * or {@link DataProvider} and access item properties with lambdas like {@code binder.forField(component).bind(...)} or
+ * {@code new Grid<Map<...>>(dataProvider).addColumn(map->map.get(...))}.
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/TextFileProperty.java

@@ -36,6 +36,7 @@ import java.nio.charset.Charset;
  * setValue(Object) is explicitly called. {@link ReadOnlyStatusChangeListener}s
  * are supported but only fire when setReadOnly(boolean) is explicitly called.
  *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 @SuppressWarnings("serial")

compatibility-server/src/main/java/com/vaadin/v7/data/util/TransactionalPropertyWrapper.java

@@ -40,7 +40,10 @@ import com.vaadin.v7.data.Property.ValueChangeNotifier;
  * @since 7.0
  *
  * @param <T>
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
+
 @Deprecated
 public class TransactionalPropertyWrapper<T> extends AbstractProperty<T>
         implements ValueChangeNotifier, Property.Transactional<T> {

compatibility-server/src/main/java/com/vaadin/v7/data/util/VaadinPropertyDescriptor.java

@@ -29,6 +29,8 @@ import com.vaadin.v7.data.Property;
  *            bean type
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public interface VaadinPropertyDescriptor<BT> extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/AbstractJunctionFilter.java

@@ -19,7 +19,8 @@ import java.util.Arrays;
 import java.util.Collection;
 import java.util.Collections;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 
 /**
@@ -30,7 +31,9 @@ import com.vaadin.v7.data.Container.Filter;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public abstract class AbstractJunctionFilter implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/And.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -32,7 +33,9 @@ import com.vaadin.v7.data.Item;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public final class And extends AbstractJunctionFilter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/Between.java

@@ -17,13 +17,16 @@ package com.vaadin.v7.data.util.filter;
 
 import java.util.Arrays;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.shared.util.SharedUtil;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
 /**
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public class Between implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/Compare.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -34,7 +35,9 @@ import com.vaadin.v7.data.Property;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public abstract class Compare implements Filter {
@@ -59,7 +62,9 @@ public abstract class Compare implements Filter {
      *
      * @since 6.6
      *
-     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+     * @deprecated  As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public static final class Equal extends Compare {
@@ -94,7 +99,9 @@ public abstract class Compare implements Filter {
      *
      * @since 6.6
      *
-     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+     * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public static final class Greater extends Compare {
@@ -130,7 +137,9 @@ public abstract class Compare implements Filter {
      *
      * @since 6.6
      *
-     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+     * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public static final class Less extends Compare {
@@ -166,7 +175,9 @@ public abstract class Compare implements Filter {
      *
      * @since 6.6
      *
-     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+     * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public static final class GreaterOrEqual extends Compare {
@@ -202,7 +213,9 @@ public abstract class Compare implements Filter {
      *
      * @since 6.6
      *
-     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+     * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+     * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+     * filters are specific to the implementation.
      */
     @Deprecated
     public static final class LessOrEqual extends Compare {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/IsNull.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -27,7 +28,9 @@ import com.vaadin.v7.data.Property;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public final class IsNull implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/Like.java

@@ -15,12 +15,15 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
 /**
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public class Like implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/Not.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -27,7 +28,9 @@ import com.vaadin.v7.data.Item;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public final class Not implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/Or.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -32,7 +33,9 @@ import com.vaadin.v7.data.Item;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public final class Or extends AbstractJunctionFilter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/filter/SimpleStringFilter.java

@@ -15,7 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
-import com.vaadin.data.provider.Query;
+import com.vaadin.data.provider.DataProvider;
+import com.vaadin.data.provider.ListDataProvider;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -36,7 +37,9 @@ import com.vaadin.v7.data.Property;
  *
  * @since 6.6
  *
- * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
+ * @deprecated As of 8.0, the whole filtering feature is integrated into {@link DataProvider}.
+ * For in-memory case ({@link ListDataProvider}), use predicates as filters. For back-end DataProviders,
+ * filters are specific to the implementation.
  */
 @Deprecated
 public final class SimpleStringFilter implements Filter {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/ColumnProperty.java

@@ -30,6 +30,7 @@ import com.vaadin.v7.data.util.converter.Converter.ConversionException;
  *
  * Note that depending on the QueryDelegate in use this does not necessarily map
  * into an actual column in a database table.
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 final public class ColumnProperty implements Property {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/OptimisticLockException.java

@@ -29,6 +29,7 @@ import com.vaadin.v7.data.util.sqlcontainer.query.TableQuery;
  * @see TableQuery#setVersionColumn(String)
  *
  * @author Jonatan Kronqvist / Vaadin Ltd
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class OptimisticLockException extends RuntimeException {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/ReadOnlyRowId.java

@@ -15,6 +15,9 @@
  */
 package com.vaadin.v7.data.util.sqlcontainer;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class ReadOnlyRowId extends RowId {
     private static final long serialVersionUID = -2626764781642012467L;

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/RowId.java

@@ -24,6 +24,8 @@ import java.util.Arrays;
  * The data structure of a RowId is an Object array which contains the values of
  * the primary key columns of the identified row. This allows easy equals()
  * -comparison of RowItems.
+ *
+ *  @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class RowId implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/RowItem.java

@@ -27,6 +27,8 @@ import com.vaadin.v7.data.Property;
  *
  * Note that depending on the QueryDelegate in use this does not necessarily map
  * into an actual row in a database table.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public final class RowItem implements Item {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLContainer.java

@@ -32,6 +32,7 @@ import java.util.Map;
 import java.util.logging.Level;
 import java.util.logging.Logger;
 
+import com.vaadin.data.provider.DataProvider;
 import com.vaadin.v7.data.Container;
 import com.vaadin.v7.data.ContainerHelpers;
 import com.vaadin.v7.data.Item;
@@ -46,6 +47,9 @@ import com.vaadin.v7.data.util.sqlcontainer.query.TableQuery;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.MSSQLGenerator;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.OracleGenerator;
 
+/**
+ * @deprecated As of 8.0, no replacement available, see {@link DataProvider}.
+ */
 @Deprecated
 public class SQLContainer implements Container, Container.Filterable,
         Container.Indexed, Container.Sortable, Container.ItemSetChangeNotifier {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/SQLUtil.java

@@ -17,6 +17,9 @@ package com.vaadin.v7.data.util.sqlcontainer;
 
 import java.io.Serializable;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class SQLUtil implements Serializable {
     /**

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/TemporaryRowId.java

@@ -15,6 +15,9 @@
  */
 package com.vaadin.v7.data.util.sqlcontainer;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class TemporaryRowId extends RowId {
     private static final long serialVersionUID = -641983830469018329L;

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/connection/J2EEConnectionPool.java

@@ -24,6 +24,9 @@ import javax.naming.InitialContext;
 import javax.naming.NamingException;
 import javax.sql.DataSource;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class J2EEConnectionPool implements JDBCConnectionPool {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/connection/JDBCConnectionPool.java

@@ -21,6 +21,7 @@ import java.sql.SQLException;
 
 /**
  * Interface for implementing connection pools to be used with SQLContainer.
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public interface JDBCConnectionPool extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/connection/SimpleJDBCConnectionPool.java

@@ -27,6 +27,8 @@ import java.util.Set;
  * Simple implementation of the JDBCConnectionPool interface. Handles loading
  * the JDBC driver, setting up the connections and ensuring they are still
  * usable upon release.
+ *
+ *  @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/AbstractTransactionalQuery.java

@@ -30,6 +30,8 @@ import com.vaadin.v7.data.util.sqlcontainer.connection.JDBCConnectionPool;
  *
  * @author Vaadin Ltd
  * @since 6.8.9
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public abstract class AbstractTransactionalQuery implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/FreeformQuery.java

@@ -33,6 +33,9 @@ import com.vaadin.v7.data.util.sqlcontainer.connection.JDBCConnectionPool;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.filter.QueryBuilder;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @SuppressWarnings("serial")
 @Deprecated
 public class FreeformQuery extends AbstractTransactionalQuery

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/FreeformQueryDelegate.java

@@ -23,6 +23,9 @@ import java.util.List;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.RowItem;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public interface FreeformQueryDelegate extends Serializable {
     /**

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/FreeformStatementDelegate.java

@@ -26,6 +26,8 @@ import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
  * Due to the injection protection and other benefits of prepared statements, it
  * is advisable to implement this interface instead of the FreeformQueryDelegate
  * whenever possible.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public interface FreeformStatementDelegate extends FreeformQueryDelegate {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/OrderBy.java

@@ -23,6 +23,8 @@ import java.io.Serializable;
  *
  * The sorting rule is simple and contains only the affected column's name and
  * the direction of the sort.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class OrderBy implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/QueryDelegate.java

@@ -24,6 +24,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.RowId;
 import com.vaadin.v7.data.util.sqlcontainer.RowItem;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public interface QueryDelegate extends Serializable {
     /**

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/TableQuery.java

@@ -46,6 +46,9 @@ import com.vaadin.v7.data.util.sqlcontainer.query.generator.MSSQLGenerator;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.SQLGenerator;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @SuppressWarnings("serial")
 @Deprecated
 public class TableQuery extends AbstractTransactionalQuery

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/DefaultSQLGenerator.java

@@ -32,6 +32,8 @@ import com.vaadin.v7.data.util.sqlcontainer.query.generator.filter.StringDecorat
  * Generates generic SQL that is supported by HSQLDB, MySQL and PostgreSQL.
  *
  * @author Jonatan Kronqvist / Vaadin Ltd
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/MSSQLGenerator.java

@@ -21,6 +21,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.query.OrderBy;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.filter.QueryBuilder;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @SuppressWarnings("serial")
 @Deprecated
 public class MSSQLGenerator extends DefaultSQLGenerator {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/OracleGenerator.java

@@ -21,6 +21,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.query.OrderBy;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.filter.QueryBuilder;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @SuppressWarnings("serial")
 @Deprecated
 public class OracleGenerator extends DefaultSQLGenerator {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/SQLGenerator.java

@@ -28,6 +28,8 @@ import com.vaadin.v7.data.util.sqlcontainer.query.OrderBy;
  * HSQLDB, MySQL, PostgreSQL, MSSQL and Oracle syntaxes.
  *
  * @author Jonatan Kronqvist / Vaadin Ltd
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public interface SQLGenerator extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/StatementHelper.java

@@ -36,6 +36,8 @@ import java.util.Map;
  *
  * This class will also fill the values with correct setters into the
  * PreparedStatement on request.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class StatementHelper implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/AndTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.And;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class AndTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/BetweenTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.Between;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class BetweenTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/CompareTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.Compare;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class CompareTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/FilterTranslator.java

@@ -20,6 +20,9 @@ import java.io.Serializable;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public interface FilterTranslator extends Serializable {
     public boolean translatesFilter(Filter filter);

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/IsNullTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.IsNull;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class IsNullTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/LikeTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.Like;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class LikeTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/NotTranslator.java

@@ -20,6 +20,9 @@ import com.vaadin.v7.data.util.filter.IsNull;
 import com.vaadin.v7.data.util.filter.Not;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class NotTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/OrTranslator.java

@@ -19,6 +19,9 @@ import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.filter.Or;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class OrTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/QueryBuilder.java

@@ -23,6 +23,9 @@ import java.util.List;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class QueryBuilder implements Serializable {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/SimpleStringTranslator.java

@@ -20,6 +20,9 @@ import com.vaadin.v7.data.util.filter.Like;
 import com.vaadin.v7.data.util.filter.SimpleStringFilter;
 import com.vaadin.v7.data.util.sqlcontainer.query.generator.StatementHelper;
 
+/**
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class SimpleStringTranslator implements FilterTranslator {
 

compatibility-server/src/main/java/com/vaadin/v7/data/util/sqlcontainer/query/generator/filter/StringDecorator.java

@@ -26,6 +26,8 @@ import java.io.Serializable;
  * (parenthesis).
  *
  * @author Vaadin Ltd
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class StringDecorator implements Serializable {

compatibility-server/src/main/java/com/vaadin/v7/event/DataBoundTransferable.java

@@ -34,6 +34,8 @@ import com.vaadin.v7.data.Container;
  * instead of its concrete subclasses.
  *
  * @since 6.3
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public abstract class DataBoundTransferable extends TransferableImpl {

compatibility-server/src/main/java/com/vaadin/v7/event/FieldEvents.java

@@ -22,6 +22,7 @@ import java.lang.reflect.Method;
 import com.vaadin.event.ConnectorEventListener;
 import com.vaadin.event.FieldEvents.BlurEvent;
 import com.vaadin.event.FieldEvents.BlurListener;
+import com.vaadin.event.FieldEvents.FocusEvent;
 import com.vaadin.event.FieldEvents.FocusListener;
 import com.vaadin.ui.Component;
 import com.vaadin.util.ReflectTools;

compatibility-server/src/main/java/com/vaadin/v7/event/ItemClickEvent.java

@@ -34,6 +34,7 @@ import com.vaadin.v7.data.Property;
  *
  * @since 5.3
  *
+ * @deprecated As of 8.0, see component-specific click events.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/server/communication/data/RpcDataProviderExtension.java

@@ -54,13 +54,15 @@ import elemental.json.JsonObject;
 
 /**
  * Provides Vaadin server-side container data source to a
- * {@link com.vaadin.client.ui.grid.GridConnector}. This is currently
+ * {@link com.vaadin.v7.client.connectors.GridConnector}. This is currently
  * implemented as an Extension hardcoded to support a specific connector type.
  * This will be changed once framework support for something more flexible has
  * been implemented.
  *
  * @since 7.4
  * @author Vaadin Ltd
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class RpcDataProviderExtension extends AbstractExtension {

compatibility-server/src/main/java/com/vaadin/v7/ui/AbstractSelect.java

@@ -78,8 +78,7 @@ import com.vaadin.v7.shared.ui.select.AbstractSelectState;
  *
  * @author Vaadin Ltd.
  * @since 5.0
- *
- * @deprecated As of 8.0, no replacement available. See {@link AbstractListing}
+ * @deprecated As of 8.0, replaced by {@link AbstractListing}
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/ProgressIndicator.java

@@ -17,6 +17,7 @@
 package com.vaadin.v7.ui;
 
 import com.vaadin.shared.communication.PushMode;
+import com.vaadin.ui.PushConfiguration;
 import com.vaadin.ui.UI;
 import com.vaadin.v7.data.Property;
 import com.vaadin.v7.shared.ui.progressindicator.ProgressIndicatorServerRpc;
@@ -27,13 +28,13 @@ import com.vaadin.v7.shared.ui.progressindicator.ProgressIndicatorState;
  * <p>
  * Polling in this way is generally not recommended since there is no
  * centralized management of when messages are sent to the server. Furthermore,
- * polling might not be needed at all if {@link UI#setPushMode(PushMode)} or
+ * polling might not be needed at all if {@link PushConfiguration#setPushMode(PushMode)} or
  * {@link UI#setPollInterval(int)} is used.
  *
  * @author Vaadin Ltd.
  * @since 4
- * @deprecated as of 7.1, use {@link ProgressBar} combined with
- *             {@link UI#setPushMode(PushMode)} or
+ * @deprecated as of 7.1, use {@link com.vaadin.ui.ProgressBar} combined with
+ *             {@link PushConfiguration#setPushMode(PushMode)} or
  *             {@link UI#setPollInterval(int)} instead.
  */
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/Table.java

@@ -81,6 +81,8 @@ import com.vaadin.v7.shared.ui.table.TableConstants.Section;
 import com.vaadin.v7.shared.ui.table.TableServerRpc;
 import com.vaadin.v7.shared.ui.table.TableState;
 
+import com.vaadin.ui.Grid;
+
 /**
  * <p>
  * <code>Table</code> is used for representing data or components in a pageable
@@ -102,7 +104,7 @@ import com.vaadin.v7.shared.ui.table.TableState;
  * @author Vaadin Ltd.
  * @since 3.0
  *
- * @deprecated As of 8.0, use {@link com.vaadin.ui.Grid} instead
+ * @deprecated As of 8.0, use {@link Grid} instead
  */
 @Deprecated
 @SuppressWarnings({ "deprecation" })

compatibility-server/src/main/java/com/vaadin/v7/ui/Tree.java

@@ -76,7 +76,7 @@ import com.vaadin.v7.shared.ui.tree.TreeState;
  * @author Vaadin Ltd.
  * @since 3.0
  *
- * @deprecated As of 8.0. Replacement planned for 8.1
+ * @deprecated As of 8.0. New hierarchical components are planned in an upcoming version of Vaadin Framework 8.
  */
 @SuppressWarnings({ "serial", "deprecation" })
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/TreeTable.java

@@ -67,7 +67,7 @@ import com.vaadin.v7.ui.Tree.ExpandListener;
  * {@link Collapsible} containers can not be shared among several users as they
  * share UI state in the container.
  *
- * @deprecated As of 8.0. Replacement planned for 8.1
+ * @deprecated As of 8.0. New hierarchical components are planned in an upcoming version of Vaadin Framework 8.
  */
 @SuppressWarnings({ "serial" })
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvent.java

@@ -24,6 +24,7 @@ import com.vaadin.v7.ui.Calendar;
  * @since 7.1
  * @author Vaadin Ltd.
  *
+ * @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarComponentEvents.java

@@ -30,6 +30,8 @@ import com.vaadin.v7.ui.components.calendar.event.CalendarEvent;
  *
  * @since 7.1.0
  * @author Vaadin Ltd.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public interface CalendarComponentEvents extends Serializable {

compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarDateRange.java

@@ -25,6 +25,8 @@ import java.util.TimeZone;
  * @since 7.1.0
  * @author Vaadin Ltd.
  *
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/CalendarTargetDetails.java

@@ -30,6 +30,8 @@ import com.vaadin.v7.ui.Calendar;
  *
  * @since 7.1
  * @author Vaadin Ltd.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/components/calendar/ContainerEventProvider.java

@@ -47,6 +47,8 @@ import com.vaadin.v7.ui.components.calendar.event.CalendarEventProvider.EventSet
  *
  * @since 7.1.0
  * @author Vaadin Ltd.
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @SuppressWarnings("serial")
 @Deprecated

compatibility-server/src/main/java/com/vaadin/v7/ui/themes/BaseTheme.java

@@ -15,6 +15,8 @@
  */
 package com.vaadin.v7.ui.themes;
 
+import com.vaadin.ui.themes.ValoTheme;
+
 /**
  * <p>
  * The Base theme is the foundation for all Vaadin themes. Although it is not
@@ -32,7 +34,7 @@ package com.vaadin.v7.ui.themes;
  * name as a string constant <code>THEME_NAME</code>.
  *
  * @since 6.3.0
- *
+ * @deprecated As of 8.0, no replacement available, only {@link ValoTheme} is supported.
  */
 @Deprecated
 public class BaseTheme {