java.net

Класс URLConnection

java.lang. Объект

java.net. URLConnection

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

HttpURLConnection, JarURLConnection

public abstract class URLConnection
extends Object

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

openConnection()	connect()
Управляйте параметрами, которые влияют на соединение с удаленным ресурсом.	Взаимодействуйте с ресурсом; поля заголовка запроса и содержание.

---------------------------->
время

1. Объект соединения создается, вызывая openConnection метод на URL.
2. Параметрами установки и общими свойствами запроса управляют.
3. Фактическое соединение с удаленным объектом делается, используя connect метод.
4. Удаленный объект становится доступным. К полям заголовка и содержанию удаленного объекта можно получить доступ.

Параметры установки изменяются, используя следующие методы:

• setAllowUserInteraction
• setDoInput
• setDoOutput
• setIfModifiedSince
• setUseCaches

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

• setRequestProperty

Значения по умолчанию для AllowUserInteraction и UseCaches параметры могут быть установлены, используя методы setDefaultAllowUserInteraction и setDefaultUseCaches.

Каждый из вышеупомянутых set у методов есть соответствие get метод, чтобы получить значение параметра или общего свойства запроса. Определенные параметры и общие свойства запроса, которые применимы, являются определенным протоколом.

Следующие методы используются, чтобы получить доступ к полям заголовка и содержанию после того, как соединение делается к удаленному объекту:

• getContent
• getHeaderField
• getInputStream
• getOutputStream

К определенным полям заголовка часто получают доступ. Методы:

• getContentEncoding
• getContentLength
• getContentType
• getDate
• getExpiration
• getLastModifed

обеспечьте удобный доступ к этим полям. getContentType метод используется getContent метод, чтобы определить тип удаленного объекта; подклассы могут счесть удобным переопределить getContentType метод.

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

Больше информации о свойствах запроса и полях заголовка http соединение может быть найдено в:

 http://www.ietf.org/rfc/rfc2616.txt
 

Отметьте о fileNameMap: В версиях до JDK 1.1.6, поля fileNameMap из URLConnection было общедоступно. В JDK 1.1.6 и позже, fileNameMap является частным; средство доступа и мутаторные методы getFileNameMap и setFileNameMap добавляются, чтобы получить доступ к этому. Это изменение также описывается на странице Совместимости. Вызывая методы close() на InputStream или OutputStream URLConnection после того, как запрос может освободить сетевые ресурсы, связанные с этим экземпляром, если определенные спецификации протокола не определяют различные поведения для этого.

С тех пор:

JDK1.0

См. Также:

