Класс HttpURLConnection

java.lang.Object
- java.net.URLConnection
- - java.net.HttpURLConnection

Прямые известные подклассы:: HttpsURLConnection

public abstract class HttpURLConnection
extends URLConnection

Класс URLConnection с поддержкой функций, специфичных для HTTP. Подробности см. в спецификации.

Каждый экземпляр HttpURLConnection используется для выполнения одного запроса, но базовое сетевое подключение к HTTP-серверу может быть прозрачно разделено другими экземплярами. Вызов методов close() для InputStream или OutputStream объекта HttpURLConnection после запроса может освободить сетевые ресурсы, связанные с этим экземпляром, но не повлияет на любые общие постоянные подключения. Вызов метода disconnect() может закрыть базовое сокетное соединение, если постоянное подключение в противном случае бездействует в этот момент.

Обработчик HTTP-протокола имеет несколько настроек, которые можно получить через системные свойства. Это касается настроек прокси, а также различных других настроек.

Разрешения безопасности

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

разрешением "connect" SocketPermission к сочетанию хост/порт целевого URL-адреса или
разрешением URLPermission, которое разрешает этот запрос.

Если автоматическое перенаправление включено, а этот запрос перенаправляется на другой ресурс, вызывающий метод также должен обладать разрешением на подключение к перенаправленному хосту/URL.

С:: JDK1.1
См. также:: disconnect()

Поля

Модификатор и тип	Поле и описание
`protected int`	`chunkLength` Размер блока при использовании потокового режима с фрагментацией для вывода.
`protected int`	`fixedContentLength` Фиксированный размер содержимого при использовании потокового режима с фиксированным размером.
`protected long`	`fixedContentLengthLong` Фиксированный размер содержимого при использовании потокового режима с фиксированным размером.
`static int`	`HTTP_ACCEPTED` HTTP код состояния 202: Принято.
`static int`	`HTTP_BAD_GATEWAY` HTTP код состояния 502: Плохой шлюз.
`static int`	`HTTP_BAD_METHOD` HTTP код состояния 405: Метод не разрешен.
`static int`	`HTTP_BAD_REQUEST` HTTP код состояния 400: Неверный запрос.
`static int`	`HTTP_CLIENT_TIMEOUT` HTTP код состояния 408: Время ожидания запроса истекло.
`static int`	`HTTP_CONFLICT` HTTP код состояния 409: Конфликт.
`static int`	`HTTP_CREATED` HTTP код состояния 201: Создано.
`static int`	`HTTP_ENTITY_TOO_LARGE` HTTP код состояния 413: Размер запрошенного тела слишком велик.
`static int`	`HTTP_FORBIDDEN` HTTP код состояния 403: Запрещено.
`static int`	`HTTP_GATEWAY_TIMEOUT` HTTP код состояния 504: Истекло время ожидания шлюза.
`static int`	`HTTP_GONE` HTTP код состояния 410: Удалено.
`static int`	`HTTP_INTERNAL_ERROR` HTTP код состояния 500: Внутренняя ошибка сервера.
`static int`	`HTTP_LENGTH_REQUIRED` HTTP код состояния 411: Требуется длина.
`static int`	`HTTP_MOVED_PERM` HTTP код состояния 301: Перемещено постоянно.
`static int`	`HTTP_MOVED_TEMP` HTTP код состояния 302: Временное перенаправление.
`static int`	`HTTP_MULT_CHOICE` HTTP код состояния 300: Несколько вариантов.
`static int`	`HTTP_NO_CONTENT` HTTP код состояния 204: Нет содержимого.
`static int`	`HTTP_NOT_ACCEPTABLE` HTTP код состояния 406: Неприемлемо.
`static int`	`HTTP_NOT_AUTHORITATIVE` HTTP код состояния 203: Неавторитетная информация.
`static int`	`HTTP_NOT_FOUND` HTTP код состояния 404: Не найдено.
`static int`	`HTTP_NOT_IMPLEMENTED` HTTP код состояния 501: Не реализовано.
`static int`	`HTTP_NOT_MODIFIED` HTTP код состояния 304: Не изменён.
`static int`	`HTTP_OK` HTTP код состояния 200: OK.
`static int`	`HTTP_PARTIAL` HTTP код состояния 206: Частичное содержимое.
`static int`	`HTTP_PAYMENT_REQUIRED` HTTP код состояния 402: Оплата требуется.
`static int`	`HTTP_PRECON_FAILED` HTTP код состояния 412: Условие не выполнено.
`static int`	`HTTP_PROXY_AUTH` HTTP код состояния 407: Требуется аутентификация прокси-сервера.
`static int`	`HTTP_REQ_TOO_LONG` HTTP код состояния 414: Запрос URI слишком большой.
`static int`	`HTTP_RESET` HTTP код состояния 205: Сброс содержимого.
`static int`	`HTTP_SEE_OTHER` HTTP код состояния 303: См. другое.
`static int`	`HTTP_SERVER_ERROR` Устаревшее. Неправильное расположение, не должно было существовать.
`static int`	`HTTP_UNAUTHORIZED` HTTP код состояния 401: Неавторизован.
`static int`	`HTTP_UNAVAILABLE` HTTP код состояния 503: Сервис недоступен.
`static int`	`HTTP_UNSUPPORTED_TYPE` HTTP код состояния 415: Неподдерживаемый тип медиа.
`static int`	`HTTP_USE_PROXY` HTTP код состояния 305: Использовать прокси.
`static int`	`HTTP_VERSION` HTTP код состояния 505: Неподдерживаемая версия HTTP.
`protected boolean`	`instanceFollowRedirects` Если `true`, протокол автоматически выполнит перенаправление.
`protected String`	`method` Метод HTTP (GET, POST, PUT и т.д.).
`protected int`	`responseCode` Целое число, представляющее трёхзначный HTTP код состояния.
`protected String`	`responseMessage` Сообщение HTTP ответа.

