URL Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Класс URL представляет универсальный указатель ресурсов, указатель на "ресурс" в Интернете.
[Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)]
public sealed class URL : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ISerializable[<Android.Runtime.Register("java/net/URL", DoNotGenerateAcw=true)>]
type URL = class
inherit Object
interface ISerializable
interface IJavaObject
interface IDisposable
interface IJavaPeerable- Наследование
- Атрибуты
- Реализации
Комментарии
Класс URL представляет универсальный указатель ресурсов, указатель на "ресурс" в Интернете. Ресурс может быть чем-то таким же простым, как файл или каталог, или ссылкой на более сложный объект, например запрос к базе данных или поисковой системе. Дополнительные сведения о типах URL-адресов и их форматах см. в статье Типы URL-адресов.http://web.archive.org/web/20051219043731/http://archive.ncsa.uiuc.edu/SDG/Software/Mosaic/Demo/url-primer.html
Как правило, URL-адрес можно разбить на несколько частей. Рассмотрим следующий пример: <blockquote>
http://www.example.com/docs/resource1.html
</blockquote>
Приведенный выше URL-адрес указывает, что используется http протокол (протокол передачи гипертекста), а сведения находятся на хост-компьютере с именем www.example.com. Сведения на этом хост-компьютере называются /docs/resource1.html. Точное значение этого имени на хост-компьютере зависит как от протокола, так и от узла. Данные обычно находятся в файле, но могут быть созданы на лету. Этот компонент URL-адреса называется компонентом пути .
ПРИ необходимости в URL-адресе можно указать "порт", который представляет собой номер порта, к которому выполняется TCP-подключение на удаленном хост-компьютере. Если порт не указан, вместо него используется порт по умолчанию для протокола. Например, порт по умолчанию для http — 80. Альтернативный порт можно указать как: <blockquote>
http://www.example.com:1080/docs/resource1.html
</blockquote>
Синтаксис URL определяется RFC 2396: универсальные идентификаторы ресурсов (URI): универсальный синтаксисhttp://www.ietf.org/rfc/rfc2396.txt, измененный RFC 2732: формат для литеральных IPv6-адресов в URL-адресахhttp://www.ietf.org/rfc/rfc2732.txt. Формат IPv6-адресов литерала также поддерживает scope_ids. Синтаксис и использование scope_ids описаны здесь.
URL-адрес может добавить к нему "фрагмент", также известный как "ссылка" или "ссылка". Фрагмент обозначается символом резкого знака "#", за которым следуют другие символы. Например, <blockquote>
http://java.sun.com/index.html#chapter1
</blockquote>
Этот фрагмент технически не является частью URL-адреса. Скорее, он указывает на то, что после извлечения указанного ресурса приложение особенно заинтересовано в той части документа, к которому прикреплен тег chapter1 . Значение тега зависит от ресурса.
Приложение также может указать "относительный URL-адрес", который содержит только достаточно сведений для доступа к ресурсу относительно другого URL-адреса. Относительные URL-адреса часто используются на HTML-страницах. Например, если содержимое URL-адреса: <blockquote>
http://java.sun.com/index.html
</blockquote> содержится в нем относительный URL-адрес: <blockquote>
FAQ.html
</blockquote> это будет сокращение для: <blockquote>
http://java.sun.com/FAQ.html
</blockquote>
Относительный URL-адрес не должен указывать все компоненты URL-адреса. Если отсутствует протокол, имя узла или номер порта, значение наследуется от полностью указанного URL-адреса. Необходимо указать компонент файла. Необязательный фрагмент не наследуется.
Класс URL не кодирует и не декодирует компоненты URL-адресов в соответствии с механизмом экранирования, определенным в RFC2396. Вызывающий объект отвечает за кодирование любых полей, которые необходимо экранировать перед вызовом URL-адреса, а также декодирование всех экранированных полей, возвращаемых из URL-адреса. Кроме того, так как URL-адрес не имеет сведений о экранировании URL-адреса, он не распознает эквивалентность между закодированной или декодированной формой одного и того же URL-адреса. Например, два URL-адреса:<br>
http://foo.com/hello world/ and http://foo.com/hello%20world
будут считаться не равными друг другу.
Обратите внимание, java.net.URI что класс выполняет экранирование полей компонента в определенных обстоятельствах. Рекомендуемый способ управления кодировкой и декодированием URL-адресов — использовать java.net.URI, а для преобразования между этими двумя классами — с помощью #toURI() и URI#toURL().
URLEncoder Классы и URLDecoder также можно использовать, но только для кодирования формы HTML, которая отличается от схемы кодирования, определенной в RFC2396.
Добавлено в JDK1.0.
Документация по Java для java.net.URL.
Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License Creative Commons 2.5 Attribution License.
Конструкторы
| URL(String) |
Создает |
| URL(String, String, Int32, String) |
Создает |
| URL(String, String, Int32, String, URLStreamHandler) |
Создает |
| URL(String, String, String) |
Создает URL-адрес на основе указанного |
| URL(URL, String) |
Создает URL-адрес путем синтаксического анализа заданной спецификации в указанном контексте. |
| URL(URL, String, URLStreamHandler) |
Создает URL-адрес путем синтаксического анализа заданной спецификации с указанным обработчиком в указанном контексте. |
Свойства
| Authority |
Возвращает часть центра этого |
| Class |
Возвращает класс среды выполнения данного объекта |
| Content |
Возвращает содержимое этого URL-адреса. |
| DefaultPort |
Возвращает номер порта по умолчанию для протокола, связанного с данным |
| File |
Возвращает имя файла данного |
| Handle |
Дескриптор базового экземпляра Android. (Унаследовано от Object) |
| Host |
Возвращает имя узла этого |
| JniIdentityHashCode |
Класс |
| JniPeerMembers |
Класс |
| Path |
Возвращает часть пути данного объекта |
| PeerReference |
Класс |
| Port |
Возвращает номер порта этого |
| Protocol |
Возвращает имя протокола данного |
| Query |
Возвращает часть запроса данного объекта |
| Ref |
Возвращает привязку (также называемую "ссылкой") этого |
| ThresholdClass |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| ThresholdType |
Этот API поддерживает инфраструктуру Mono для Android и не предназначен для использования непосредственно из кода. (Унаследовано от Object) |
| UserInfo |
Возвращает часть userInfo данного объекта |
Методы
| Clone() |
Создает и возвращает копию этого объекта. (Унаследовано от Object) |
| Dispose() |
Класс |
| Dispose(Boolean) |
Класс |
| Equals(Object) |
Указывает, равен ли какой-то другой объект этому объекту. (Унаследовано от Object) |
| GetContent(Class[]) |
Возвращает содержимое этого URL-адреса. |
| GetHashCode() |
Возвращает значение хэш-кода для объекта. (Унаследовано от Object) |
| JavaFinalize() |
Вызывается сборщиком мусора для объекта , когда сборка мусора определяет, что больше нет ссылок на объект . (Унаследовано от Object) |
| Notify() |
Пробуждение одного потока, ожидающего на мониторе этого объекта. (Унаследовано от Object) |
| NotifyAll() |
Активирует все потоки, ожидающие на мониторе этого объекта. (Унаследовано от Object) |
| OpenConnection() |
|
| OpenConnection(Proxy) |
То же, что и |
| OpenStream() |
Открывает подключение к этому |
| SameFile(URL) |
Сравнивает два URL-адреса, за исключением компонента фрагмента. |
| SetHandle(IntPtr, JniHandleOwnership) |
Задает свойство Handle. (Унаследовано от Object) |
| SetURLStreamHandlerFactory(IURLStreamHandlerFactory) |
Задает значение приложения |
| ToArray<T>() |
Класс |
| ToExternalForm() |
Создает строковое представление этого |
| ToString() |
Возвращает строковое представление объекта. (Унаследовано от Object) |
| ToURI() |
|
| UnregisterFromRuntime() |
Класс |
| Wait() |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления/><em> или <прерывания></em>. (Унаследовано от Object) |
| Wait(Int64) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> em, либо до истечения определенного количества реального времени. (Унаследовано от Object) |
| Wait(Int64, Int32) |
Заставляет текущий поток ждать, пока он не будет пробужден, как правило, из-за <уведомления</>em>, <>прерывания< или> 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) |
Класс |