URL.openConnection(), connect(), getContent(), getContentEncoding(), getContentLength(), getContentType(), getDate(), getExpiration(), getHeaderField(int), getHeaderField(java.lang.String), getInputStream(), getLastModified(), getOutputStream(), setAllowUserInteraction(boolean), setDefaultUseCaches(boolean), setDoInput(boolean), setDoOutput(boolean), setIfModifiedSince(long), setRequestProperty(java.lang.String, java.lang.String), setUseCaches(boolean)

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected boolean	allowUserInteraction Если true, это URL исследуется в контексте, в котором имеет смысл позволять взаимодействие с пользователем, такое как появление диалогового окна аутентификации.
protected boolean	соединенный Если false, этот объект соединения не создал линию связи к указанному URL.
protected boolean	doInput Эта переменная устанавливается setDoInput метод.
protected boolean	doOutput Эта переменная устанавливается setDoOutput метод.
protected long	ifModifiedSince Некоторая поддержка протоколов, пропускающая выборку объекта, если объект не был изменен позже чем определенное время.
protected URL	url URL представляет удаленный объект во всемирной паутине, которой открывается это соединение.
protected boolean	useCaches Если true, протоколу позволяют использовать кэширование всякий раз, когда это может.

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	URLConnection(URL url) Создает соединение URL с указанным URL.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addRequestProperty(String key, String value) Добавляет общее свойство запроса, определенное парой ключ/значение.
abstract void	connect() Открывает линию связи для ресурса, на который ссылается этот URL, если такое соединение не было уже установлено.
boolean	getAllowUserInteraction() Возвращает значение allowUserInteraction поле для этого объекта.
int	getConnectTimeout() Установка возвратов для тайм-аута подключения.
Объект	getContent() Получает содержание этого соединения URL.
Объект	getContent(Class[] classes) Получает содержание этого соединения URL.
Строка	getContentEncoding() Возвращает значение content-encoding поле заголовка.
int	getContentLength() Возвращает значение content-length поле заголовка.
long	getContentLengthLong() Возвращает значение content-length поле заголовка как длинное.
Строка	getContentType() Возвращает значение content-type поле заголовка.
long	getDate() Возвращает значение date поле заголовка.
static boolean	getDefaultAllowUserInteraction() Возвращает значение по умолчанию allowUserInteraction поле.
static String	getDefaultRequestProperty(String key) Осуждаемый. Экземпляр определенный getRequestProperty метод должен использоваться после соответствующего экземпляра URLConnection, получается.
boolean	getDefaultUseCaches() Возвращает значение по умолчанию a URLConnection's useCaches флаг.
boolean	getDoInput() Возвращает значение этого URLConnection's doInput флаг.
boolean	getDoOutput() Возвращает значение этого URLConnection's doOutput флаг.
long	getExpiration() Возвращает значение expires поле заголовка.
static FileNameMap	getFileNameMap() Карта имени файла загрузок (mimetable) от файла данных.
Строка	getHeaderField(int n) Возвращает значение для nполе заголовка th.
Строка	getHeaderField(String name) Возвращает значение именованного поля заголовка.
long	getHeaderFieldDate(String name, long Default) Возвращает значение именованного поля, проанализированного как дата.
int	getHeaderFieldInt(String name, int Default) Возвращает значение именованного поля, проанализированного как число.
Строка	getHeaderFieldKey(int n) Возвращает ключ для nполе заголовка th.
long	getHeaderFieldLong(String name, long Default) Возвращает значение именованного поля, проанализированного как число.
Map<String,List<String>>	getHeaderFields() Возвращает неподдающуюся изменению Карту полей заголовка.
long	getIfModifiedSince() Возвращает значение этого объекта ifModifiedSince поле.
InputStream	getInputStream() Возвращает входной поток, который читает из этого открытого соединения.
long	getLastModified() Возвращает значение last-modified поле заголовка.
OutputStream	getOutputStream() Возвращает поток вывода, который пишет в это соединение.
Разрешение	getPermission() Возвращает объект полномочий, представляющий разрешение, необходимое, чтобы сделать соединение представленным этим объектом.
int	getReadTimeout() Установка возвратов для тайм-аута чтения.
Map<String,List<String>>	getRequestProperties() Возвращает неподдающуюся изменению Карту общих свойств запроса для этого соединения.
Строка	getRequestProperty(String key) Возвращает значение именованного общего свойства запроса для этого соединения.
URL	getURL() Возвращает значение этого URLConnection's URL поле.
boolean	getUseCaches() Возвращает значение этого URLConnection's useCaches поле.
static String	guessContentTypeFromName(String fname) Попытки определить тип контента объекта, основанного на указанном компоненте "файла" URL.
static String	guessContentTypeFromStream(InputStream is) Попытки определить тип входного потока, основанного на символах в начале входного потока.
void	setAllowUserInteraction(boolean allowuserinteraction) Установите значение allowUserInteraction поле этого URLConnection.
void	setConnectTimeout(int timeout) Устанавливает указанное значение тайм-аута, в миллисекундах, чтобы использоваться, открывая линию связи для ресурса, на который ссылается этот URLConnection.
static void	setContentHandlerFactory(ContentHandlerFactory fac) Наборы ContentHandlerFactory из приложения.
static void	setDefaultAllowUserInteraction(boolean defaultallowuserinteraction) Устанавливает значение по умолчанию allowUserInteraction поле для всего будущего URLConnection объекты к указанному значению.
static void	setDefaultRequestProperty(String key, String value) Осуждаемый. Экземпляр определенный setRequestProperty метод должен использоваться после соответствующего экземпляра URLConnection, получается. Вызов этого метода не будет иметь никакого эффекта.
void	setDefaultUseCaches(boolean defaultusecaches) Устанавливает значение по умолчанию useCaches поле к указанному значению.
void	setDoInput(boolean doinput) Устанавливает значение doInput поле для этого URLConnection к указанному значению.
void	setDoOutput(boolean dooutput) Устанавливает значение doOutput поле для этого URLConnection к указанному значению.
static void	setFileNameMap(FileNameMap map) Устанавливает FileNameMap.
void	setIfModifiedSince(long ifmodifiedsince) Устанавливает значение ifModifiedSince поле этого URLConnection к указанному значению.
void	setReadTimeout(int timeout) Устанавливает тайм-аут чтения в указанный тайм-аут, в миллисекундах.
void	setRequestProperty(String key, String value) Устанавливает общее свойство запроса.
void	setUseCaches(boolean usecaches) Устанавливает значение useCaches поле этого URLConnection к указанному значению.
Строка	toString() Возвраты a String представление этого соединения URL.

