/* Copyright (c) 2009 Matthias Kaeppler
 *
 * 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.github.droidfu.http;

import java.net.ConnectException;

import org.apache.http.client.methods.HttpUriRequest;

public interface BetterHttpRequest {

    public HttpUriRequest unwrap();

    public String getRequestUrl();

    public BetterHttpRequest expecting(Integer... statusCodes);

    public BetterHttpRequest retries(int retries);

    public BetterHttpResponse send() throws ConnectException;
}

@@ -665,16 +665,69 @@
 ption;%0A%0A
+import org.apache.http.client.HttpResponseException;%0A
 import o
@@ -819,193 +819,1701 @@
     
-public HttpUriRequest unwrap();%0A%0A    public String getRequestUrl();%0A%0A    public BetterHttpRequest expecting(Integer... statusCodes);%0A%0A    public BetterHttpRequest retries(int retries);%0A
+/**%0A     * @return the HttpClient request object wrapped by this request%0A     */%0A    public HttpUriRequest unwrap();%0A%0A    /**%0A     * @return the request URL%0A     */%0A    public String getRequestUrl();%0A%0A    /**%0A     * Define the set of HTTP status codes which you anticipate to be returned by the server,%0A     * including error codes you'd like to explicitly handle. Any status code part of this set will%0A     * not be treated as an error, but returned to you as a normal server response. Any status codes%0A     * returned by the server that are %3Ci%3Enot%3C/i%3E part of this set will be raised as an%0A     * %7B@link HttpResponseException%7D. This is very useful when dealing with REST-ful Web services,%0A     * where it is common to serve error stati that indicate a failure in the application logic%0A     * (e.g. 404 if a resource doesn't exist). You typically don't want to treat those as connection%0A     * errors, but gracefully handle them like a normal success code.%0A     * %0A     * @param statusCodes%0A     *            the set of status codes that you want to manually handle as part of the response%0A     * @return this request%0A     */%0A    public BetterHttpRequest expecting(Integer... statusCodes);%0A%0A    /**%0A     * Set maximum number of retries for this particular request.%0A     * %0A     * @param retries%0A     *            the maximum number of retries should the request fail%0A     * @return this request%0A     */%0A    public BetterHttpRequest retries(int retries);%0A%0A    /**%0A     * Sends the current request. This method uses a special retry-logic (on top of that employed by%0A     * HttpClient, which is better suited to handle network fail-overs when e.g. switching between%0A     * Wi-Fi and 3G).%0A     */
 %0A   

add JavaDoc