code: package io.ray.api.call;
  
  import io.ray.api.options.ActorCreationOptions;
  import io.ray.api.options.ActorLifetime;
  import io.ray.api.placementgroup.PlacementGroup;
  import java.util.Map;
  
  /**
   * Base helper to create actor.
   *
   * @param <T> The type of the concrete actor creator
   */
  public class BaseActorCreator<T extends BaseActorCreator> {
    protected ActorCreationOptions.Builder builder = new ActorCreationOptions.Builder();
  
    /**
     * Set the actor name of a named actor.
     *
     * @param name The name of the named actor.
     * @return self
     * @see io.ray.api.options.ActorCreationOptions.Builder#setName(String)
     */
    public T setName(String name) {
      builder.setName(name);
      return self();
    }
  
    /**
     * Set the actor name along with a different namespace.
     *
     * @param name The name of the named actor.
     * @param namespace The namespace that this actor will live in.
     * @return self
     */
    public T setName(String name, String namespace) {
      builder.setName(name);
      builder.setNamespace(namespace);
      return self();
    }
  
    public T setLifetime(ActorLifetime lifetime) {
      builder.setLifetime(lifetime);
      return self();
    }
  
    /**
     * Set a custom resource requirement to reserve for the lifetime of this actor. This method can be
     * called multiple times. If the same resource is set multiple times, the latest quantity will be
     * used.
     *
     * @param resourceName resource name
     * @param resourceQuantity resource quantity
     * @return self
     * @see ActorCreationOptions.Builder#setResource(java.lang.String, java.lang.Double)
     */
    public T setResource(String resourceName, Double resourceQuantity) {
      builder.setResource(resourceName, resourceQuantity);
      return self();
    }
  
    /**
     * Set custom resource requirements to reserve for the lifetime of this actor. This method can be
     * called multiple times. If the same resource is set multiple times, the latest quantity will be
     * used.
     *
     * @param resources requirements for multiple resources.
     * @return self
     * @see BaseActorCreator#setResources(java.util.Map)
     */
    public T setResources(Map<String, Double> resources) {
      builder.setResources(resources);
      return self();
    }
  
    /**
     * This specifies the maximum number of times that the actor should be restarted when it dies
     * unexpectedly. The minimum valid value is 0 (default), which indicates that the actor doesn't
     * need to be restarted. A value of -1 indicates that an actor should be restarted indefinitely.
     *
     * @param maxRestarts max number of actor restarts
     * @return self
     * @see ActorCreationOptions.Builder#setMaxRestarts(int)
     */
    public T setMaxRestarts(int maxRestarts) {
      builder.setMaxRestarts(maxRestarts);
      return self();
    }
  
    /**
     * This specifies the maximum number of times that an actor task can be retried. The minimum valid
     * value is 0 (default), which indicates that the actor task can't be retried. A value of -1
     * indicates that an actor task can be retried indefinitely.
     *
     * @param maxTaskRetries max number of actor task retries
     * @return self
     * @see ActorCreationOptions.Builder#setMaxTaskRetries(int)
     */
    public T setMaxTaskRetries(int maxTaskRetries) {
      builder.setMaxTaskRetries(maxTaskRetries);
      return self();
    }
  
    /**
     * Set the max number of concurrent calls to allow for this actor.
     *
     * <p>The maximum concurrency defaults to 1 for threaded execution. Note that the execution order
     * is not guaranteed when {@code max_concurrency > 1}.
     *
     * @param maxConcurrency The maximum number of concurrent calls to allow for this actor.
     * @return self
     * @see ActorCreationOptions.Builder#setMaxConcurrency(int)
     */
    public T setMaxConcurrency(int maxConcurrency) {
      builder.setMaxConcurrency(maxConcurrency);
      return self();
    }
  
    /**
     * Set the max number of pending calls allowed on the actor handle. When this value is exceeded,
     * ray.exceptions.PendingCallsLimitExceededException will be thrown for further tasks. Note that
     * this limit is counted per handle. -1 means that the number of pending calls is unlimited.
     *
     * @param maxPendingCalls The maximum number of pending calls for this actor.
     * @return self
     */
    public T setMaxPendingCalls(int maxPendingCalls) {
      builder.setMaxPendingCalls(maxPendingCalls);
      return self();
    }
  
    /**
     * Set the placement group to place this actor in.
     *
     * @param group The placement group of the actor.
     * @param bundleIndex The index of the bundle to place this actor in.
     * @return self
     * @see ActorCreationOptions.Builder#setPlacementGroup(PlacementGroup, int)
     */
    public T setPlacementGroup(PlacementGroup group, int bundleIndex) {
      builder.setPlacementGroup(group, bundleIndex);
      return self();
    }
  
    /**
     * Set the placement group to place this actor in, which may use any available bundle.
     *
     * @param group The placement group of the actor.
     * @return self
     * @see ActorCreationOptions.Builder#setPlacementGroup(PlacementGroup, int)
     */
    public T setPlacementGroup(PlacementGroup group) {
      return setPlacementGroup(group, -1);
    }
  
    @SuppressWarnings("unchecked")
    private T self() {
      return (T) this;
    }
  
    protected ActorCreationOptions buildOptions() {
      return builder.build();
    }
  }
  