Методы java.lang унаследованный от класса. Объект

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

Полевая Деталь

url

protected URL url

URL представляет удаленный объект во всемирной паутине, которой открывается это соединение.

К значению этого поля можно получить доступ getURL метод.

Значение по умолчанию этой переменной является значением параметра URL в URLConnection конструктор.

См. Также:

getURL(), url

doInput

protected boolean doInput

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

Соединение URL может использоваться для ввода и/или выведено. Установка doInput флаг к true указывает, что приложение намеревается считать данные из соединения URL.

Значение по умолчанию этого поля true.

См. Также:

getDoInput(), setDoInput(boolean)

doOutput

protected boolean doOutput

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

Соединение URL может использоваться для ввода и/или выведено. Установка doOutput флаг к true указывает, что приложение намеревается записать данные в соединение URL.

Значение по умолчанию этого поля false.

См. Также:

getDoOutput(), setDoOutput(boolean)

allowUserInteraction

protected boolean allowUserInteraction

Если true, это URL исследуется в контексте, в котором имеет смысл позволять взаимодействие с пользователем, такое как появление диалогового окна аутентификации. Если false, тогда никакое взаимодействие с пользователем не позволяется.

Значение этого поля может быть установлено setAllowUserInteraction метод. Его значение возвращается getAllowUserInteraction метод. Его значение по умолчанию является значением параметра в последнем вызове setDefaultAllowUserInteraction метод.

См. Также:

getAllowUserInteraction(), setAllowUserInteraction(boolean), setDefaultAllowUserInteraction(boolean)

useCaches

protected boolean useCaches

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

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

Его значение по умолчанию является значением, данным в последнем вызове setDefaultUseCaches метод.

См. Также:

setUseCaches(boolean), getUseCaches(), setDefaultUseCaches(boolean)

ifModifiedSince

protected long ifModifiedSince

Некоторая поддержка протоколов, пропускающая выборку объекта, если объект не был изменен позже чем определенное время.

Ненулевое значение дает время как число миллисекунд с 1 января 1970, GMT. Объект выбирается, только если он был изменен позже чем то время.

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

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

См. Также:

getIfModifiedSince(), setIfModifiedSince(long)

соединенный

protected boolean connected

Если false, этот объект соединения не создал линию связи к указанному URL. Если true, линия связи была установлена.

Деталь конструктора

URLConnection

protected URLConnection(URL url)

Создает соединение URL с указанным URL. Соединение с объектом, на который ссылается URL, не создается.

Параметры:

url - указанный URL.

Деталь метода

getFileNameMap

public static FileNameMap getFileNameMap()

Карта имени файла загрузок (mimetable) от файла данных. Это сначала попытается загрузить специфичную для пользователя таблицу, определенную "content.types.user.table" свойством. Если это перестало работать, это пытается загрузить встроенную таблицу по умолчанию в lib/content-types.properties под java домой.

Возвраты:

FileNameMap

С тех пор:

1.2

См. Также:

setFileNameMap(java.net.FileNameMap)

setFileNameMap

public static void setFileNameMap(FileNameMap map)

Устанавливает FileNameMap.

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

Параметры:

map - FileNameMap, который будет установлен

Броски:

SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет работу.

С тех пор:

1.2

См. Также:

SecurityManager.checkSetFactory(), getFileNameMap()

подключение

public abstract void connect()
                      throws IOException

Открывает линию связи для ресурса, на который ссылается этот URL, если такое соединение не было уже установлено.

Если connect метод вызывают, когда соединение было уже открыто (обозначенный connected поле, имеющее значение true), вызов игнорируется.

Объекты URLConnection проходят через две фазы: сначала они создаются, тогда они соединяются. Будучи созданным, и прежде, чем быть соединенным, различные варианты могут быть определены (например, doInput и UseCaches). После соединения это - ошибка попытаться установить их. Операции, которые зависят от того, чтобы быть соединенным, как getContentLength, неявно выполнят соединение в случае необходимости.

