Перейти к основному содержимому

Поваренная книга Apache HttpClient 4

· 3 мин. чтения

1. Обзор​

Эта кулинарная книга показывает, как использовать Apache HttpClient в различных примерах и вариантах использования.

Основное внимание уделяется HttpClient 4.3.x и выше , поэтому некоторые примеры могут не работать со старыми версиями API.

Формат поваренной книги ориентирован на примеры и практичен – никаких лишних деталей и объяснений не требуется.

Если вы хотите копнуть глубже и узнать о других интересных вещах, которые можно делать с помощью HttpClient, — перейдите к основному руководству по HttpClient .

2. Поваренная книга​

создать http-клиент

CloseableHttpClient client = HttpClientBuilder.create().build();

отправить базовый запрос GET

instance.execute(new HttpGet("http://www.google.com"));

получить код состояния ответа HTTP

CloseableHttpResponse response = instance.execute(new HttpGet("http://www.google.com"));
assertThat(response.getStatusLine().getStatusCode(), equalTo(200));

получить тип носителя ответа 

CloseableHttpResponse response = instance.execute(new HttpGet("http://www.google.com"));
String contentMimeType = ContentType.getOrDefault(response.getEntity()).getMimeType();
assertThat(contentMimeType, equalTo(ContentType.TEXT_HTML.getMimeType()));

получить тело ответа

CloseableHttpResponse response = instance.execute(new HttpGet("http://www.google.com"));
String bodyAsString = EntityUtils.toString(response.getEntity());
assertThat(bodyAsString, notNullValue());

настроить таймаут на запрос

@Test(expected = SocketTimeoutException.class)
public void givenLowTimeout_whenExecutingRequestWithTimeout_thenException() 
    throws ClientProtocolException, IOException {
    RequestConfig requestConfig = RequestConfig.custom()
      .setConnectionRequestTimeout(1000).setConnectTimeout(1000).setSocketTimeout(1000).build();
    HttpGet request = new HttpGet(SAMPLE_URL);
    request.setConfig(requestConfig);
    instance.execute(request);
}

настроить таймаут на всем клиенте

RequestConfig requestConfig = RequestConfig.custom().
    setConnectionRequestTimeout(1000).setConnectTimeout(1000).setSocketTimeout(1000).build();
HttpClientBuilder builder = HttpClientBuilder.create().setDefaultRequestConfig(requestConfig);

отправить POST-запрос

instance.execute(new HttpPost(SAMPLE_URL));

добавить параметры в запрос

List<NameValuePair> params = new ArrayList<NameValuePair>();
params.add(new BasicNameValuePair("key1", "value1"));
params.add(new BasicNameValuePair("key2", "value2"));
request.setEntity(new UrlEncodedFormEntity(params, Consts.UTF_8));

настроить, как перенаправление обрабатывается для HTTP-запроса

CloseableHttpClient instance = HttpClientBuilder.create().disableRedirectHandling().build();
CloseableHttpResponse response = instance.execute(new HttpGet("http://t.co/I5YYd9tddw"));
assertThat(response.getStatusLine().getStatusCode(), equalTo(301));

настроить заголовки для запроса

HttpGet request = new HttpGet(SAMPLE_URL);
request.addHeader(HttpHeaders.ACCEPT, "application/xml");
response = instance.execute(request);

получить заголовки из ответа

CloseableHttpResponse response = instance.execute(new HttpGet(SAMPLE_URL));
Header[] headers = response.getHeaders(HttpHeaders.CONTENT_TYPE);
assertThat(headers, not(emptyArray()));

закрыть/освободить ресурсы

response = instance.execute(new HttpGet(SAMPLE_URL));
try {
    HttpEntity entity = response.getEntity();
    if (entity != null) {
        InputStream instream = entity.getContent();
        instream.close();
    }
} finally {
    response.close();
}

3. Углубитесь в HttpClient​

Библиотека HttpClient — довольно мощный инструмент при правильном использовании — если вы хотите начать изучать возможности клиента — ознакомьтесь с некоторыми руководствами:

Вы также можете углубиться в HttpClient , изучив всю серию .

4. Вывод​

Этот формат немного отличается от того, как я обычно структурирую свои статьи — я публикую некоторые из своих внутренних руководств по разработке на заданную тему — на Google Guava , Hamcrest и Mockito — а теперь и на HttpClient. Цель состоит в том, чтобы эта информация была легко доступна в Интернете и добавлялась к ней каждый раз, когда я сталкивался с новым полезным примером.

Реализацию всех этих примеров и фрагментов кода можно найти на GitHub .

Это проект на основе Maven, поэтому его легко импортировать и запускать как есть.