Поля, унаследованные от класса java.net.URLConnection

allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches

Конструкторы

Модификатор	Конструктор и описание
`protected`	`HttpURLConnection(URL u)` Конструктор для HttpURLConnection.

Методы

Модификатор и тип	Метод и описание
`abstract void`	`disconnect()` Указывает, что в ближайшее время другие запросы к серверу маловероятны.
`InputStream`	`getErrorStream()` Возвращает поток ошибок, если соединение было прервано, но сервер тем не менее отправил полезные данные.
`static boolean`	`getFollowRedirects()` Возвращает `boolean`, указывающий, следует ли автоматически следовать HTTP-перенаправлениям (3xx).
`String`	`getHeaderField(int n)` Возвращает значение поля заголовка с номером `n`.
`long`	`getHeaderFieldDate(String name, long Default)` Возвращает значение указанного поля, распарсенное как дата.
`String`	`getHeaderFieldKey(int n)` Возвращает ключ поля заголовка с номером `n`.
`boolean`	`getInstanceFollowRedirects()` Возвращает значение поля `instanceFollowRedirects` данного объекта `HttpURLConnection`.
`Permission`	`getPermission()` Возвращает объект `SocketPermission`, представляющий разрешение, необходимое для подключения к целевому хосту и порту.
`String`	`getRequestMethod()` Получить метод запроса.
`int`	`getResponseCode()` Получает код состояния из сообщения HTTP-ответа.
`String`	`getResponseMessage()` Получает сообщение HTTP-ответа, если оно есть, возвращённое вместе с кодом ответа от сервера.
`void`	`setChunkedStreamingMode(int chunklen)` Этот метод используется для включения потоковой передачи тела HTTP-запроса без внутренней буферизации, когда длина содержимого заранее не известна.
`void`	`setFixedLengthStreamingMode(int contentLength)` Этот метод используется для включения потоковой передачи тела HTTP-запроса без внутренней буферизации, когда длина содержимого известна заранее.
`void`	`setFixedLengthStreamingMode(long contentLength)` Этот метод используется для включения потоковой передачи тела HTTP-запроса без внутренней буферизации, когда длина содержимого известна заранее.
`static void`	`setFollowRedirects(boolean set)` Устанавливает, следует ли этому классу автоматически следовать HTTP-перенаправлениям (запросы с кодом ответа 3xx).
`void`	`setInstanceFollowRedirects(boolean followRedirects)` Устанавливает, следует ли этому экземпляру `HttpURLConnection` автоматически следовать HTTP-перенаправлениям (запросы с кодом ответа 3xx).
`void`	`setRequestMethod(String method)` Устанавливает метод для запроса URL, один из: GET POST HEAD OPTIONS PUT DELETE TRACE допустимы, с учётом ограничений протокола.
`abstract boolean`	`usingProxy()` Указывает, проходит ли соединение через прокси-сервер.

