1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/mobile/android/thirdparty/ch/boye/httpclientandroidlib/impl/client/BasicResponseHandler.java Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,75 @@ 1.4 +/* 1.5 + * ==================================================================== 1.6 + * Licensed to the Apache Software Foundation (ASF) under one 1.7 + * or more contributor license agreements. See the NOTICE file 1.8 + * distributed with this work for additional information 1.9 + * regarding copyright ownership. The ASF licenses this file 1.10 + * to you under the Apache License, Version 2.0 (the 1.11 + * "License"); you may not use this file except in compliance 1.12 + * with the License. You may obtain a copy of the License at 1.13 + * 1.14 + * http://www.apache.org/licenses/LICENSE-2.0 1.15 + * 1.16 + * Unless required by applicable law or agreed to in writing, 1.17 + * software distributed under the License is distributed on an 1.18 + * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 1.19 + * KIND, either express or implied. See the License for the 1.20 + * specific language governing permissions and limitations 1.21 + * under the License. 1.22 + * ==================================================================== 1.23 + * 1.24 + * This software consists of voluntary contributions made by many 1.25 + * individuals on behalf of the Apache Software Foundation. For more 1.26 + * information on the Apache Software Foundation, please see 1.27 + * <http://www.apache.org/>. 1.28 + * 1.29 + */ 1.30 + 1.31 +package ch.boye.httpclientandroidlib.impl.client; 1.32 + 1.33 +import java.io.IOException; 1.34 + 1.35 +import ch.boye.httpclientandroidlib.annotation.Immutable; 1.36 + 1.37 +import ch.boye.httpclientandroidlib.HttpEntity; 1.38 +import ch.boye.httpclientandroidlib.HttpResponse; 1.39 +import ch.boye.httpclientandroidlib.StatusLine; 1.40 +import ch.boye.httpclientandroidlib.client.ResponseHandler; 1.41 +import ch.boye.httpclientandroidlib.client.HttpResponseException; 1.42 +import ch.boye.httpclientandroidlib.util.EntityUtils; 1.43 + 1.44 +/** 1.45 + * A {@link ResponseHandler} that returns the response body as a String 1.46 + * for successful (2xx) responses. If the response code was >= 300, the response 1.47 + * body is consumed and an {@link HttpResponseException} is thrown. 1.48 + * 1.49 + * If this is used with 1.50 + * {@link ch.boye.httpclientandroidlib.client.HttpClient#execute( 1.51 + * ch.boye.httpclientandroidlib.client.methods.HttpUriRequest, ResponseHandler)}, 1.52 + * HttpClient may handle redirects (3xx responses) internally. 1.53 + * 1.54 + * 1.55 + * @since 4.0 1.56 + */ 1.57 +@Immutable 1.58 +public class BasicResponseHandler implements ResponseHandler<String> { 1.59 + 1.60 + /** 1.61 + * Returns the response body as a String if the response was successful (a 1.62 + * 2xx status code). If no response body exists, this returns null. If the 1.63 + * response was unsuccessful (>= 300 status code), throws an 1.64 + * {@link HttpResponseException}. 1.65 + */ 1.66 + public String handleResponse(final HttpResponse response) 1.67 + throws HttpResponseException, IOException { 1.68 + StatusLine statusLine = response.getStatusLine(); 1.69 + if (statusLine.getStatusCode() >= 300) { 1.70 + throw new HttpResponseException(statusLine.getStatusCode(), 1.71 + statusLine.getReasonPhrase()); 1.72 + } 1.73 + 1.74 + HttpEntity entity = response.getEntity(); 1.75 + return entity == null ? null : EntityUtils.toString(entity); 1.76 + } 1.77 + 1.78 +}