Броски:

SocketTimeoutException - если тайм-аут истекает прежде, чем соединение может быть установлено

IOException - если ошибка ввода-вывода происходит, открывая соединение.

См. Также:

connected, getConnectTimeout(), setConnectTimeout(int)

setConnectTimeout

public void setConnectTimeout(int timeout)

Устанавливает указанное значение тайм-аута, в миллисекундах, чтобы использоваться, открывая линию связи для ресурса, на который ссылается этот URLConnection. Если тайм-аут истекает прежде, чем соединение может быть установлено, java.net. SocketTimeoutException повышается. Тайм-аут нуля интерпретируется как бесконечный тайм-аут.

Некоторый нестандартный implmentation этого метода может проигнорировать указанный тайм-аут. Чтобы видеть набор тайм-аута подключения, пожалуйста, вызовите getConnectTimeout ().

Параметры:

timeout - int это определяет значение тайм-аута подключения в миллисекундах

Броски:

IllegalArgumentException - если параметр тайм-аута отрицателен

С тех пор:

1.5

См. Также:

getConnectTimeout(), connect()

getConnectTimeout

public int getConnectTimeout()

Установка возвратов для тайм-аута подключения.

0 возвратов подразумевают, что опция отключается (то есть, тайм-аут бесконечности).

Возвраты:

int это указывает на значение тайм-аута подключения в миллисекундах

С тех пор:

1.5

См. Также:

setConnectTimeout(int), connect()

setReadTimeout

public void setReadTimeout(int timeout)

Устанавливает тайм-аут чтения в указанный тайм-аут, в миллисекундах. Ненулевое значение определяет тайм-аут, читая из Входного потока, когда соединение устанавливается к ресурсу. Если тайм-аут истекает прежде, чем будут доступные данные для чтения, java.net. SocketTimeoutException повышается. Тайм-аут нуля интерпретируется как бесконечный тайм-аут.

Некоторая нестандартная реализация этого метода игнорирует указанный тайм-аут. Чтобы видеть набор тайм-аута чтения, пожалуйста, вызовите getReadTimeout ().

Параметры:

timeout - int это определяет значение тайм-аута, которое будет использоваться в миллисекундах

Броски:

IllegalArgumentException - если параметр тайм-аута отрицателен

С тех пор:

1.5

См. Также:

getReadTimeout(), InputStream.read()

getReadTimeout

public int getReadTimeout()

Установка возвратов для тайм-аута чтения. 0 возвратов подразумевают, что опция отключается (то есть, тайм-аут бесконечности).

Возвраты:

int это указывает на значение тайм-аута чтения в миллисекундах

С тех пор:

1.5

См. Также:

setReadTimeout(int), InputStream.read()

getURL

public URL getURL()

Возвращает значение этого URLConnection's URL поле.

Возвраты:

значение этого URLConnection's URL поле.

См. Также:

url

getContentLength

public int getContentLength()

Возвращает значение content-length поле заголовка.

Отметьте: getContentLengthLong() должен быть предпочтен по этому методу, так как он возвращает a long вместо этого и поэтому более переносимо.

Возвраты:

длина контента ресурса, что ссылки URL этого соединения, -1 если длина контента не известна, или если длина контента больше чем Целое число. MAX_VALUE.

getContentLengthLong

public long getContentLengthLong()

Возвращает значение content-length поле заголовка как длинное.

Возвраты:

длина контента ресурса, что ссылки URL этого соединения, или -1 если длина контента не известна.

С тех пор:

7.0

getContentType

public String getContentType()

Возвращает значение content-type поле заголовка.

Возвраты:

тип контента ресурса, что ссылки URL, или null если не известный.

См. Также:

getHeaderField(java.lang.String)

getContentEncoding

public String getContentEncoding()

Возвращает значение content-encoding поле заголовка.

Возвраты:

кодирование контента ресурса, что ссылки URL, или null если не известный.

См. Также:

getHeaderField(java.lang.String)

getExpiration

public long getExpiration()

Возвращает значение expires поле заголовка.

Возвраты:

дата истечения срока ресурса, что этот URL ссылки, или 0, если не известный. Значение является числом миллисекунд с 1 января 1970 GMT.

См. Также:

getHeaderField(java.lang.String)