Методы, унаследованные от класса java.net.URLConnection

addRequestProperty, connect, getAllowUserInteraction, getConnectTimeout, getContent, getContent, getContentEncoding, getContentLength, getContentLengthLong, getContentType, getDate, getDefaultAllowUserInteraction, getDefaultRequestProperty, getDefaultUseCaches, getDoInput, getDoOutput, getExpiration, getFileNameMap, getHeaderField, getHeaderFieldInt, getHeaderFieldLong, getHeaderFields, getIfModifiedSince, getInputStream, getLastModified, getOutputStream, getReadTimeout, getRequestProperties, getRequestProperty, getURL, getUseCaches, guessContentTypeFromName, guessContentTypeFromStream, setAllowUserInteraction, setConnectTimeout, setContentHandlerFactory, setDefaultAllowUserInteraction, setDefaultRequestProperty, setDefaultUseCaches, setDoInput, setDoOutput, setFileNameMap, setIfModifiedSince, setReadTimeout, setRequestProperty, setUseCaches, toString

Методы, унаследованные от класса java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Поля

метод

protected String method

Метод HTTP (GET, POST, PUT и т.д.).

chunkLength

protected int chunkLength

Длина блока при использовании потокового режима с кодировкой chunked для вывода. Значение -1 означает, что кодировка chunked для вывода отключена.

Since:: 1.5

fixedContentLength

protected int fixedContentLength

Фиксированная длина содержимого при использовании потокового режима с фиксированной длиной. Значение -1 означает, что потоковый режим с фиксированной длиной отключен для вывода.

ПРИМЕЧАНИЕ: fixedContentLengthLong рекомендуется вместо этого поля, так как оно позволяет устанавливать более большие длины содержимого.

Since:: 1.5

fixedContentLengthLong

protected long fixedContentLengthLong

Since:: 1.7

responseCode

protected int responseCode

Значение, представляющее трехзначный код состояния HTTP.

1xx: Информационные
2xx: Успех
3xx: Перенаправление
4xx: Ошибка клиента
5xx: Ошибка сервера

responseMessage

protected String responseMessage

Сообщение ответа HTTP.

instanceFollowRedirects

protected boolean instanceFollowRedirects

Если true, протокол автоматически будет следовать перенаправлениям. Если false, протокол не будет автоматически следовать перенаправлениям.

Это поле устанавливается методом setInstanceFollowRedirects. Его значение возвращается методом getInstanceFollowRedirects.

Его значение по умолчанию основано на значении статической переменной followRedirects во время создания HttpURLConnection.

См. также:: setInstanceFollowRedirects(boolean), getInstanceFollowRedirects(), setFollowRedirects(boolean)

HTTP_OK

public static final int HTTP_OK

Код состояния HTTP 200: OK.

См. также:: Значения константных полей

HTTP_CREATED

public static final int HTTP_CREATED

Код состояния HTTP 201: Создано.

См. также:: Значения константных полей

HTTP_ACCEPTED

public static final int HTTP_ACCEPTED

Код состояния HTTP 202: Принято.

См. также:: Значения константных полей

HTTP_NOT_AUTHORITATIVE

public static final int HTTP_NOT_AUTHORITATIVE

