Spec-Zone .ru
спецификации, руководства, описания, API
|
public abstract class HttpURLConnection extends URLConnection
Каждый экземпляр HttpURLConnection используется, чтобы обратиться с единственной просьбой, но базовое сетевое соединение с сервером HTTP может быть прозрачно совместно использовано другими экземплярами. Вызывая завершение () методы на InputStream или OutputStream HttpURLConnection после запроса могут освободить сетевые ресурсы, связанные с этим экземпляром, но не имеют никакого эффекта на любое совместно используемое персистентное соединение. Вызывая разъединение () метод может закрыть базовый сокет, если персистентное соединение иначе неактивно тогда.
У обработчика протокола HTTP есть несколько настроек, к которым можно получить доступ через Системные Свойства. Это покрывает настройки Proxy так же как различные другие настройки.
Права доступа
Если менеджер безопасности устанавливается, и если метод вызывают, который приводит к попытке открыть соединение, вызывающая сторона должна обладать either:-
SocketPermission
к комбинации узла/порта места назначения URL илиHttpURLPermission
это разрешает этот запрос.Если автоматическое перенаправление включается, и этот запрос перенаправляется другому месту назначения, то у вызывающей стороны должно также быть разрешение, чтобы соединиться с перенаправленным узлом/URL.
disconnect()
Модификатор и Тип | Поле и Описание |
---|---|
protected int |
chunkLength
Длиной до блока при использовании разделенного на блоки потокового режима кодирования для вывода.
|
protected int |
fixedContentLength
Фиксированное длиной до контента при использовании потокового режима фиксированной длины.
|
protected long |
fixedContentLengthLong
Фиксированное длиной до контента при использовании потокового режима фиксированной длины.
|
static int |
HTTP_ACCEPTED
Код состояния 202 HTTP: Принятый.
|
static int |
HTTP_BAD_GATEWAY
Код состояния 502 HTTP: Недопустимый шлюз.
|
static int |
HTTP_BAD_METHOD
Код состояния 405 HTTP: Метод, Не Позволенный.
|
static int |
HTTP_BAD_REQUEST
Код состояния 400 HTTP: Плохой Запрос.
|
static int |
HTTP_CLIENT_TIMEOUT
Код состояния 408 HTTP: Тайм-аут Запроса.
|
static int |
HTTP_CONFLICT
Код состояния 409 HTTP: Конфликт.
|
static int |
HTTP_CREATED
Код состояния 201 HTTP: Создаваемый.
|
static int |
HTTP_ENTITY_TOO_LARGE
Код состояния 413 HTTP: Слишком Большой Объект запроса.
|
static int |
HTTP_FORBIDDEN
Код состояния 403 HTTP: Запрещенный.
|
static int |
HTTP_GATEWAY_TIMEOUT
Код состояния 504 HTTP: Тайм-аут Шлюза.
|
static int |
HTTP_GONE
Код состояния 410 HTTP: Уведенный.
|
static int |
HTTP_INTERNAL_ERROR
Код состояния 500 HTTP: Внутренняя Ошибка Сервера.
|
static int |
HTTP_LENGTH_REQUIRED
Код состояния 411 HTTP: Необходимая Длина.
|
static int |
HTTP_MOVED_PERM
Код состояния 301 HTTP: Перемещенный Постоянно.
|
static int |
HTTP_MOVED_TEMP
Код состояния 302 HTTP: Временное Перенаправление.
|
static int |
HTTP_MULT_CHOICE
Код состояния 300 HTTP: Разнообразный выбор.
|
static int |
HTTP_NO_CONTENT
Код состояния 204 HTTP: Никакой Контент.
|
static int |
HTTP_NOT_ACCEPTABLE
Код состояния 406 HTTP: Не Приемлемый.
|
static int |
HTTP_NOT_AUTHORITATIVE
Код состояния 203 HTTP: недостоверная информация.
|
static int |
HTTP_NOT_FOUND
Код состояния 404 HTTP: Не Найденный.
|
static int |
HTTP_NOT_IMPLEMENTED
Код состояния 501 HTTP: Не Реализованный.
|
static int |
HTTP_NOT_MODIFIED
Код состояния 304 HTTP: Не Измененный.
|
static int |
HTTP_OK
Код состояния 200 HTTP: OK.
|
static int |
HTTP_PARTIAL
Код состояния 206 HTTP: Частичный Контент.
|
static int |
HTTP_PAYMENT_REQUIRED
Код состояния 402 HTTP: Необходимая Оплата.
|
static int |
HTTP_PRECON_FAILED
Код состояния 412 HTTP: Отказавшее Предварительное условие.
|
static int |
HTTP_PROXY_AUTH
Код состояния 407 HTTP: Необходимая Аутентификация Прокси.
|
static int |
HTTP_REQ_TOO_LONG
Код состояния 414 HTTP: Слишком Большой URI запроса.
|
static int |
HTTP_RESET
Код состояния 205 HTTP: Контент Сброса.
|
static int |
HTTP_SEE_OTHER
Код состояния 303 HTTP: См. Другой.
|
static int |
HTTP_SERVER_ERROR
Осуждаемый.
это неуместно и не должно было существовать.
|
static int |
HTTP_UNAUTHORIZED
Код состояния 401 HTTP: Несанкционированный.
|
static int |
HTTP_UNAVAILABLE
Код состояния 503 HTTP: Недоступная Служба.
|
static int |
HTTP_UNSUPPORTED_TYPE
Код состояния 415 HTTP: неподдерживаемый Тип носителей.
|
static int |
HTTP_USE_PROXY
Код состояния 305 HTTP: Используйте Прокси.
|
static int |
HTTP_VERSION
Код состояния 505 HTTP: Версия HTTP, Не Поддерживаемая.
|
protected boolean |
instanceFollowRedirects
Если
true , протокол будет автоматически следовать за перенаправлениями. |
protected String |
метод
Метод HTTP (ДОБИРАЮТСЯ, POST, ПОМЕЩАЛ, и т.д.).
|
protected int |
responseCode
int представление трех цифр Код состояния HTTP. |
protected String |
responseMessage
Сообщение ответа HTTP.
|
allowUserInteraction, connected, doInput, doOutput, ifModifiedSince, url, useCaches
Модификатор | Конструктор и Описание |
---|---|
protected |
HttpURLConnection(URL u)
Конструктор для HttpURLConnection.
|
Модификатор и Тип | Метод и Описание |
---|---|
abstract void |
disconnect()
Указывает, что другие запросы к серверу маловероятны в ближайшем будущем.
|
InputStream |
getErrorStream()
Возвращает поток сообщений об ошибках если отказавшее соединение, но сервер, отправленный полезные данные, тем не менее.
|
static boolean |
getFollowRedirects()
Возвраты a
boolean указание, перенаправляет ли HTTP (3xx), должно автоматически сопровождаться. |
Строка |
getHeaderField(int n)
Возвращает значение для
n поле заголовка th. |
long |
getHeaderFieldDate(String name, long Default)
Возвращает значение именованного поля, проанализированного как дата.
|
Строка |
getHeaderFieldKey(int n)
Возвращает ключ для
n поле заголовка th. |
boolean |
getInstanceFollowRedirects()
Возвращает значение этого
HttpURLConnection 's instanceFollowRedirects поле. |
Разрешение |
getPermission()
Возвраты a
SocketPermission объект, представляющий разрешение, необходимое, чтобы соединиться с конечным хостом и портом. |
Строка |
getRequestMethod()
Получите метод запроса.
|
int |
getResponseCode()
Получает код состояния из сообщения ответа HTTP.
|
Строка |
getResponseMessage()
Получает сообщение ответа HTTP, если таковые вообще имеются, возвращенный наряду с кодом ответа из сервера.
|
void |
setChunkedStreamingMode(int chunklen)
Этот метод используется, чтобы позволить передать потоком тела запроса HTTP без внутренней буферизации, когда длина контента не известна заранее.
|
void |
setFixedLengthStreamingMode(int contentLength)
Этот метод используется, чтобы позволить передать потоком тела запроса HTTP без внутренней буферизации, когда длина контента известна заранее.
|
void |
setFixedLengthStreamingMode(long contentLength)
Этот метод используется, чтобы позволить передать потоком тела запроса HTTP без внутренней буферизации, когда длина контента известна заранее.
|
static void |
setFollowRedirects(boolean set)
Наборы, перенаправляет ли HTTP (запросы с кодом ответа 3xx) должны автоматически сопровождаться этим class.
|
void |
setInstanceFollowRedirects(boolean followRedirects)
Наборы, перенаправляет ли HTTP (запросы с кодом ответа 3xx) должны автоматически сопровождаться этим
HttpURLConnection экземпляр. |
void |
setRequestMethod(String method)
Установите метод для URL-запроса, одного из: ПОМЕСТИТЕ ОПЦИИ ГОЛОВЫ POST, УДАЛЯЮТ ТРАССИРОВКУ, являются законными согласно ограничениям протокола.
|
abstract boolean |
usingProxy()
Указывает, проходит ли соединение через прокси.
|
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
protected String method
protected int chunkLength
-1
разделенное на блоки кодирование средств отключается для вывода.protected int fixedContentLength
-1
потоковый режим фиксированной длины средств отключается для вывода. ОТМЕТЬТЕ: fixedContentLengthLong
рекомендуется вместо этого поля, поскольку оно позволяет большим длинам контента быть установленными.
protected long fixedContentLengthLong
-1
потоковый режим фиксированной длины средств отключается для вывода.protected int responseCode
int
представление трех цифр Код состояния HTTP. protected String responseMessage
protected boolean instanceFollowRedirects
true
, протокол будет автоматически следовать за перенаправлениями. Если false
, протокол не будет автоматически следовать за перенаправлениями. Это поле устанавливается setInstanceFollowRedirects
метод. Его значение возвращается getInstanceFollowRedirects
метод.
Его значение по умолчанию основано на значении статического followRedirects во время создания HttpURLConnection.
public static final int HTTP_OK
public static final int HTTP_CREATED
public static final int HTTP_ACCEPTED
public static final int HTTP_NOT_AUTHORITATIVE
public static final int HTTP_NO_CONTENT
public static final int HTTP_RESET
public static final int HTTP_PARTIAL
public static final int HTTP_MULT_CHOICE
public static final int HTTP_MOVED_PERM
public static final int HTTP_MOVED_TEMP
public static final int HTTP_SEE_OTHER
public static final int HTTP_NOT_MODIFIED
public static final int HTTP_USE_PROXY
public static final int HTTP_BAD_REQUEST
public static final int HTTP_UNAUTHORIZED
public static final int HTTP_PAYMENT_REQUIRED
public static final int HTTP_FORBIDDEN
public static final int HTTP_NOT_FOUND
public static final int HTTP_BAD_METHOD
public static final int HTTP_NOT_ACCEPTABLE
public static final int HTTP_PROXY_AUTH
public static final int HTTP_CLIENT_TIMEOUT
public static final int HTTP_CONFLICT
public static final int HTTP_GONE
public static final int HTTP_LENGTH_REQUIRED
public static final int HTTP_PRECON_FAILED
public static final int HTTP_ENTITY_TOO_LARGE
public static final int HTTP_REQ_TOO_LONG
public static final int HTTP_UNSUPPORTED_TYPE
@Deprecated public static final int HTTP_SERVER_ERROR
public static final int HTTP_INTERNAL_ERROR
public static final int HTTP_NOT_IMPLEMENTED
public static final int HTTP_BAD_GATEWAY
public static final int HTTP_UNAVAILABLE
public static final int HTTP_GATEWAY_TIMEOUT
public static final int HTTP_VERSION
protected HttpURLConnection(URL u)
u
- URLpublic String getHeaderFieldKey(int n)
n
поле заголовка th. Некоторые реализации могут обработать 0
поле заголовка th как особенный, то есть как строка состояния возвратилось сервером HTTP. В этом случае, getHeaderField(0)
возвращает строку состояния, но getHeaderFieldKey(0)
нуль возвратов.getHeaderFieldKey
в class URLConnection
n
- индексирование, где n> =0.n
поле заголовка th, или null
если ключ не существует.public void setFixedLengthStreamingMode(int contentLength)
Исключение будет выдано, если приложение попытается записать больше данных чем обозначенное длиной до контента, или если приложение закрывает OutputStream прежде, чем записать обозначенное количество.
Когда выходной потоковая передача включается, аутентификация и перенаправление не могут быть обработаны автоматически. HttpRetryException будет брошен, читая ответ, если аутентификация или перенаправление будут требоваться. Это исключение может быть запрошено для деталей ошибки.
Этот метод нужно вызвать прежде, чем URLConnection соединяется.
ОТМЕТЬТЕ: setFixedLengthStreamingMode(long)
рекомендуется вместо этого метода, поскольку он позволяет большим длинам контента быть установленными.
contentLength
- Число байтов, которые будут записаны OutputStream.IllegalStateException
- если URLConnection уже соединяется или если различный потоковый режим уже включается.IllegalArgumentException
- если длина контента меньше чем нуль определяется.setChunkedStreamingMode(int)
public void setFixedLengthStreamingMode(long contentLength)
Исключение будет выдано, если приложение попытается записать больше данных чем обозначенное длиной до контента, или если приложение закрывает OutputStream прежде, чем записать обозначенное количество.
Когда выходной потоковая передача включается, аутентификация и перенаправление не могут быть обработаны автоматически. HttpRetryException будет брошен, читая ответ, если аутентификация или перенаправление будут требоваться. Это исключение может быть запрошено для деталей ошибки.
Этот метод нужно вызвать прежде, чем URLConnection соединяется.
Длина контента, установленная, вызывая этот метод, имеет приоритет по любому набору значений setFixedLengthStreamingMode(int)
.
contentLength
- Число байтов, которые будут записаны OutputStream.IllegalStateException
- если URLConnection уже соединяется или если различный потоковый режим уже включается.IllegalArgumentException
- если длина контента меньше чем нуль определяется.public void setChunkedStreamingMode(int chunklen)
Когда выходной потоковая передача включается, аутентификация и перенаправление не могут быть обработаны автоматически. HttpRetryException будет брошен, читая ответ, если аутентификация или перенаправление будут требоваться. Это исключение может быть запрошено для деталей ошибки.
Этот метод нужно вызвать прежде, чем URLConnection соединяется.
chunklen
- Число байтов, чтобы записать в каждом блоке. Если chunklen будет меньше чем или равен нулю, то значение по умолчанию будет использоваться.IllegalStateException
- если URLConnection уже соединяется или если различный потоковый режим уже включается.setFixedLengthStreamingMode(int)
public String getHeaderField(int n)
n
поле заголовка th. Некоторые реализации могут обработать 0
поле заголовка th как особенный, то есть как строка состояния возвратилось сервером HTTP. Этот метод может использоваться в соединении с getHeaderFieldKey
метод, чтобы выполнить итерации посредством всех заголовков в сообщении.
getHeaderField
в class URLConnection
n
- индексирование, где n> =0.n
поле заголовка th, или null
если значение не существует.getHeaderFieldKey(int)
public static void setFollowRedirects(boolean set)
Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkSetFactory
метод, чтобы гарантировать работу позволяется. Это могло привести к SecurityException.
set
- a boolean
указание, следовать ли за перенаправлениями HTTP.SecurityException
- если менеджер безопасности существует и checkSetFactory
метод не позволяет работу.SecurityManager.checkSetFactory()
, getFollowRedirects()
public static boolean getFollowRedirects()
boolean
указание, перенаправляет ли HTTP (3xx), должно автоматически сопровождаться.true
если перенаправления HTTP должны автоматически сопровождаться, false если нет.setFollowRedirects(boolean)
public void setInstanceFollowRedirects(boolean followRedirects)
HttpURLConnection
экземпляр. Значение по умолчанию прибывает из followRedirects, который значения по умолчанию к истине.
followRedirects
- a boolean
указание, следовать ли за перенаправлениями HTTP.instanceFollowRedirects
, getInstanceFollowRedirects()
public boolean getInstanceFollowRedirects()
HttpURLConnection
's instanceFollowRedirects
поле.HttpURLConnection
's instanceFollowRedirects
поле.instanceFollowRedirects
, setInstanceFollowRedirects(boolean)
public void setRequestMethod(String method) throws ProtocolException
method
- метод HTTPProtocolException
- если метод не может быть сброшен или если требуемый метод не допустим для HTTP.SecurityException
- если менеджер безопасности устанавливается, и метод является "ТРАССИРОВКОЙ", но "allowHttpTrace" NetPermission не предоставляют.getRequestMethod()
public String getRequestMethod()
setRequestMethod(java.lang.String)
public int getResponseCode() throws IOException
HTTP/1.0 200 OK HTTP/1.0 401 UnauthorizedЭто возвратится 200 и 401 соответственно. Возвраты-1, если никакой код не может быть различен от ответа (то есть, ответом не является допустимый HTTP).
IOException
- если ошибка произошла, соединяясь с сервером.public String getResponseMessage() throws IOException
HTTP/1.0 200 OK HTTP/1.0 404 Not FoundИзвлекает Строки "OK" и "Не Найденный" соответственно. Нуль возвратов, если ни один не мог бы быть различен от ответов (результатом не был допустимый HTTP).
null
IOException
- если ошибка произошла, соединяясь с сервером.public long getHeaderFieldDate(String name, long Default)
URLConnection
Эта форма getHeaderField
существует потому что некоторые типы подключения (например, http-ng
) предварительно проанализировали заголовки. Классы для того типа подключения могут переопределить этот метод и закоротить парсинг.
getHeaderFieldDate
в class URLConnection
name
- имя поля заголовка.Default
- значение по умолчанию.Default
параметр возвращается, если поле отсутствует или уродливое.public abstract void disconnect()
public abstract boolean usingProxy()
public Permission getPermission() throws IOException
SocketPermission
объект, представляющий разрешение, необходимое, чтобы соединиться с конечным хостом и портом.getPermission
в class URLConnection
SocketPermission
объект, представляющий разрешение, необходимое, чтобы соединиться с конечным хостом и портом.IOException
- если ошибка происходит, вычисляя разрешение.public InputStream getErrorStream()
Этот метод не будет заставлять соединение инициироваться. Если соединение не было соединено, или если у сервера не было ошибки, соединяясь или если у сервера была ошибка, но никакие ошибочные данные не были отправлены, этот метод возвратит нуль. Это - значение по умолчанию.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92