URLConnection Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Абстрактный класс URLConnection
— это суперкласс всех классов, представляющих связь между приложением и URL-адресом.
[Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)]
public abstract class URLConnection : Java.Lang.Object
[<Android.Runtime.Register("java/net/URLConnection", DoNotGenerateAcw=true)>]
type URLConnection = class
inherit Object
- Наследование
- Производный
- Атрибуты
Комментарии
Абстрактный класс URLConnection
— это суперкласс всех классов, представляющих связь между приложением и URL-адресом. Экземпляры этого класса можно использовать как для чтения, так и для записи в ресурс, на который ссылается URL-адрес. Как правило, создание подключения к URL-адресу — это многоэтапный процесс:
<Граница таблицы центра><=2 сводка="Описывает процесс создания подключения к URL-адресу: openConnection() и connect() с течением времени".><tr><openConnection()
>< th/th/><th<><connect()
>/th/tr tr<><>td>Управление параметрами, влияющими на подключение к удаленному ресурсу.</td td><>interact with the resource; поля заголовка запроса и содержимое.</td></tr></table> ----------------------------> <br>time</center>
<ol><li>Объект подключения создается путем вызова openConnection
метода по URL-адресу. <li>Параметры установки и общие свойства запроса обрабатываются. <li>Фактическое подключение к удаленному объекту connect
выполняется с помощью метода. <li>Удаленный объект становится доступным. К полям заголовка и содержимому удаленного объекта можно получить доступ. </Пр>
Параметры установки изменяются с помощью следующих методов: <ul<>li<setAllowUserInteraction
>li li><setDoInput
<setDoOutput
>li li li><setIfModifiedSince
/ul>setUseCaches
<>
и общие свойства запроса изменяются с помощью метода: <ul lisetRequestProperty
></ul><>
Значения по умолчанию для UseCaches
AllowUserInteraction
параметров можно задать с помощью методов setDefaultAllowUserInteraction
иsetDefaultUseCaches
.
Каждый из указанных выше set
методов имеет соответствующий get
метод для получения значения параметра или свойства общего запроса. Конкретные параметры и общие свойства запроса, применимые к протоколу.
Следующие методы используются для доступа к полям заголовка и содержимому после подключения к удаленному объекту: <ul><li li>getContent
<li>getHeaderField
<li><getInputStream
<>getOutputStream
/ul>
К определенным полям заголовка часто обращаются. Методы: <ul<>li>><getContentLength
getContentEncoding
getContentType
>getDate
><<</ul>getExpiration
<>getLastModifed
<>
предоставляет удобный доступ к этим полям. Метод getContentType
используется методом getContent
для определения типа удаленного объекта. Подклассы могут оказаться удобными для переопределения getContentType
метода.
В обычном случае все параметры предварительного подключения и общие свойства запроса можно игнорировать: параметры предварительного подключения и свойства запроса по умолчанию являются разумными значениями. Для большинства клиентов этого интерфейса существуют только два интересных метода: getInputStream
и getContent
, которые зеркально отражаются в URL
классе с помощью удобных методов.
Дополнительные сведения о свойствах запроса и полях заголовков http
подключения можно найти по адресу: <blockquote>
<a href="http://www.ietf.org/rfc/rfc2616.txt">http://www.ietf.org/rfc/rfc2616.txt</a>
</blockquote>
Вызов close()
методов или InputStream
OutputStream
URLConnection
после запроса может освободить сетевые ресурсы, связанные с этим экземпляром, если для этого экземпляра не указаны определенные спецификации протокола.
Добавлено в JDK1.0.
Документация по Java для java.net.URLConnection
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.
Конструкторы
URLConnection(IntPtr, JniHandleOwnership) |
Конструктор, используемый при создании управляемых представлений объектов JNI; вызывается средой выполнения. |
URLConnection(URL) |
Создает подключение URL-адреса к указанному URL-адресу. |
Свойства
AllowUserInteraction |
Возвращает значение |
Class |
Возвращает класс среды выполнения этого |
Connected |
Если |
ConnectTimeout |
Возвращает параметр времени ожидания подключения. -или- Задает указанное значение времени ожидания (в миллисекундах), которое следует использовать при открытии связи с ресурсом, на который ссылается этот URLConnection. |
Content |
Извлекает содержимое этого URL-подключения. |
ContentEncoding |
Возвращает значение поля заголовка |
ContentLength |
Возвращает значение поля заголовка |
ContentLengthLong |
Возвращает значение поля заголовка |
ContentType |
Возвращает значение поля заголовка |
Date |
Возвращает значение поля заголовка |
DefaultAllowUserInteraction |
Возвращает значение |
DefaultUseCaches |
Возвращает значение по умолчанию флага |
DoInput |
Возвращает значение этого |
DoOutput |
Возвращает значение этого |
Expiration |
Возвращает значение поля заголовка |
FileNameMap |
Возвращает реализацию, подходящую |
Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
HeaderFields |
Возвращает неизменяемую карту полей заголовка. |
IfModifiedSince |
Возвращает значение поля этого объекта |
InputStream |
Возвращает входной поток, который считывается из этого открытого подключения. |
JniIdentityHashCode |
Абстрактный класс |
JniPeerMembers |
Абстрактный класс |
LastModified |
Возвращает значение поля заголовка |
OutputStream |
Возвращает выходной поток, записываемый в это соединение. |
PeerReference |
Абстрактный класс |
Permission |
Возвращает объект разрешения, представляющий разрешение, необходимое для подключения, представленного этим объектом. |
ReadTimeout |
Возвращает параметр времени ожидания чтения. -или- Задает время ожидания чтения для указанного времени ожидания в миллисекундах. |
RequestProperties |
Возвращает неизменяемую карту общих свойств запроса для этого соединения. |
ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. |
Url |
URL-адрес представляет удаленный объект в World Wide Web, к которому открывается это подключение. |
URL |
Возвращает значение этого |
UseCaches |
Возвращает значение этого |
Методы
AddRequestProperty(String, String) |
Добавляет общее свойство запроса, указанное парой "ключ-значение". |
Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
Connect() |
Открывает ссылку на связь с ресурсом, на который ссылается этот URL-адрес, если такое подключение еще не установлено. |
ConnectAsync() |
Абстрактный класс |
Dispose() |
Абстрактный класс |
Dispose(Boolean) |
Абстрактный класс |
Equals(Object) |
Указывает, равен ли другой объект этому объекту. (Унаследовано от Object) |
GetContent(Class[]) |
Извлекает содержимое этого URL-подключения. |
GetDefaultRequestProperty(String) |
Устаревшие..
Возвращает значение свойства запроса по умолчанию. |
GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
GetHeaderField(Int32) |
Возвращает значение для поля заголовка |
GetHeaderField(String) |
Возвращает значение именованного поля заголовка. |
GetHeaderFieldDate(String, Int64) |
Возвращает значение именованного поля, проанализированного как дата. |
GetHeaderFieldInt(String, Int32) |
Возвращает значение именованного поля, проанализированного как число. |
GetHeaderFieldKey(Int32) |
Возвращает ключ для поля заголовка |
GetHeaderFieldLong(String, Int64) |
Возвращает значение именованного поля, проанализированного как число. |
GetRequestProperty(String) |
Возвращает значение именованного свойства общего запроса для этого соединения. |
GuessContentTypeFromName(String) |
Пытается определить тип контента объекта на основе указанного компонента "file" URL-адреса. |
GuessContentTypeFromStream(Stream) |
Пытается определить тип входного потока на основе символов в начале входного потока. |
JavaFinalize() |
Вызывается сборщиком мусора в объекте, когда сборка мусора определяет, что больше ссылок на объект нет. (Унаследовано от Object) |
Notify() |
Пробуждение одного потока, ожидающего монитора этого объекта. (Унаследовано от Object) |
NotifyAll() |
Просыпает все потоки, ожидающие монитора этого объекта. (Унаследовано от Object) |
SetContentHandlerFactory(IContentHandlerFactory) |
|
SetDefaultRequestProperty(String, String) |
Устаревшие..
Задает значение по умолчанию свойства общего запроса. |
SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
SetRequestProperty(String, String) |
Задает свойство общего запроса. |
ToArray<T>() |
Абстрактный класс |
ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
UnregisterFromRuntime() |
Абстрактный класс |
Wait() |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>помощи уведомления</em> или <эм>прерванного</em>. (Унаследовано от Object) |
Wait(Int64) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
Wait(Int64, Int32) |
Приводит к тому, что текущий поток будет ждать, пока он не проснется, как правило, при <>получении уведомления</>em или <>эм прервано< или> до тех пор, пока не истекло определенное количество реального времени. (Унаследовано от Object) |
Явные реализации интерфейса
IJavaPeerable.Disposed() |
Абстрактный класс |
IJavaPeerable.DisposeUnlessReferenced() |
Абстрактный класс |
IJavaPeerable.Finalized() |
Абстрактный класс |
IJavaPeerable.JniManagedPeerState |
Абстрактный класс |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
Абстрактный класс |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
Абстрактный класс |
IJavaPeerable.SetPeerReference(JniObjectReference) |
Абстрактный класс |
Методы расширения
JavaCast<TResult>(IJavaObject) |
Выполняет преобразование типа, проверяемого средой выполнения Android. |
JavaCast<TResult>(IJavaObject) |
Абстрактный класс |
GetJniTypeName(IJavaPeerable) |
Абстрактный класс |