Код состояния HTTP 203: Информация не авторитетная.

См. также:: Значения константных полей

HTTP_NO_CONTENT

public static final int HTTP_NO_CONTENT

Код состояния HTTP 204: Содержимого нет.

См. также:: Значения константных полей

HTTP_RESET

public static final int HTTP_RESET

Код состояния HTTP 205: Сбросить содержимое.

См. также:: Значения константных полей

HTTP_PARTIAL

public static final int HTTP_PARTIAL

Код состояния HTTP 206: Частичное содержимое.

См. также:: Значения константных полей

HTTP_MULT_CHOICE

public static final int HTTP_MULT_CHOICE

Код состояния HTTP 300: Несколько вариантов.

См. также:: Значения константных полей

HTTP_MOVED_PERM

public static final int HTTP_MOVED_PERM

Код состояния HTTP 301: Постоянное перемещение.

См. также:: Значения константных полей

HTTP_MOVED_TEMP

public static final int HTTP_MOVED_TEMP

Код состояния HTTP 302: Временное перенаправление.

См. также:: Значения константных полей

HTTP_SEE_OTHER

public static final int HTTP_SEE_OTHER

Код состояния HTTP 303: Смотрите другое.

См. также:: Значения константных полей

HTTP_NOT_MODIFIED

public static final int HTTP_NOT_MODIFIED

Код состояния HTTP 304: Не изменено.

См. также:: Значения константных полей

HTTP_USE_PROXY

public static final int HTTP_USE_PROXY

Код состояния HTTP 305: Использовать прокси.

См. также:: Значения константных полей

HTTP_BAD_REQUEST

public static final int HTTP_BAD_REQUEST

Код состояния HTTP 400: Неправильный запрос.

См. также:: Значения константных полей

HTTP_UNAUTHORIZED

public static final int HTTP_UNAUTHORIZED

Код состояния HTTP 401: Не авторизован.

См. также:: Значения константных полей

HTTP_PAYMENT_REQUIRED

public static final int HTTP_PAYMENT_REQUIRED

Код состояния HTTP 402: Оплата требуется.

См. также:: Значения константных полей

HTTP_FORBIDDEN

public static final int HTTP_FORBIDDEN

Код состояния HTTP 403: Запрещено.

См. также:: Значения константных полей

HTTP_NOT_FOUND

public static final int HTTP_NOT_FOUND

Код состояния HTTP 404: Не найдено.

См. также:: Значения константных полей

HTTP_BAD_METHOD

public static final int HTTP_BAD_METHOD

Код состояния HTTP 405: Недопустимый метод.

См. также:: Значения константных полей

HTTP_NOT_ACCEPTABLE

public static final int HTTP_NOT_ACCEPTABLE

Код состояния HTTP 406: Неприемлемо.

См. также:: Значения константных полей

HTTP_PROXY_AUTH

public static final int HTTP_PROXY_AUTH

Код состояния HTTP 407: Требуется аутентификация прокси-сервера.

См. также:: Значения константных полей

HTTP_CLIENT_TIMEOUT

public static final int HTTP_CLIENT_TIMEOUT

Код состояния HTTP 408: Истечение времени ожидания запроса.

См. также:: Значения константных полей

HTTP_CONFLICT

public static final int HTTP_CONFLICT

Код состояния HTTP 409: Конфликт.

См. также:: Значения константных полей

HTTP_GONE

public static final int HTTP_GONE

Код состояния HTTP 410: Отсутствует.

См. также:: Значения константных полей

HTTP_LENGTH_REQUIRED

public static final int HTTP_LENGTH_REQUIRED

Код состояния HTTP 411: Требуется длина.

См. также:: Значения константных полей

HTTP_PRECON_FAILED

public static final int HTTP_PRECON_FAILED

Код состояния HTTP 412: Предварительное условие не выполнено.

См. также:: Значения константных полей

HTTP_ENTITY_TOO_LARGE

public static final int HTTP_ENTITY_TOO_LARGE

