com.linkedin.restli.client.ParSeqRestliClient Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of parseq-restli-client Show documentation
Uploads all artifacts belonging to configuration ':parseq-restli-client:archives'
There is a newer version: 4.0.1
/*
 * Copyright 2016 LinkedIn, Inc
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.linkedin.restli.client;

import com.linkedin.parseq.Task;
import com.linkedin.parseq.promise.Promise;
import com.linkedin.r2.message.RequestContext;
import com.linkedin.restli.client.config.RequestConfigOverrides;
import com.linkedin.restli.client.config.RequestConfigOverridesBuilder;
import com.linkedin.restli.client.metrics.Metrics;

/**
 * ParSeq rest.li client.
 *
 * @author Jaroslaw Odzga ([email protected])
 *
 */
public interface ParSeqRestliClient {

  /**
   * Sends a type-bound REST request, returning a promise.
   *
   * @deprecated Use higher level API that returns Task instance, see {@link #createTask(Request)}. This method is
   * left for backwards compatibility.
   * @param request to send
   * @param  type of the result
   * @return response promise
   * @see #createTask(Request)
   */
  @Deprecated
  public  Promise> sendRequest(final Request request);

  /**
   * Sends a type-bound REST request, returning a promise.
   *
   * @deprecated Use higher level API that returns Task instance, see {@link #createTask(Request, RequestContext)}. This method is
   * left for backwards compatibility.
   * @param request to send
   * @param requestContext context for the request
   * @param  type of the result
   * @return response promise
   */
  @Deprecated
  public  Promise> sendRequest(final Request request, final RequestContext requestContext);

  /**
   * Creates a task that makes rest.li request and returns response.
   *
   * @param request request to be made
   * @param  type of the result
   * @return Task that returns response for given request
   */
  public  Task> createTask(final Request request);

  /**
   * Creates a task that makes rest.li request and returns response.
   * 
   * Passed in {@code configOverrides} will override any existing configuration. Not all properties need to be set.
   * Use {@link RequestConfigOverridesBuilder} to create instance of {@link RequestConfigOverrides}.
   *
   * @param request request to be made
   * @param configOverrides configuration overrides
   * @param  type of the result
   * @return Task that returns response
   */
  public  Task> createTask(final Request request, final RequestConfigOverrides configOverrides);

  /**
   * Creates a task that makes rest.li request and returns response.
   *
   * @param request request to be made
   * @param requestContext context for the request
   * @param  type of the result
   * @return Task that returns response
   */
  public  Task> createTask(final Request request, final RequestContext requestContext);

  /**
   * Creates a task that makes rest.li request and returns response.
   * 
   * Passed in {@code configOverrides} will override any existing configuration. Not all properties need to be set.
   * Use {@link RequestConfigOverridesBuilder} to create instance of {@link RequestConfigOverrides}.
   *
   * @param request request to be made
   * @param requestContext context for the request
   * @param configOverrides configuration overrides
   * @param  type of the result
   * @return Task that returns response
   */
  public  Task> createTask(final Request request, final RequestContext requestContext, final RequestConfigOverrides configOverrides);

  /**
   * Returns ParSeq rest.li client's metrics.
   * @return metrics
   */
  public Metrics getMetrics();
}