Replacement guide javadocs for deprecated classes, part two (vaadin#8719)

Partial fix for vaadin#8682

Author: Ilia Motornyi

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

@@ -16,6 +16,8 @@
 
 package com.vaadin.v7.data.util.converter;
 
+import com.vaadin.data.Binder;
+
 import java.io.Serializable;
 
 /**
@@ -25,6 +27,7 @@
  * @author Vaadin Ltd.
  * @since 7.0
  *
+ * @deprecated As of 8.0, no replacement available - provide explicit converters for {@link Binder}.
  */
 @Deprecated
 public interface ConverterFactory extends Serializable {

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

@@ -19,7 +19,9 @@
 import java.util.Locale;
 
 import com.vaadin.server.VaadinSession;
-
+/*
+ * @deprecated As of 8.0, no replacement available.
+ */
 @Deprecated
 public class ConverterUtil implements Serializable {
 

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

@@ -34,6 +34,8 @@
  *
  * @author Vaadin Ltd
  * @since 7.0
+ *
+ * @deprecated As of 8.0, no replacement available.
  */
 @Deprecated
 public class DefaultConverterFactory implements ConverterFactory {

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

@@ -29,6 +29,8 @@
  *
  * @author Vaadin Ltd
  * @since 7.0
+ *
+ * @deprecated As of 8.0, no direct replacement available.
  */
 @Deprecated
 public class ReverseConverter<PRESENTATION, MODEL>

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

@@ -16,6 +16,8 @@
 
 package com.vaadin.v7.data.util.converter;
 
+import com.vaadin.data.Binder;
+
 import java.text.NumberFormat;
 import java.util.Locale;
 
@@ -29,6 +31,9 @@
  *
  * @author Vaadin Ltd
  * @since 7.4
+ *
+ * @deprecated As of 8.0, a lightweight lambda-based converter can be build with
+ *  {@link Binder}{@code .forField(...).withConverter(...)} methods.
  */
 @Deprecated
 public class StringToByteConverter

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

@@ -15,6 +15,8 @@
  */
 package com.vaadin.v7.data.util.converter;
 
+import com.vaadin.data.Binder;
+
 import java.io.Serializable;
 import java.lang.reflect.Modifier;
 import java.util.ArrayList;
@@ -37,6 +39,9 @@
  * @since 7.5.0
  *
  * @author Vaadin Ltd
+ *
+ * @deprecated As of 8.0, a lightweight lambda-based converter can be build with
+ *  {@link Binder}{@code .forField(...).withConverter(...)} methods.
  */
 @Deprecated
 public class StringToCollectionConverter

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

@@ -15,6 +15,8 @@
  */
 package com.vaadin.v7.data.util.converter;
 
+import com.vaadin.data.Binder;
+
 import java.util.EnumSet;
 import java.util.Locale;
 
@@ -35,6 +37,9 @@
  *
  * @author Vaadin Ltd
  * @since 7.4
+ *
+ * @deprecated As of 8.0, a lightweight lambda-based converter can be build with
+ *  {@link Binder}{@code .forField(...).withConverter(...)} methods.
  */
 @Deprecated
 public class StringToEnumConverter implements Converter<String, Enum> {

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

@@ -29,6 +29,8 @@
  *
  * @author Vaadin Ltd
  * @since 7.4
+ *
+ * @deprecated As of 8.0, no direct replacement available, see {@link com.vaadin.data.converter.StringToIntegerConverter}
  */
 @Deprecated
 public class StringToShortConverter

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

@@ -19,6 +19,7 @@
 import java.util.Collection;
 import java.util.Collections;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 
 /**
@@ -28,6 +29,8 @@
  * implementing {@link Filter} for in-memory filters.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public abstract class AbstractJunctionFilter implements Filter {

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -30,6 +31,8 @@
  * @see Or
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public final class And extends AbstractJunctionFilter {

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

@@ -17,10 +17,14 @@
 
 import java.util.Arrays;
 
+import com.vaadin.data.provider.Query;
 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
 public class Between implements Filter {
 

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -32,6 +33,8 @@
  * reference value.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public abstract class Compare implements Filter {
@@ -55,6 +58,8 @@ public enum Operation {
      * use e.g. database comparison operations.
      *
      * @since 6.6
+     *
+     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
      */
     @Deprecated
     public static final class Equal extends Compare {
@@ -88,6 +93,8 @@ public Equal(Object propertyId, Object value) {
      * and may use e.g. database comparison operations.
      *
      * @since 6.6
+     *
+     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
      */
     @Deprecated
     public static final class Greater extends Compare {
@@ -122,6 +129,8 @@ public Greater(Object propertyId, Object value) {
      * and may use e.g. database comparison operations.
      *
      * @since 6.6
+     *
+     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
      */
     @Deprecated
     public static final class Less extends Compare {
@@ -156,6 +165,8 @@ public Less(Object propertyId, Object value) {
      * and may use e.g. database comparison operations.
      *
      * @since 6.6
+     *
+     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
      */
     @Deprecated
     public static final class GreaterOrEqual extends Compare {
@@ -190,6 +201,8 @@ public GreaterOrEqual(Object propertyId, Object value) {
      * and may use e.g. database comparison operations.
      *
      * @since 6.6
+     *
+     * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
      */
     @Deprecated
     public static final class LessOrEqual extends Compare {

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -25,6 +26,8 @@
  * This filter also directly supports in-memory filtering.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public final class IsNull implements Filter {

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

@@ -15,9 +15,13 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 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
 public class Like implements Filter {
     private final Object propertyId;

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -25,6 +26,8 @@
  * does so.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public final class Not implements Filter {

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 
@@ -30,6 +31,8 @@
  * @see And
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public final class Or extends AbstractJunctionFilter {

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

@@ -15,6 +15,7 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
 import com.vaadin.v7.data.Container.Filter;
 import com.vaadin.v7.data.Item;
 import com.vaadin.v7.data.Property;
@@ -34,6 +35,8 @@
  * TODO this might still change
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public final class SimpleStringFilter implements Filter {

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

@@ -15,6 +15,8 @@
  */
 package com.vaadin.v7.data.util.filter;
 
+import com.vaadin.data.provider.Query;
+
 import java.io.Serializable;
 
 /**
@@ -27,6 +29,8 @@
  * perform filtering.
  *
  * @since 6.6
+ *
+ * @deprecated As of 8.0, no replacement available. See {@link Query#getFilter()}
  */
 @Deprecated
 public class UnsupportedFilterException extends RuntimeException

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

@@ -26,6 +26,9 @@
  *
  * @author Vaadin Ltd.
  * @since 5.4
+ *
+ *
+ * @deprecated As of 8.0, replaced by {@link com.vaadin.data.validator.AbstractValidator}
  */
 @SuppressWarnings("serial")
 @Deprecated

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

@@ -42,6 +42,8 @@
  *            The type
  * @author Vaadin Ltd.
  * @since 5.4
+ *
+ * @deprecated As of 8.0, replaced by {@link com.vaadin.data.validator.AbstractValidator}
  */
 @Deprecated
 public abstract class AbstractValidator<T> implements Validator {

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

@@ -26,6 +26,7 @@
 import javax.validation.ValidatorFactory;
 import javax.validation.metadata.ConstraintDescriptor;
 
+import com.vaadin.data.BeanValidationBinder;
 import com.vaadin.v7.data.Validator;
 
 /**
@@ -43,6 +44,8 @@
  *
  * @author Petri Hakala
  * @author Henri Sara
+ *
+ * @deprecated See {@link BeanValidationBinder} and {@link com.vaadin.data.validator.BeanValidator}
  */
 @Deprecated
 public class BeanValidator implements Validator {

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

@@ -21,6 +21,8 @@
 import java.util.LinkedList;
 import java.util.List;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.HasValue;
 import com.vaadin.v7.data.Validator;
 
 /**
@@ -32,6 +34,10 @@
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no direct replacement available. See {@link Binder#forField(HasValue)} and various methods for
+ * validation and conversion chaining: {@code withValidator(...)}, {@code withConverter(...)},
+ * {@code withNullRepresentation(...)}
  */
 @SuppressWarnings("serial")
 @Deprecated

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

@@ -16,6 +16,8 @@
 
 package com.vaadin.v7.data.validator;
 
+import com.vaadin.data.Binder;
+import com.vaadin.data.HasValue;
 import com.vaadin.v7.data.Validator;
 
 /**
@@ -24,6 +26,10 @@
  *
  * @author Vaadin Ltd.
  * @since 3.0
+ *
+ * @deprecated As of 8.0, no direct replacement available. See {@link Binder#forField(HasValue)} and various methods for
+ * validation and conversion chaining: {@code withValidator(...)}, {@code withConverter(...)},
+ * {@code withNullRepresentation(...)}
  */
 @SuppressWarnings("serial")
 @Deprecated