Код состояния HTTP 413: Размер сущности запроса слишком велик.

См. также:: Значения константных полей

HTTP_REQ_TOO_LONG

public static final int HTTP_REQ_TOO_LONG

Код состояния HTTP 414: URI запроса слишком длинный.

См. также:: Значения константных полей

HTTP_UNSUPPORTED_TYPE

public static final int HTTP_UNSUPPORTED_TYPE

Код состояния HTTP 415: Неподдерживаемый тип среды.

См. также:: Значения константных полей

HTTP_SERVER_ERROR

@Deprecated
public static final int HTTP_SERVER_ERROR

Устарело. Неправильно расположено и не должно было существовать.

Код состояния HTTP 500: Внутренняя ошибка сервера.

См. также:: Значения константных полей

HTTP_INTERNAL_ERROR

public static final int HTTP_INTERNAL_ERROR

Код состояния HTTP 500: Внутренняя ошибка сервера.

См. также:: Значения константных полей

HTTP_NOT_IMPLEMENTED

public static final int HTTP_NOT_IMPLEMENTED

Код состояния HTTP 501: Не реализовано.

См. также:: Значения константных полей

HTTP_BAD_GATEWAY

public static final int HTTP_BAD_GATEWAY

Код состояния HTTP 502: Плохой шлюз.

См. также:: Значения константных полей

HTTP_UNAVAILABLE

public static final int HTTP_UNAVAILABLE

Код состояния HTTP 503: Сервис недоступен.

См. также:: Значения константных полей

HTTP_GATEWAY_TIMEOUT

public static final int HTTP_GATEWAY_TIMEOUT

Код состояния HTTP 504: Истекло время ожидания шлюза.

См. также:: Значения константных полей

HTTP_VERSION

public static final int HTTP_VERSION

Код состояния HTTP 505: Не поддерживается версия HTTP.

См. также:: Значения константных полей

Конструкторы

HttpURLConnection

protected HttpURLConnection(URL u)

Конструктор для HttpURLConnection.

Параметры:: u - URL

Методы

getHeaderFieldKey

public String getHeaderFieldKey(int n)

Возвращает ключ для n-го поля заголовка. Некоторые реализации могут рассматривать 0-е поле заголовка как специальное, т.е. как строку состояния, возвращенную HTTP-сервером. В этом случае, getHeaderField(0) возвращает строку состояния, а getHeaderFieldKey(0) возвращает null.

Переопределяет:: getHeaderFieldKey в классе URLConnection
Параметры:: n - индекс, где n >=0.
Возвращает:: ключ для n-го поля заголовка или null если ключ не существует.

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(int contentLength)

Этот метод используется для включения потоковой передачи тела HTTP-запроса без внутренней буферизации, когда длина содержимого известна заранее.

Будет выброшено исключение, если приложение попытается записать больше данных, чем указанная длина содержимого, или если приложение закроет OutputStream до записи указанного количества.

При включенной потоковой передаче данных аутентификация и перенаправление не обрабатываются автоматически. HttpRetryException будет выброшен при чтении ответа, если требуется аутентификация или перенаправление. Это исключение можно запросить для получения подробностей об ошибке.

Этот метод должен быть вызван до подключения URLConnection.

ПРИМЕЧАНИЕ: Рекомендуется использовать setFixedLengthStreamingMode(long) вместо этого метода, так как он позволяет устанавливать более большие значения длины содержимого.

Параметры:: contentLength - количество байтов, которые будут записаны в OutputStream.
Исключения:: IllegalStateException - если URLConnection уже подключен или если включен другой режим потоковой передачи.; IllegalArgumentException - если указана длина содержимого меньше нуля.
С тех пор:: 1.5
См. также:: setChunkedStreamingMode(int)

setFixedLengthStreamingMode

public void setFixedLengthStreamingMode(long contentLength)

При включенной потоковой передаче данных аутентификация и перенаправление не обрабатываются автоматически. Исключение HttpRetryException будет выброшено при чтении ответа, если требуется аутентификация или перенаправление. Это исключение можно запросить для получения подробностей об ошибке.

