URL.openConnection: примеры (JAVA)

Примеры использования

Базовый пример без аргументов:

import java.net.*;
import java.io.*;

URL url = new URL("http://example.com");
URLConnection connection = url.openConnection();
connection.connect();
System.out.println("Content-Type: " + connection.getContentType());
System.out.println("Content-Length: " + connection.getContentLengthLong());

Content-Type: text/html; charset=UTF-8
Content-Length: 1256

Пример с явным указанием прокси:

Proxy proxy = new Proxy(Proxy.Type.HTTP,
    new InetSocketAddress("proxy.example.com", 8080));
URLConnection conn = url.openConnection(proxy);
conn.connect();

(соединение установлено через прокси, вывод зависит от ресурса)

Альтернативные функции в Java

Для работы с HTTP/HTTPS рекомендуется использовать HttpURLConnection – подкласс URLConnection, который добавляет методы setRequestMethod(), getResponseCode() и др. HttpsURLConnection расширяет возможности для защищенных соединений. С Java 11 доступен java.net.http.HttpClient, который предоставляет более современный API с поддержкой HTTP/2 и асинхронных запросов. Выбор между ними зависит от версии Java и требований к функциональности: для простых случаев подходит HttpURLConnection, а для сложных сценариев – HttpClient.

Аналоги в других языках программирования

PHP: функция file_get_contents() – простое чтение содержимого URL, но без детального управления соединением. Пример:

$content = file_get_contents('http://example.com');

JavaScript (браузер): fetch() возвращает Promise с объектом Response, поддерживает настройку заголовков и методов.

fetch('http://example.com')
  .then(response => response.text())
  .then(data => console.log(data));

Python: библиотека requests – высокоуровневый клиент.

import requests
response = requests.get('http://example.com')
print(response.text)

C#: класс WebClient (устарел) или HttpWebRequest.

using var client = new WebClient();
string html = client.DownloadString("http://example.com");

Lua: библиотека socket.http.

local http = require("socket.http")
local body, code = http.request("http://example.com")

Go: пакет net/http.

resp, err := http.Get("http://example.com")
// ...

Kotlin: аналогично Java, но часто используют khttp или ktor. Пример с URL:

val url = URL("http://example.com")
val connection = url.openConnection()

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

Типичные ошибки при использовании

MalformedURLException – неверный формат URL (например, htp://example.com).

URL url = new URL("htp://example.com");
url.openConnection(); // вызовет исключение

Exception in thread "main" java.net.MalformedURLException: unknown protocol: htp

ConnectException – таймаут соединения или недоступность сервера.

URL url = new URL("http://nonexistent.domain");
URLConnection conn = url.openConnection();
conn.setConnectTimeout(1000);
conn.connect();

java.net.ConnectException: Connection timed out: connect

FileNotFoundException – HTTP 404 для HTTP-соединений, когда ресурс не найден (только после попытки чтения).

SecurityException – политика безопасности запрещает соединение (например, в апплетах).

Изменения в последних версиях Java

Метод URL.openConnection() не претерпел существенных изменений с момента появления Java 1.0. В Java 11 был представлен новый модуль java.net.http с классом HttpClient, который стал рекомендованной альтернативой. Однако старый API остался для обратной совместимости. В Java 9 модульная система не повлияла на сигнатуру метода. В Java 8 и более ранних версиях поведение метода не менялось.

Расширенные примеры использования

1. Настройка таймаутов и заголовков

URL url = new URL("http://example.com");
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
conn.setConnectTimeout(5000);
conn.setReadTimeout(5000);
conn.setRequestProperty("User-Agent", "Mozilla/5.0");
conn.setRequestProperty("Accept", "text/html");
int responseCode = conn.getResponseCode();
if (responseCode == 200) {
    BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
    String inputLine;
    StringBuilder content = new StringBuilder();
    while ((inputLine = in.readLine()) != null) {
        content.append(inputLine);
    }
    in.close();
    System.out.println(content.toString());
} else {
    System.out.println("Ошибка: " + responseCode);
}

(вывод HTML-содержимого страницы или код ошибки)

2. Использование аутентификации через Authenticator

Authenticator.setDefault(new Authenticator() {
    protected PasswordAuthentication getPasswordAuthentication() {
        return new PasswordAuthentication("user", "pass".toCharArray());
    }
});
URL url = new URL("http://example.com/protected");
URLConnection conn = url.openConnection();
BufferedReader in = new BufferedReader(new InputStreamReader(conn.getInputStream()));
String line;
while ((line = in.readLine()) != null) {
    System.out.println(line);
}

(содержимое защищенного ресурса)

3. Работа с cookie

CookieManager manager = new CookieManager();
CookieHandler.setDefault(manager);
URL url = new URL("http://example.com");
URLConnection conn = url.openConnection();
conn.connect();
// последующие запросы будут использовать те же cookie

(cookie устанавливаются и отправляются автоматически)

4. Чтение содержимого из потока с учетом кодировки

URLConnection conn = new URL("http://example.com").openConnection();
String encoding = conn.getContentEncoding();
if (encoding == null) encoding = "UTF-8";
BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), encoding));
String line;
while ((line = reader.readLine()) != null) {
    System.out.println(line);
}

(содержимое с правильной кодировкой)

5. Отключение кэширования

URLConnection conn = new URL("http://example.com").openConnection();
conn.setUseCaches(false);
Object obj = conn.getContent(); // гарантированно свежие данные

(объект, представляющий содержимое URL)