/*
 * Copyright (C) 2013 Square, 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 retrofit.client;

import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import retrofit.mime.TypedInput;

/** An HTTP response. */
public final class Response {
  private final String url;
  private final int status;
  private final String reason;
  private final List<Header> headers;
  private final TypedInput body;

  public Response(String url, int status, String reason, List<Header> headers, TypedInput body) {
    if (url == null) {
      throw new IllegalArgumentException("url == null");
    }
    if (status < 200) {
      throw new IllegalArgumentException("Invalid status code: " + status);
    }
    if (reason == null) {
      throw new IllegalArgumentException("reason == null");
    }
    if (headers == null) {
      throw new IllegalArgumentException("headers == null");
    }

    this.url = url;
    this.status = status;
    this.reason = reason;
    this.headers = Collections.unmodifiableList(new ArrayList<Header>(headers));
    this.body = body;
  }

  @Deprecated
  public Response(int status, String reason, List<Header> headers, TypedInput body) {
    if (status < 200) {
      throw new IllegalArgumentException("Invalid status code: " + status);
    }
    if (reason == null) {
      throw new IllegalArgumentException("reason == null");
    }
    if (headers == null) {
      throw new IllegalArgumentException("headers == null");
    }

    this.url = null;
    this.status = status;
    this.reason = reason;
    this.headers = Collections.unmodifiableList(new ArrayList<Header>(headers));
    this.body = body;
  }

  /** Request URL. */
  public String getUrl() {
    return url;
  }

  /** Status line code. */
  public int getStatus() {
    return status;
  }

  /** Status line reason phrase. */
  public String getReason() {
    return reason;
  }

  /** An unmodifiable collection of headers. */
  public List<Header> getHeaders() {
    return headers;
  }

  /** Response body. May be {@code null}. */
  public TypedInput getBody() {
    return body;
  }
}

@@ -1606,16 +1606,165 @@
 y;%0A  %7D%0A%0A
+  /**%0A   * @deprecated Use %7B@link #Response(String, int, String, java.util.List, TypedInput)%7D. This class%0A   * will be removed in version 1.5.%0A   */%0A
   @Depre

Add comment for now-deprecated Response constructor.