Этот метод должен быть вызван до подключения URLConnection.

Длина содержимого, установленная при вызове этого метода, имеет приоритет над любым значением, установленным setFixedLengthStreamingMode(int).

Параметры:: contentLength - количество байтов, которые будут записаны в OutputStream.
Исключения:: IllegalStateException - если URLConnection уже подключен или если включен другой режим потоковой передачи.; IllegalArgumentException - если указана длина содержимого меньше нуля.
С тех пор:: 1.7

setChunkedStreamingMode

public void setChunkedStreamingMode(int chunklen)

Этот метод используется для включения потоковой передачи тела HTTP-запроса без внутренней буферизации, когда длина содержимого не известна заранее. В этом режиме используется кодировка chunked для отправки тела запроса. Обратите внимание, что не все HTTP-серверы поддерживают этот режим.

Этот метод должен быть вызван до подключения URLConnection.

Параметры:: chunklen - количество байтов для записи в каждом блоке. Если chunklen меньше или равно нулю, будет использовано значение по умолчанию.
Исключения:: IllegalStateException - если URLConnection уже подключен или если включен другой режим потоковой передачи.
С тех пор:: 1.5
См. также:: setFixedLengthStreamingMode(int)

getHeaderField

public String getHeaderField(int n)

Возвращает значение для n-го поля заголовка. Некоторые реализации могут рассматривать 0-е поле заголовка как специальное, т.е. как строку состояния, возвращенную HTTP-сервером.

Этот метод может использоваться совместно с методом getHeaderFieldKey для перебора всех заголовков в сообщении.

Переопределяет:: getHeaderField в классе URLConnection
Параметры:: n - индекс, где n>=0.
Возвращает:: значение n-го поля заголовка, или null если значение не существует.
См. также:: getHeaderFieldKey(int)

setFollowRedirects

public static void setFollowRedirects(boolean set)

Устанавливает, должны ли автоматически следовать HTTP-перенаправлениям (запросам с кодом ответа 3xx) в этом классе. По умолчанию значение равно true. Апплеты не могут изменить это значение.

Если существует диспетчер безопасности, этот метод сначала вызывает метод checkSetFactory диспетчера безопасности, чтобы убедиться, что операция разрешена. Это может привести к SecurityException.

Параметры:: set - логическое значение, указывающее, следует ли следовать HTTP-перенаправлениям.
Исключения:: SecurityException - если существует диспетчер безопасности и его метод checkSetFactory не разрешает операцию.
См. также:: SecurityManager.checkSetFactory(), getFollowRedirects()

getFollowRedirects

public static boolean getFollowRedirects()

Возвращает логическое значение, указывающее, следует ли автоматически следовать HTTP-перенаправлениям (3xx).

Возвращает:: true если следует автоматически следовать HTTP-перенаправлениям, false если нет.
См. также:: setFollowRedirects(boolean)

setInstanceFollowRedirects

public void setInstanceFollowRedirects(boolean followRedirects)

Устанавливает, следует ли автоматически следовать HTTP-перенаправлениям (запросам с кодом ответа 3xx) для этого экземпляра HttpURLConnection.

Значение по умолчанию берётся из followRedirects, которое по умолчанию равно true.

Параметры:: followRedirects - логическое значение, указывающее, следует ли следовать HTTP-перенаправлениям.
С тех пор:: 1.3
См. также:: instanceFollowRedirects, getInstanceFollowRedirects()

getInstanceFollowRedirects

public boolean getInstanceFollowRedirects()

Возвращает значение поля instanceFollowRedirects этого HttpURLConnection.

Возвращает:: значение поля instanceFollowRedirects этого HttpURLConnection.
С тех пор:: 1.3
См. также:: instanceFollowRedirects, setInstanceFollowRedirects(boolean)

setRequestMethod

public void setRequestMethod(String method)
                      throws ProtocolException

Устанавливает метод для запроса URL, один из:

GET
POST
HEAD
OPTIONS
PUT
DELETE
TRACE

