Главная / I/O / От устаревших конструкторов URL к URI
I/O Средний

От устаревших конструкторов URL к URI

Разбирайте и составляйте идентификаторы ресурсов как значения URI, преобразуя их в URL только при необходимости.

I/O HTTP Migration
Сравнение кода
✕ Deprecated URL constructor 
URL endpoint =
    new URL("https://example.com/api?q=java");
✓ Java 20+ 
URI endpointUri =
    URI.create("https://example.com/api?q=java");
URL endpoint = endpointUri.toURL();
Заметили проблему в этом коде? Сообщите нам.
Почему современный подход лучше
✅

Без устаревшего API

Исключает использование устаревших конструкторов URL.

🧠

Предсказуемая семантика

Сравнение URI не выполняет разрешение, зависящее от сети.

🧩

Удобное составление

URI предназначен для разбора идентификаторов и работы с ними.

Старый подход
Прямое создание URL
Современный подход
Сначала URI, затем URL
Начиная с JDK
20
Сложность
Средний
Поддержка JDK
От устаревших конструкторов URL к URI
Доступно

Конструкторы URL объявлены устаревшими начиная с JDK 20 (март 2023)

Как это работает

Конструкторы URL были объявлены устаревшими в JDK 20, поскольку разбор и проверка равенства URL связаны с неожиданным поведением обработчиков протоколов. URI — предпочтительное неизменяемое представление для разбора, составления, сравнения и нормализации; преобразуйте его только при вызове API, которым требуется URL.

Связанная документация
URI ↗ URL ↗
Доказательство
Посмотреть исходник доказательства ↗
Похожие шаблоны
I/O Начинающий

Modern HTTP client

Java 8
URL url = new URL("https://api.com/data");
HttpURLConnection con =
    (HttpURLConnection) url.openConnection();
con.setRequestMethod("GET");
BufferedReader in = new BufferedReader(
    new InputStreamReader(con.getInputStream()));
// read lines, close streams...
Java 11+
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.com/data"))
    .build();
var response = client.send(
    request, BodyHandlers.ofString());
String body = response.body();
Наведите, чтобы увидеть современный ➜
JDK 11+ →
I/O Начинающий

Path.of() factory

Java 8
Path path = Paths.get("src", "main",
    "java", "App.java");
Java 11+
var path = Path.of("src", "main",
    "java", "App.java");
Наведите, чтобы увидеть современный ➜
JDK 11+ →
I/O Начинающий

Reading files

Java 8
StringBuilder sb = new StringBuilder();
try (BufferedReader br =
    new BufferedReader(
        new FileReader("data.txt"))) {
    String line;
    while ((line = br.readLine()) != null)
        sb.append(line).append("\n");
}
String content = sb.toString();
Java 11+
String content =
    Files.readString(Path.of("data.txt"));
Наведите, чтобы увидеть современный ➜
JDK 11+ →