Deprecate VersioningIntent (#2561)

Author: Quinn-With-Two-Ns

temporal-sdk/src/main/java/io/temporal/activity/ActivityOptions.java

@@ -41,7 +41,10 @@ public static final class Builder {
     private List<ContextPropagator> contextPropagators;
     private ActivityCancellationType cancellationType;
     private boolean disableEagerExecution;
+
+    @SuppressWarnings("deprecation")
     private VersioningIntent versioningIntent;
+
     private String summary;
     private Priority priority;
 
@@ -219,7 +222,10 @@ public Builder setDisableEagerExecution(boolean disableEagerExecution) {
     /**
      * Specifies whether this activity should run on a worker with a compatible Build Id or not. See
      * the variants of {@link VersioningIntent}.
+     *
+     * @deprecated Use Worker Deployments
      */
+    @Deprecated
     public Builder setVersioningIntent(VersioningIntent versioningIntent) {
       this.versioningIntent = versioningIntent;
       return this;
@@ -249,6 +255,7 @@ public Builder setPriority(Priority priority) {
       return this;
     }
 
+    @SuppressWarnings("deprecation")
     public Builder mergeActivityOptions(ActivityOptions override) {
       if (override == null) {
         return this;
@@ -309,6 +316,7 @@ public ActivityOptions build() {
           priority);
     }
 
+    @SuppressWarnings("deprecation")
     public ActivityOptions validateAndBuildWithDefaults() {
       return new ActivityOptions(
           heartbeatTimeout,
@@ -337,7 +345,10 @@ public ActivityOptions validateAndBuildWithDefaults() {
   private final List<ContextPropagator> contextPropagators;
   private final ActivityCancellationType cancellationType;
   private final boolean disableEagerExecution;
+
+  @SuppressWarnings("deprecation")
   private final VersioningIntent versioningIntent;
+
   private final String summary;
   private final Priority priority;
 
@@ -351,7 +362,7 @@ private ActivityOptions(
       List<ContextPropagator> contextPropagators,
       ActivityCancellationType cancellationType,
       boolean disableEagerExecution,
-      VersioningIntent versioningIntent,
+      @SuppressWarnings("deprecation") VersioningIntent versioningIntent,
       String summary,
       Priority priority) {
     this.heartbeatTimeout = heartbeatTimeout;
@@ -430,7 +441,10 @@ public boolean isEagerExecutionDisabled() {
 
   /**
    * @see ActivityOptions.Builder#setVersioningIntent(VersioningIntent)
+   * @deprecated Worker Versioning is now deprecated please migrate to the <a
+   *     href="https://docs.temporal.io/worker-deployments">Worker Deployment API</a>.
    */
+  @Deprecated
   public VersioningIntent getVersioningIntent() {
     return versioningIntent;
   }

temporal-sdk/src/main/java/io/temporal/common/VersioningIntent.java

@@ -4,6 +4,7 @@
  * Indicates whether the user intends certain commands to be run on a compatible worker Build Id
  * version or not.
  */
+@Deprecated
 public enum VersioningIntent {
   /**
    * Indicates that the SDK should choose the most sensible default behavior for the type of

temporal-sdk/src/main/java/io/temporal/internal/sync/SyncWorkflowContext.java

@@ -554,6 +554,7 @@ private CompletablePromise<Optional<Payloads>> executeLocalActivityLocally(
     return callback.result;
   }
 
+  @SuppressWarnings("deprecation")
   private ExecuteActivityParameters constructExecuteActivityParameters(
       String name, ActivityOptions options, Header header, Optional<Payloads> input) {
     String taskQueue = options.getTaskQueue();

temporal-sdk/src/main/java/io/temporal/workflow/ChildWorkflowOptions.java

@@ -52,7 +52,10 @@ public static final class Builder {
     private SearchAttributes typedSearchAttributes;
     private List<ContextPropagator> contextPropagators;
     private ChildWorkflowCancellationType cancellationType;
+
+    @SuppressWarnings("deprecation")
     private VersioningIntent versioningIntent;
+
     private String staticSummary;
     private String staticDetails;
     private Priority priority;
@@ -283,7 +286,11 @@ public Builder setCronSchedule(CronSchedule c) {
     /**
      * Specifies whether this child workflow should run on a worker with a compatible Build Id or
      * not. See the variants of {@link VersioningIntent}.
+     *
+     * @deprecated Worker Versioning is now deprecated please migrate to the <a
+     *     href="https://docs.temporal.io/worker-deployments">Worker Deployment API</a>.
      */
+    @Deprecated
     public Builder setVersioningIntent(VersioningIntent versioningIntent) {
       this.versioningIntent = versioningIntent;
       return this;
@@ -347,6 +354,7 @@ public ChildWorkflowOptions build() {
           priority);
     }
 
+    @SuppressWarnings("deprecation")
     public ChildWorkflowOptions validateAndBuildWithDefaults() {
       return new ChildWorkflowOptions(
           namespace,
@@ -390,7 +398,10 @@ public ChildWorkflowOptions validateAndBuildWithDefaults() {
   private final SearchAttributes typedSearchAttributes;
   private final List<ContextPropagator> contextPropagators;
   private final ChildWorkflowCancellationType cancellationType;
+
+  @SuppressWarnings("deprecation")
   private final VersioningIntent versioningIntent;
+
   private final String staticSummary;
   private final String staticDetails;
   private final Priority priority;
@@ -411,7 +422,7 @@ private ChildWorkflowOptions(
       SearchAttributes typedSearchAttributes,
       List<ContextPropagator> contextPropagators,
       ChildWorkflowCancellationType cancellationType,
-      VersioningIntent versioningIntent,
+      @SuppressWarnings("deprecation") VersioningIntent versioningIntent,
       String staticSummary,
       String staticDetails,
       Priority priority) {
@@ -500,6 +511,11 @@ public ChildWorkflowCancellationType getCancellationType() {
     return cancellationType;
   }
 
+  /**
+   * @deprecated Worker Versioning is now deprecated please migrate to the <a
+   *     href="https://docs.temporal.io/worker-deployments">Worker Deployment API</a>.
+   */
+  @Deprecated
   public VersioningIntent getVersioningIntent() {
     return versioningIntent;
   }

temporal-sdk/src/main/java/io/temporal/workflow/ContinueAsNewOptions.java

@@ -1,8 +1,6 @@
 package io.temporal.workflow;
 
-import io.temporal.common.RetryOptions;
-import io.temporal.common.SearchAttributes;
-import io.temporal.common.VersioningIntent;
+import io.temporal.common.*;
 import io.temporal.common.context.ContextPropagator;
 import java.time.Duration;
 import java.util.List;
@@ -43,6 +41,8 @@ public static final class Builder {
     private Map<String, Object> searchAttributes;
     private SearchAttributes typedSearchAttributes;
     private List<ContextPropagator> contextPropagators;
+
+    @SuppressWarnings("deprecation")
     private VersioningIntent versioningIntent;
 
     private Builder() {}
@@ -121,7 +121,11 @@ public Builder setContextPropagators(List<ContextPropagator> contextPropagators)
     /**
      * Specifies whether this continued workflow should run on a worker with a compatible Build Id
      * or not. See the variants of {@link VersioningIntent}.
+     *
+     * @deprecated Worker Versioning is now deprecated please migrate to the <a
+     *     href="https://docs.temporal.io/worker-deployments">Worker Deployment API</a>.
      */
+    @Deprecated
     public Builder setVersioningIntent(VersioningIntent versioningIntent) {
       this.versioningIntent = versioningIntent;
       return this;
@@ -149,6 +153,8 @@ public ContinueAsNewOptions build() {
   private final @Nullable Map<String, Object> searchAttributes;
   private final @Nullable SearchAttributes typedSearchAttributes;
   private final @Nullable List<ContextPropagator> contextPropagators;
+
+  @SuppressWarnings("deprecation")
   private final @Nullable VersioningIntent versioningIntent;
 
   public ContinueAsNewOptions(
@@ -160,7 +166,7 @@ public ContinueAsNewOptions(
       @Nullable Map<String, Object> searchAttributes,
       @Nullable SearchAttributes typedSearchAttributes,
       @Nullable List<ContextPropagator> contextPropagators,
-      @Nullable VersioningIntent versioningIntent) {
+      @SuppressWarnings("deprecation") @Nullable VersioningIntent versioningIntent) {
     this.workflowRunTimeout = workflowRunTimeout;
     this.taskQueue = taskQueue;
     this.retryOptions = retryOptions;
@@ -209,6 +215,11 @@ public RetryOptions getRetryOptions() {
     return contextPropagators;
   }
 
+  /**
+   * @deprecated Worker Versioning is now deprecated please migrate to the <a
+   *     href="https://docs.temporal.io/worker-deployments">Worker Deployment API</a>.
+   */
+  @Deprecated
   public @Nullable VersioningIntent getVersioningIntent() {
     return versioningIntent;
   }