getDate

public long getDate()

Возвращает значение date поле заголовка.

Возвраты:

передающая дата ресурса, что ссылки URL, или 0 если не известный. Возвращенное значение является числом миллисекунд с 1 января 1970 GMT.

См. Также:

getHeaderField(java.lang.String)

getLastModified

public long getLastModified()

Возвращает значение last-modified поле заголовка. Результатом является число миллисекунд с 1 января 1970 GMT.

Возвраты:

на дату ресурс ссылается это URLConnection был последнее измененный, или 0 если не известный.

См. Также:

getHeaderField(java.lang.String)

getHeaderField

public String getHeaderField(String name)

Возвращает значение именованного поля заголовка.

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

Параметры:

name - имя поля заголовка.

Возвраты:

значение именованного поля заголовка, или null если нет такого поля в заголовке.

getHeaderFields

public Map<String,List<String>> getHeaderFields()

Возвращает неподдающуюся изменению Карту полей заголовка. Ключи Map являются Строками, которые представляют имена полей заголовка ответа. Каждым значением Карты является неподдающийся изменению Список Строк, который представляет соответствующие значения полей.

Возвраты:

Карта полей заголовка

С тех пор:

1.4

getHeaderFieldInt

public int getHeaderFieldInt(String name,
                    int Default)

Возвращает значение именованного поля, проанализированного как число.

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

Параметры:

name - имя поля заголовка.

Default - значение по умолчанию.

Возвраты:

значение именованного поля, проанализированного как целое число. Default значение возвращается, если поле отсутствует или уродливое.

getHeaderFieldLong

public long getHeaderFieldLong(String name,
                      long Default)

Возвращает значение именованного поля, проанализированного как число.

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

Параметры:

name - имя поля заголовка.

Default - значение по умолчанию.

Возвраты:

значение именованного поля, проанализированного как длинное. Default значение возвращается, если поле отсутствует или уродливое.

С тех пор:

7.0

getHeaderFieldDate

public long getHeaderFieldDate(String name,
                      long Default)

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

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

Параметры:

name - имя поля заголовка.

Default - значение по умолчанию.

Возвраты:

значение поля, проанализированного как дата. Значение Default параметр возвращается, если поле отсутствует или уродливое.

getHeaderFieldKey

public String getHeaderFieldKey(int n)

Возвращает ключ для nполе заголовка ^th. Это возвращается null если есть меньше чем n+1 поля.

Параметры:

n - индекс, где n> =0

Возвраты:

ключ для nполе заголовка ^th, или null если есть меньше чем n+1 поля.

getHeaderField

public String getHeaderField(int n)

Возвращает значение для nполе заголовка ^th. Это возвращается null если есть меньше чем n+1поля.

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

Параметры:

n - индекс, где n> =0

Возвраты:

значение nполе заголовка ^th или null если есть меньше чем n+1 поля

См. Также:

getHeaderFieldKey(int)

getContent

public Object getContent()
                  throws IOException

Получает содержание этого соединения URL.

Этот метод сначала определяет тип контента объекта, вызывая getContentType метод. Если это - первый раз, когда приложение видело, что определенный тип контента, обработчик содержимого для того типа контента создается:

1. Если приложение установило экземпляр фабрики обработчика содержимого, используя setContentHandlerFactory метод, createContentHandler метод того экземпляра вызывают с типом контента как параметр; результатом является обработчик содержимого для того типа контента.
2. Если никакая фабрика обработчика содержимого еще не была установлена, или если фабрика createContentHandler возвраты метода null, тогда приложение загружает названный класс:

            sun.net.www.content.<contentType>
        

   где <contentType> формируется, беря строку типа контента, заменяя все символы наклонной черты с a period ('. '), и все другие неалфавитно-цифровые символы с символом подчеркивания'_'. Алфавитно-цифровые символы являются определенно 26 прописными буквами ASCII'A'через'Z', 26 строчных ASCII обозначают буквами'a'через'z', и 10 цифр ASCII'0'через'9'. Если указанный класс не существует, или не является подклассом ContentHandler, тогда UnknownServiceException бросается.

Возвраты:

объект выбирается. instanceof оператор должен использоваться, чтобы определить определенный вид возвращенного объекта.

Броски:

IOException - если ошибка ввода-вывода происходит, получая контент.

UnknownServiceException - если протокол не поддерживает тип контента.