допустимы, в зависимости от ограничений протокола. Метод по умолчанию - GET.

Параметры:: method - HTTP-метод
Исключения:: ProtocolException - если метод не может быть изменен или если запрашиваемый метод не является допустимым для HTTP.; SecurityException - если установлен диспетчер безопасности и метод равен "TRACE", но NetPermission "allowHttpTrace" не предоставлен.
См. также:: getRequestMethod()

getRequestMethod

public String getRequestMethod()

Получить метод запроса.

Возвращает:: метод HTTP-запроса
См. также:: setRequestMethod(java.lang.String)

getResponseCode

public int getResponseCode()
                    throws IOException

Получает код состояния из сообщения ответа HTTP. Например, в случае следующих строк состояния:

HTTP/1.0 200 OK
 HTTP/1.0 401 Unauthorized

Он вернет 200 и 401 соответственно. Возвращает -1, если код не может быть получен из ответа (т.е. ответ не является корректным HTTP).

Возвращает:: код состояния HTTP или -1
Исключения:: IOException - если произошла ошибка при подключении к серверу.

getResponseMessage

public String getResponseMessage()
                          throws IOException

Получает сообщение HTTP-ответа, если оно есть, возвращаемое сервером вместе с кодом ответа. Из ответов, таких как:

HTTP/1.0 200 OK
 HTTP/1.0 404 Not Found

извлекаются строки "OK" и "Not Found" соответственно. Возвращает null, если из ответов ничего нельзя было определить (результат не является корректным HTTP).

Возвращает:: сообщение HTTP-ответа или null
Исключения:: IOException - если произошла ошибка при подключении к серверу.

getHeaderFieldDate

public long getHeaderFieldDate(String name,
                               long Default)

Описание скопировано из класса: URLConnection

Возвращает значение указанного поля, интерпретированное как дата. Результатом является количество миллисекунд, прошедших с 1 января 1970 года по Гринвичу, представленное указанным полем.

Эта форма getHeaderField существует, потому что некоторые типы соединений (например, http-ng) имеют предварительно проанализированные заголовки. Классы для такого типа соединений могут переопределять этот метод и прерывать разбор.

Переопределяет:: getHeaderFieldDate в классе URLConnection
Параметры:: name - имя поля заголовка.; Default - значение по умолчанию.
Возвращает:: значение поля, интерпретированное как дата. Возвращается значение аргумента Default , если поле отсутствует или имеет неправильный формат.

disconnect

public abstract void disconnect()

Указывает, что другие запросы к серверу в ближайшем будущем маловероятны. Вызов disconnect() не означает, что этот экземпляр HttpURLConnection можно повторно использовать для других запросов.

usingProxy

public abstract boolean usingProxy()

Указывает, использует ли соединение прокси-сервер.

Возвращает:: булевое значение, указывающее, использует ли соединение прокси-сервер.

getPermission

public Permission getPermission()
                         throws IOException

Возвращает объект SocketPermission, представляющий разрешение, необходимое для подключения к целевому хосту и порту.

Переопределяет:: getPermission в классе URLConnection
Возвращает:: объект SocketPermission , представляющий разрешение, необходимое для подключения к целевому хосту и порту.
Исключения:: IOException - если при вычислении разрешения произошла ошибка.

getErrorStream

public InputStream getErrorStream()

Возвращает поток ошибок, если подключение завершилось ошибкой, но сервер тем не менее отправил полезные данные. Типичный пример — когда HTTP-сервер отвечает кодом 404, что приведет к исключению FileNotFoundException при подключении, но сервер отправит страницу справки с рекомендациями.

Этот метод не вызовет инициализации подключения. Если соединение не было подключено, или если сервер не имел ошибок при подключении, или если у сервера была ошибка, но данные об ошибке не были отправлены, этот метод вернет null. Это значение по умолчанию.

Возвращает:: поток ошибок, если таковой имеется, null, если ошибок нет, соединение не подключено или сервер не отправил полезных данных.

© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.