/*
 * Copyright (c) 2015-present, Parse, LLC.
 * All rights reserved.
 *
 * This source code is licensed under the BSD-style license found in the
 * LICENSE file in the root directory of this source tree. An additional grant
 * of patent rights can be found in the PATENTS file in the same directory.
 */
package com.parse;

import java.io.IOException;

// TODO(mengyan): Add java doc and make it public before we launch it
/** package */ interface ParseNetworkInterceptor {

  ParseHttpResponse intercept(Chain chain) throws IOException;

  interface Chain {
    ParseHttpRequest getRequest();
    ParseHttpResponse proceed(ParseHttpRequest request) throws IOException;
  }
}

@@ -352,192 +352,755 @@
 ;%0A%0A/
-/ TODO(mengyan): Add java doc and make it public before we launch it%0A/** package */ interface ParseNetworkInterceptor %7B%0A%0A  ParseHttpResponse intercept(Chain chain) throws IOException;%0A
+**%0A * %7B@code ParseNetworkInterceptor%7D is used to observe requests going out and the corresponding responses coming%0A * back in.%0A */%0A/** package */ interface ParseNetworkInterceptor %7B%0A%0A  /**%0A   * @param chain%0A   *          The helper chain we used to get the request, proceed the request and receive the%0A   *          response.%0A   * @return The intercepted response.%0A   * @throws IOException%0A   */%0A  ParseHttpResponse intercept(Chain chain) throws IOException;%0A%0A  /**%0A   * %7B@code Chain%7D is used to chain the interceptors. It can get the request from the previous%0A   * interceptor, proceed the request to the next interceptor and get the response from the next%0A   * interceptor. In most of the cases, you don't need to implement this interface.%0A   */
 %0A  i

Add comment for ParseNetworkInterceptor