См. Также:

ContentHandlerFactory.createContentHandler(java.lang.String), getContentType(), setContentHandlerFactory(java.net.ContentHandlerFactory)

getContent

public Object getContent(Class[] classes)
                  throws IOException

Получает содержание этого соединения URL.

Параметры:

classes - Class массив, указывающий на требуемые типы

Возвраты:

объект, выбранный, который является первым соответствием типа, определенного в массиве классов. нуль, если ни один из требуемых типов не поддерживается. instanceof оператор должен использоваться, чтобы определить определенный вид возвращенного объекта.

Броски:

IOException - если ошибка ввода-вывода происходит, получая контент.

UnknownServiceException - если протокол не поддерживает тип контента.

С тех пор:

1.3

См. Также:

getContent(), ContentHandlerFactory.createContentHandler(java.lang.String), getContent(java.lang.Class[]), setContentHandlerFactory(java.net.ContentHandlerFactory)

getPermission

public Permission getPermission()
                         throws IOException

Возвращает объект полномочий, представляющий разрешение, необходимое, чтобы сделать соединение представленным этим объектом. Этот нуль возвратов метода, если никакое разрешение не обязано делать соединение. По умолчанию, этот метод возвраты java.security.AllPermission. Подклассы должны переопределить этот метод и возвратить разрешение, которое лучше всего представляет разрешение, требуемое сделать соединение с URL. Например, a URLConnection представление a file: URL возвратил бы a java.io.FilePermission объект.

Возвращенное разрешение может зависящий от состояния соединения. Например, разрешение перед соединением может отличаться от этого после соединения. Например, HTTP разъединяют, говорят foo.com, может перенаправить соединение с различным узлом, сказать bar.com. Прежде, чем соединить разрешение, возвращенное соединением, представит разрешение, должен был соединиться с foo.com, в то время как разрешение, возвращенное после соединения, будет к bar.com.

Полномочия обычно используются в двух целях: защищать кэши объектов, полученных через URLConnections, и проверять право получателя узнать об определенном URL. В первом случае разрешение должно быть получено после того, как объект был получен. Например, в HTTP-соединении, это представит разрешение, чтобы соединиться с узлом, от которого были в конечном счете выбраны данные. Во втором случае разрешение должно быть получено и протестировано перед соединением.

Возвраты:

объект полномочий, представляющий разрешение, необходимое, чтобы сделать соединение, представленное этим URLConnection.

Броски:

IOException - если вычисление разрешения требует сетевого или файлового ввода-вывода, и исключение происходит, вычисляя это.

getInputStream

public InputStream getInputStream()
                           throws IOException

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

Возвраты:

входной поток, который читает из этого открытого соединения.

Броски:

IOException - если ошибка ввода-вывода происходит, создавая входной поток.

UnknownServiceException - если протокол не поддерживает ввод.

См. Также:

setReadTimeout(int), getReadTimeout()

getOutputStream

public OutputStream getOutputStream()
                             throws IOException

Возвращает поток вывода, который пишет в это соединение.

Возвраты:

поток вывода, который пишет в это соединение.

Броски:

IOException - если ошибка ввода-вывода происходит, создавая поток вывода.

UnknownServiceException - если протокол не поддерживает вывод.

toString

public String toString()

Возвраты a String представление этого соединения URL.

Переопределения:

toString в классе Object

Возвраты:

строковое представление этого URLConnection.

setDoInput

public void setDoInput(boolean doinput)

Устанавливает значение doInput поле для этого URLConnection к указанному значению.

Соединение URL может использоваться для ввода и/или выведено. Установите флаг DoInput в истину, если Вы намереваетесь использовать соединение URL для ввода, ложь если нет. Значение по умолчанию является истиной.

Параметры:

doinput - новое значение.

Броски:

IllegalStateException - если уже соединено

См. Также:

doInput, getDoInput()

getDoInput

public boolean getDoInput()

Возвращает значение этого URLConnection's doInput флаг.

Возвраты:

значение этого URLConnection's doInput флаг.

См. Также:

setDoInput(boolean)

setDoOutput

public void setDoOutput(boolean dooutput)

Устанавливает значение doOutput поле для этого URLConnection к указанному значению.

Соединение URL может использоваться для ввода и/или выведено. Установите флаг DoOutput в истину, если Вы намереваетесь использовать соединение URL для вывода, ложь если нет. Значение по умолчанию является ложью.

