Класс URL

public URL(String protocol, String host, int port, String file) throws MalformedURLException

Создаёт объект URL из указанного protocol, host, port числа и file.

host может быть выражено как имя хоста или буквальный IP-адрес. Если используется буквальный IPv6-адрес, он должен быть заключён в квадратные скобки ('[' и ']'), как указано в RFC 2732; однако также принимается буквальный формат IPv6-адреса, определённый в RFC 2373: Архитектура адресации IP версии 6.

Указание port числа -1 означает, что URL должен использовать стандартный порт для протокола.

Если это первый объект URL, создаваемый с указанным протоколом, для этого протокола создаётся объект обработчика потокового протокола, экземпляр класса URLStreamHandler:

1. Если приложение ранее настроило экземпляр URLStreamHandlerFactory в качестве фабрики обработчиков потоков, то вызывается метод createURLStreamHandler этого экземпляра со строкой протокола в качестве аргумента для создания обработчика потокового протокола.
2. Если никакая фабрика URLStreamHandlerFactory ещё не была настроена, или если метод фабрики createURLStreamHandler возвращает null, то используется механизм ServiceLoader для поиска реализаций URLStreamHandlerProvider с помощью системного загрузчика классов. Порядок поиска поставщиков зависит от реализации, и реализация свободна кешировать найденных поставщиков. Возможная ошибка конфигурации сервиса ServiceConfigurationError, Error или RuntimeException, возникшая при вызове createURLStreamHandler, будет передана потоку вызова. Если экземпляр поставщика существует, вызывается метод createURLStreamHandler каждого поставщика со строкой протокола в качестве аргумента до тех пор, пока поставщик не вернёт значение, отличное от null, или пока все поставщики не будут исчерпаны.
3. Если на предыдущем шаге не удалось найти обработчик протокола, конструктор читает значение системной переменной:

   java.protocol.handler.pkgs

   Если значение этой системной переменной не равно null, оно интерпретируется как список пакетов, разделенных вертикальной слеш-символом '|'. Конструктор пытается загрузить класс с именем:

   <package>.<protocol>.Handler

   , где <package> заменяется именем пакета, а <protocol> — именем протокола. Если такого класса нет, или класс существует, но не является подклассом URLStreamHandler, то пробуется следующий пакет в списке.
4. Если на предыдущем шаге не удалось найти обработчик протокола, то конструктор пытается загрузить встроенный обработчик протокола. Если такого класса нет, или класс существует, но не является подклассом URLStreamHandler, то выбрасывается MalformedURLException.

Обработчики протоколов для следующих протоколов гарантированно существуют в пути поиска:

• http
• https
• file
• jar

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

Данный конструктор не выполняет проверку входных данных.

public URL(String protocol, String host, String file) throws MalformedURLException

Создаёт URL из указанного имени protocol, имени host и имени file файла. Используется стандартный порт для указанного протокола.

Этот конструктор эквивалентен четырёхаргументному конструктору с единственным отличием — использованием стандартного порта для указанного протокола. Данный конструктор не выполняет проверку входных данных.

public URL(String protocol, String host, int port, String file, URLStreamHandler handler) throws MalformedURLException

Создаёт объект URL из указанного protocol, host, port номера, file, и handler. Указание port числа -1 означает, что URL должен использовать стандартный порт для протокола. Указание handler обработчика null означает, что URL должен использовать стандартный обработчик потоков для протокола, как описано в: URL(java.lang.String, java.lang.String, int, java.lang.String)

Если обработчик не равен null и существует менеджер безопасности, вызывается метод checkPermission менеджера безопасности с разрешением NetPermission("specifyStreamHandler"). Это может привести к исключению SecurityException. Данный конструктор не выполняет проверку входных данных.

public URL(String spec) throws MalformedURLException

Создаёт объект URL из String представления.

Этот конструктор эквивалентен вызову двухаргументного конструктора с null первым аргументом.

public URL(URL context, String spec) throws MalformedURLException

Создаёт URL, анализируя заданный спецификатор в указанном контексте. Новый URL создаётся из заданного контекстного URL и аргумента spec, как описано в RFC2396 "Uniform Resource Identifiers : Generic * Syntax" :

          <scheme>://<authority><path>?<query>#<fragment>
 

Ссылка анализируется на составляющие: схему, авторитет, путь, запрос и фрагмент. Если компонент пути пуст, а компоненты схемы, авторитета и запроса не определены, то новый URL является ссылкой на текущий документ. В противном случае, фрагмент и часть запроса, присутствующие в spec, используются в новом URL.

Если компонент схемы определён в заданном спецификаторе и не совпадает со схемой контекста, то новый URL создаётся как абсолютный URL, основанный только на спецификаторе. В противном случае компонент схемы наследуется из контекстного URL.

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

Если компонент пути спецификатора начинается с символа косой черты "/", то путь обрабатывается как абсолютный, и путь спецификатора заменяет контекстный путь.

В противном случае, путь обрабатывается как относительный путь и добавляется к контекстному пути, как описано в RFC2396. Кроме того, в этом случае путь канонизируется путём удаления изменений каталога, вызванных появлениями ".." и ".".

