«Руководство по URL-адресу Java»

«1. Обзор

В этой статье мы собираемся исследовать низкоуровневые операции с сетевым программированием на Java. Мы более подробно рассмотрим URL-адреса.

URL-адрес — это ссылка или адрес ресурса в сети. Проще говоря, код Java, взаимодействующий по сети, может использовать класс java.net.URL для представления адресов ресурсов.

Платформа Java поставляется со встроенной поддержкой сети, включенной в пакет java.net:

import java.net.*;

2. Создание URL

Давайте сначала создадим объект java.net.URL, используя его конструктор и передать строку, представляющую удобочитаемый адрес ресурса:

URL url = new URL("/a-guide-to-java-sockets");

Мы только что создали объект с абсолютным URL. Адрес имеет все части, необходимые для достижения желаемого ресурса.

Мы также можем создать относительный URL; предположим, что у нас есть объект URL, представляющий домашнюю страницу Baeldung:

URL home = new URL("http://baeldung.com");

Далее, давайте создадим новый URL, указывающий на уже известный нам ресурс; мы собираемся использовать другой конструктор, который принимает как существующий URL-адрес, так и имя ресурса относительно этого URL-адреса:

URL url = new URL(home, "a-guide-to-java-sockets");

Теперь мы создали новый URL-адрес объекта URL относительно дома; поэтому относительный URL-адрес действителен только в контексте базового URL-адреса.

Мы можем видеть это в тесте:

@Test
public void givenBaseUrl_whenCreatesRelativeUrl_thenCorrect() {
    URL baseUrl = new URL("http://baeldung.com");
    URL relativeUrl = new URL(baseUrl, "a-guide-to-java-sockets");
    
    assertEquals("http://baeldung.com/a-guide-to-java-sockets", 
      relativeUrl.toString());
}

Однако, если относительный URL определяется как абсолютный в своих составных частях, то базовый URL игнорируется:

@Test
public void givenAbsoluteUrl_whenIgnoresBaseUrl_thenCorrect() {
    URL baseUrl = new URL("http://baeldung.com");
    URL relativeUrl = new URL(
      baseUrl, "/a-guide-to-java-sockets");
    
    assertEquals("http://baeldung.com/a-guide-to-java-sockets", 
      relativeUrl.toString());
}

Наконец, мы можем создать URL, вызвав другой конструктор, который принимает составные части строки URL. Мы рассмотрим это в следующем разделе после рассмотрения компонентов URL.

3. Компоненты URL

URL состоит из нескольких компонентов, которые мы рассмотрим в этом разделе.

Давайте сначала посмотрим на разделение между идентификатором протокола и ресурсом — эти два компонента разделены двоеточием, за которым следуют две косые черты, т. е. ://.

Если у нас есть URL-адрес, такой как http://baeldung.com, то часть перед разделителем, http, является идентификатором протокола, а следующая за ним — именем ресурса, baeldung.com.

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

3.1. Протокол

Чтобы получить протокол, мы используем метод getProtocol():

@Test
public void givenUrl_whenCanIdentifyProtocol_thenCorrect(){
    URL url = new URL("http://baeldung.com");
    
    assertEquals("http", url.getProtocol());
}

3.2. Порт

Чтобы получить порт, мы используем метод getPort():

@Test
public void givenUrl_whenGetsDefaultPort_thenCorrect(){
    URL url = new URL("http://baeldung.com");
    
    assertEquals(-1, url.getPort());
    assertEquals(80, url.getDefaultPort());
}

Обратите внимание, что этот метод извлекает явно определенный порт. Если порт явно не определен, будет возвращено -1.

А поскольку HTTP-связь по умолчанию использует порт 80, порт не определен.

Вот пример, когда у нас есть явно определенный порт:

@Test
public void givenUrl_whenGetsPort_thenCorrect(){
    URL url = new URL("http://baeldung.com:8090");
    
    assertEquals(8090, url.getPort());
}

3.3. Хост

Хост — это часть имени ресурса, которая начинается сразу после разделителя :// и заканчивается расширением доменного имени, в нашем случае .com.

Мы вызываем метод getHost() для получения имени хоста:

@Test
public void givenUrl_whenCanGetHost_thenCorrect(){
    URL url = new URL("http://baeldung.com");
    
    assertEquals("baeldung.com", url.getHost());
}

3.4. Имя файла

Все, что следует после имени хоста в URL-адресе, называется именем файла ресурса. Он может включать как путь, так и параметры запроса или просто имя файла:

@Test
public void givenUrl_whenCanGetFileName_thenCorrect1() {
    URL url = new URL("http://baeldung.com/guidelines.txt");
    
    assertEquals("/guidelines.txt", url.getFile());
}

Предположим, что в Baeldung есть статьи по Java 8 по URL-адресу /articles?topic=java\u0026version=8. Все, что следует после имени хоста, является именем файла:

@Test
public void givenUrl_whenCanGetFileName_thenCorrect2() {
    URL url = new URL("http://baeldung.com/articles?topic=java&version=8");
    
    assertEquals("/articles?topic=java&version=8", url.getFile());
}

3.5. Параметры пути

Мы также можем проверять только параметры пути, в нашем случае это /articles:

@Test
public void givenUrl_whenCanGetPathParams_thenCorrect() {
    URL url = new URL("http://baeldung.com/articles?topic=java&version=8");
    
    assertEquals("/articles", url.getPath());
}

3.6. Параметры запроса

Точно так же мы можем проверить параметры запроса, которые имеют следующий вид: topic=java\u0026version=8:

@Test
public void givenUrl_whenCanGetQueryParams_thenCorrect() {
    URL url = new URL("http://baeldung.com/articles?topic=java<em>&version=8</em>");
    
    assertEquals("topic=java<em>&version=8</em>", url.getQuery());
}

4. Создание URL-адреса с компонентными частями

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

Первый конструктор принимает протокол, имя хоста и имя файла соответственно:

@Test
public void givenUrlComponents_whenConstructsCompleteUrl_thenCorrect() {
    String protocol = "http";
    String host = "baeldung.com";
    String file = "/guidelines.txt";
    URL url = new URL(protocol, host, file);
    
    assertEquals("http://baeldung.com/guidelines.txt", url.toString());
}

Помните о значении имени файла в этом контексте, следующий тест должен прояснить его:

@Test
public void givenUrlComponents_whenConstructsCompleteUrl_thenCorrect2() {
    String protocol = "http";
    String host = "baeldung.com";
    String file = "/articles?topic=java&version=8";
    URL url = new URL(protocol, host, file);
    
    assertEquals("http://baeldung.com/articles?topic=java&version=8", url.toString());
}

второй конструктор принимает протокол, имя хоста, номер порта и имя файла соответственно:

@Test
public void givenUrlComponentsWithPort_whenConstructsCompleteUrl_
  thenCorrect() {
    String protocol = "http";
    String host = "baeldung.com";
    int port = 9000;
    String file = "/guidelines.txt";
    URL url = new URL(protocol, host, port, file);
    
    assertEquals(
      "http://baeldung.com:9000/guidelines.txt", url.toString());
}

5. Заключение

«В этом руководстве мы рассмотрели класс URL и показали, как использовать его в Java для программного доступа к сетевым ресурсам.

Как всегда, полный исходный код статьи и все фрагменты кода можно найти в проекте GitHub.