Параметры:

dooutput - новое значение.

Броски:

IllegalStateException - если уже соединено

См. Также:

getDoOutput()

getDoOutput

public boolean getDoOutput()

Возвращает значение этого URLConnection's doOutput флаг.

Возвраты:

значение этого URLConnection's doOutput флаг.

См. Также:

setDoOutput(boolean)

setAllowUserInteraction

public void setAllowUserInteraction(boolean allowuserinteraction)

Установите значение allowUserInteraction поле этого URLConnection.

Параметры:

allowuserinteraction - новое значение.

Броски:

IllegalStateException - если уже соединено

См. Также:

getAllowUserInteraction()

getAllowUserInteraction

public boolean getAllowUserInteraction()

Возвращает значение allowUserInteraction поле для этого объекта.

Возвраты:

значение allowUserInteraction поле для этого объекта.

См. Также:

setAllowUserInteraction(boolean)

setDefaultAllowUserInteraction

public static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)

Устанавливает значение по умолчанию allowUserInteraction поле для всего будущего URLConnection объекты к указанному значению.

Параметры:

defaultallowuserinteraction - новое значение.

См. Также:

getDefaultAllowUserInteraction()

getDefaultAllowUserInteraction

public static boolean getDefaultAllowUserInteraction()

Возвращает значение по умолчанию allowUserInteraction поле.

Значение по умолчанию Ths является "липким", будучи частью статического состояния всего URLConnections. Этот флаг применяется к следующему, и все после URLConnections, которые создаются.

Возвраты:

значение по умолчанию allowUserInteraction поле.

См. Также:

setDefaultAllowUserInteraction(boolean)

setUseCaches

public void setUseCaches(boolean usecaches)

Устанавливает значение useCaches поле этого URLConnection к указанному значению.

Некоторые протоколы делают кэширование документов. Иногда, важно быть в состоянии "туннелировать через" и проигнорировать кэши (например, кнопка "перезагрузки" в браузере). Если флаг UseCaches на соединении является истиной, соединению позволяют использовать безотносительно кэшей, это может. Если ложь, кэши должны быть проигнорированы. Значение по умолчанию прибывает из DefaultUseCaches, который значения по умолчанию к истине.

Параметры:

usecaches - a boolean указание, позволить ли кэшироваться

Броски:

IllegalStateException - если уже соединено

См. Также:

getUseCaches()

getUseCaches

public boolean getUseCaches()

Возвращает значение этого URLConnection's useCaches поле.

Возвраты:

значение этого URLConnection's useCaches поле.

См. Также:

setUseCaches(boolean)

setIfModifiedSince

public void setIfModifiedSince(long ifmodifiedsince)

Устанавливает значение ifModifiedSince поле этого URLConnection к указанному значению.

Параметры:

ifmodifiedsince - новое значение.

Броски:

IllegalStateException - если уже соединено

См. Также:

getIfModifiedSince()

getIfModifiedSince

public long getIfModifiedSince()

Возвращает значение этого объекта ifModifiedSince поле.

Возвраты:

значение этого объекта ifModifiedSince поле.

См. Также:

setIfModifiedSince(long)

getDefaultUseCaches

public boolean getDefaultUseCaches()

Возвращает значение по умолчанию a URLConnection's useCaches флаг.

Значение по умолчанию Ths является "липким", будучи частью статического состояния всего URLConnections. Этот флаг применяется к следующему, и все после URLConnections, которые создаются.

Возвраты:

значение по умолчанию a URLConnection's useCaches флаг.

См. Также:

setDefaultUseCaches(boolean)

setDefaultUseCaches

public void setDefaultUseCaches(boolean defaultusecaches)

Устанавливает значение по умолчанию useCaches поле к указанному значению.

Параметры:

defaultusecaches - новое значение.

См. Также:

getDefaultUseCaches()

setRequestProperty

public void setRequestProperty(String key,
                      String value)

Устанавливает общее свойство запроса. Если свойство с ключом уже существует, перезапишите его значение с новым значением.

ОТМЕТЬТЕ: HTTP требует всех свойств запроса, у которых могут по закону быть многократные экземпляры с тем же самым ключом, чтобы использовать синтаксис списка запятой-seperated, который позволяет многократным свойствам быть добавленными в единственное свойство.

Параметры:

