API: Add missing deprecations (apache#11734)

api/src/main/java/org/apache/iceberg/transforms/Bucket.java

@@ -43,6 +43,12 @@ static <T> Bucket<T> get(int numBuckets) {
     return new Bucket<>(numBuckets);
   }
 
+  /**
+   * Instantiates a new Bucket Transform
+   *
+   * @deprecated will be removed in 2.0.0; use {@link #get(int)} instead
+   */
+  @Deprecated
   @SuppressWarnings("unchecked")
   static <T, B extends Bucket<T> & SerializableFunction<T, Integer>> B get(
       Type type, int numBuckets) {
@@ -94,6 +100,14 @@ protected int hash(T value) {
         "hash(value) is not supported on the base Bucket class");
   }
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param value a source value
+   * @return a transformed partition value
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public Integer apply(T value) {
     if (value == null) {

api/src/main/java/org/apache/iceberg/transforms/Dates.java

@@ -73,6 +73,14 @@ public Integer apply(Integer days) {
     this.apply = new Apply(granularity);
   }
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param days a source value
+   * @return a transformed partition value
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public Integer apply(Integer days) {
     return apply.apply(days);

api/src/main/java/org/apache/iceberg/transforms/Identity.java

@@ -71,6 +71,14 @@ private Identity(Type type) {
     this.type = type;
   }
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param value a source value
+   * @return a transformed partition value
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public T apply(T value) {
     return value;

api/src/main/java/org/apache/iceberg/transforms/Timestamps.java

@@ -52,6 +52,14 @@ enum Timestamps implements Transform<Long, Integer> {
     this.apply = apply;
   }
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param timestamp a source value
+   * @return a transformed partition value
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public Integer apply(Long timestamp) {
     return apply.apply(timestamp);

api/src/main/java/org/apache/iceberg/transforms/UnknownTransform.java

@@ -33,6 +33,15 @@ public class UnknownTransform<S, T> implements Transform<S, T> {
     this.transform = transform;
   }
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param value a source value
+   * @return ∅
+   * @throws UnsupportedOperationException Implementation is unknown
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public T apply(S value) {
     throw new UnsupportedOperationException(

api/src/main/java/org/apache/iceberg/transforms/VoidTransform.java

@@ -49,6 +49,14 @@ public Void apply(S t) {
 
   private VoidTransform() {}
 
+  /**
+   * Transforms a value to its corresponding partition value.
+   *
+   * @param value a source value
+   * @return null
+   * @deprecated will be removed in 2.0.0; use {@link #bind(Type)} instead
+   */
+  @Deprecated
   @Override
   public Void apply(Object value) {
     return null;
@@ -84,6 +92,16 @@ public boolean isVoid() {
     return true;
   }
 
+  /**
+   * Returns a human-readable String representation of a transformed value.
+   *
+   * <p>null values will return "null"
+   *
+   * @param value a transformed value
+   * @return a human-readable String representation of null
+   * @deprecated will be removed in 2.0.0; use {@link #toHumanString(Type, Object)} instead
+   */
+  @Deprecated
   @Override
   public String toHumanString(Void value) {
     return "null";