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

Поваренная книга 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, поэтому его легко импортировать и запускать как есть.