key - ключевое слово, которым известен запрос (например,"Accept").

value - значение связалось с этим.

Броски:

IllegalStateException - если уже соединено

NullPointerException - если ключ null

См. Также:

getRequestProperty(java.lang.String)

addRequestProperty

public void addRequestProperty(String key,
                      String value)

Добавляет общее свойство запроса, определенное парой ключ/значение. Этот метод не будет перезаписывать существующие значения, связанные с тем же самым ключом.

Параметры:

key - ключевое слово, которым известен запрос (например,"Accept").

value - значение связалось с этим.

Броски:

IllegalStateException - если уже соединено

NullPointerException - если ключ является нулем

С тех пор:

1.4

См. Также:

getRequestProperties()

getRequestProperty

public String getRequestProperty(String key)

Возвращает значение именованного общего свойства запроса для этого соединения.

Параметры:

key - ключевое слово, которым известен запрос (например, "Примите").

Возвраты:

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

Броски:

IllegalStateException - если уже соединено

См. Также:

setRequestProperty(java.lang.String, java.lang.String)

getRequestProperties

public Map<String,List<String>> getRequestProperties()

Возвращает неподдающуюся изменению Карту общих свойств запроса для этого соединения. Ключи Map являются Строками, которые представляют имена полей заголовка запроса. Каждым значением Карты является неподдающийся изменению Список Строк, который представляет соответствующие значения полей.

Возвраты:

Карта общих свойств запроса для этого соединения.

Броски:

IllegalStateException - если уже соединено

С тех пор:

1.4

setDefaultRequestProperty

@Deprecated
public static void setDefaultRequestProperty(String key,
                                        String value)

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

Устанавливает значение по умолчанию общего свойства запроса. Когда a URLConnection создается, это инициализируется с этими свойствами.

Параметры:

key - ключевое слово, которым известен запрос (например,"Accept").

value - значение связалось с ключом.

См. Также:

setRequestProperty(java.lang.String,java.lang.String), getDefaultRequestProperty(java.lang.String)

getDefaultRequestProperty

@Deprecated
public static String getDefaultRequestProperty(String key)

Осуждаемый. Экземпляр определенный getRequestProperty метод должен использоваться после соответствующего экземпляра URLConnection, получается.

Возвращает значение свойства запроса по умолчанию. Свойства запроса по умолчанию устанавливаются для каждого соединения.

Параметры:

key - ключевое слово, которым известен запрос (например, "Примите").

Возвраты:

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

См. Также:

getRequestProperty(java.lang.String), setDefaultRequestProperty(java.lang.String, java.lang.String)

setContentHandlerFactory

public static void setContentHandlerFactory(ContentHandlerFactory fac)

Наборы ContentHandlerFactory из приложения. Однажды это может вызвать самое большее приложение.

ContentHandlerFactory экземпляр используется, чтобы создать обработчик содержимого из типа контента

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

Параметры:

fac - требуемая фабрика.

Броски:

Error - если фабрика была уже определена.

SecurityException - если менеджер безопасности существует и checkSetFactory метод не позволяет работу.

См. Также:

ContentHandlerFactory, getContent(), SecurityManager.checkSetFactory()

guessContentTypeFromName

public static String guessContentTypeFromName(String fname)

Попытки определить тип контента объекта, основанного на указанном компоненте "файла" URL. Это - метод удобства, который может использоваться подклассами, которые переопределяют getContentType метод.

Параметры:

fname - имя файла.

Возвраты:

предположение относительно того, каков тип контента объекта, основан на своем имени файла.

См. Также:

getContentType()

guessContentTypeFromStream

public static String guessContentTypeFromStream(InputStream is)
                                         throws IOException

Попытки определить тип входного потока, основанного на символах в начале входного потока. Этот метод может использоваться подклассами, которые переопределяют getContentType метод.

Идеально, эта подпрограмма не была бы необходима. Но многие http серверы возвращают неправильный тип контента; кроме того, есть много нестандартных расширений. Прямой контроль байтов, чтобы определить тип контента часто более точен чем вера типу контента, требуемому http сервер.

Параметры:

is - входной поток, который поддерживает метки.

Возвраты:

предположение в типе контента, или null если ни один не может быть определен.

Броски:

IOException - если ошибка ввода-вывода происходит, читая входной поток.

См. Также:

InputStream.mark(int), InputStream.markSupported(), getContentType()