Для более подробного описания анализа URL обратитесь к RFC2396.

public URL(URL context, String spec, URLStreamHandler handler) throws MalformedURLException

Создаёт URL, анализируя заданный спецификатор с указанным обработчиком в заданном контексте. Если обработчик равен null, анализ происходит, как и в конструкторе с двумя аргументами.

public String getQuery()

Получает часть запроса этого URL.

public String getPath()

Получает часть пути этого URL.

public String getUserInfo()

Получает часть userInfo этого URL.

public String getAuthority()

Получает часть авторитета этого URL.

public int getPort()

Получает номер порта этого URL.

public int getDefaultPort()

Получает стандартный номер порта протокола, связанного с этим URL. Если схема URL или URLStreamHandler для URL не определяют стандартный номер порта, возвращается -1.

public String getProtocol()

Получает имя протокола этого URL.

public String getHost()

Получает имя хоста этого URL, если применимо. Формат хоста соответствует RFC 2732, т.е. для литерального IPv6 адреса, этот метод вернёт IPv6 адрес, заключённый в квадратные скобки ('[' и ']').

public String getFile()

Получает имя файла этого URL. Возвращаемая часть файла будет такой же, как getPath(), плюс конкатенация значения getQuery(), если таковое имеется. Если нет части запроса, этот метод и getPath() возвращают идентичные результаты.

public String getRef()

Получает якорь (также известный как "ссылка") этого URL.

public boolean equals(Object obj)

Сравнивает этот URL на равенство с другим объектом.

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

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

Два хоста считаются эквивалентными, если оба имени хостов можно разрешить в одни и те же IP-адреса; иначе, если ни одно имя хоста не может быть разрешено, имена хостов должны быть равны без учёта регистра; или оба имени хостов равны null.

Поскольку сравнение хостов требует разрешения имён, эта операция является блокирующей операцией.

Примечание: Определённое поведение для equals известно как несоответствующее виртуальному хостингу в HTTP.

public int hashCode()

Создаёт целое число, подходящее для индексации в хеш-таблицах.

Хеш-код основан на всех компонентах URL, релевантных для сравнения URL. Таким образом, эта операция является блокирующей операцией.

public boolean sameFile(URL other)

Сравнивает два URL, исключая компонент фрагмента.

Возвращает true если этот URL и аргумент other равны без учёта компонента фрагмента.

public String toString()

Строит строковое представление этого URL. Строка создаётся путём вызова метода toExternalForm обработчика протокола потока для этого объекта.

public String toExternalForm()

Создаёт строковое представление этого объекта. Строка создаётся путём вызова метода toExternalForm обработчика протокола потока для этого объекта.

public URI toURI() throws URISyntaxException

Возвращает эквивалент URI для этого URL. Этот метод работает так же, как и new URI (this.toString()).

Примечание: любой экземпляр URL, соответствующий RFC 2396, может быть преобразован в URI. Однако некоторые URL, которые не строго соответствуют стандарту, не могут быть преобразованы в URI.

public URLConnection openConnection() throws IOException

Возвращает экземпляр URLConnection, представляющий подключение к удалённому объекту, на который указывает этот URL.

Каждый раз при вызове метода URLStreamHandler.openConnection(URL) обработчика протокола для этого URL создаётся новый экземпляр URLConnection.

Следует отметить, что экземпляр URLConnection не устанавливает фактическое сетевое подключение при создании. Это произойдёт только при вызове URLConnection.connect().

Если для протокола URL (например, HTTP или JAR) существует общедоступный специализированный подкласс URLConnection, принадлежащий одному из следующих пакетов или их подпакетов: java.lang, java.io, java.util, java.net, возвращаемое подключение будет этого подкласса. Например, для HTTP будет возвращён HttpURLConnection, а для JAR — JarURLConnection.

public URLConnection openConnection(Proxy proxy) throws IOException

Аналогично openConnection(), за исключением того, что подключение будет выполнено через указанный прокси-сервер; обработчики протоколов, которые не поддерживают проксирование, проигнорируют параметр прокси и выполнят обычное подключение. Вызов этого метода обходит настройки системного по умолчанию ProxySelector.

public final InputStream openStream() throws IOException

Открывает соединение с этим объектом URL и возвращает поток InputStream для чтения из этого соединения. Этот метод является сокращением для:

     openConnection().getInputStream()
 

public final Object getContent() throws IOException

Получает содержимое этого URL. Этот метод является сокращением для:

     openConnection().getContent()
 

public final Object getContent(Class<?>[] classes) throws IOException

Получает содержимое этого URL. Этот метод является сокращением для:

     openConnection().getContent(classes)
 

public static void setURLStreamHandlerFactory(URLStreamHandlerFactory fac)

Устанавливает фабрику обработчиков протоколов URL приложения. Этот метод может быть вызван не более одного раза в данной виртуальной машине Java.

Экземпляр URLStreamHandlerFactory используется для создания обработчика протокола потока из имени протокола.

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