Что такое синхронное API (Synchronous API)?

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

Характеристика: Вызов → Ожидание → Результат → Продолжение работы.

Пример синхронного HTTP-запроса в Java с помощью HttpClient (Java 11+):

import java.net.http.*;
import java.net.URI;

public class SynchronousExample {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create("https://api.example.com/data"))
                .build();

        // СИНХРОННЫЙ ВЫЗОВ: поток блокируется здесь до получения ответа
        HttpResponse<String> response = client.send(
            request,
            HttpResponse.BodyHandlers.ofString()
        );

        // Этот код выполнится только ПОСЛЕ получения ответа
        System.out.println("Status: " + response.statusCode());
        System.out.println("Body: " + response.body());
    }
}

Преимущества синхронного подхода:

• Простота понимания и отладки: Поток выполнения линейный и последовательный.
• Естественная обработка ошибок: Используются стандартные try-catch блоки.
• Предсказуемость: Легко определить порядок выполнения операций.

Недостатки:

• Плохая масштабируемость ресурсов: Каждый заблокированный поток потребляет память и занимает ядро процессора впустую, ожидая ввода-вывода (I/O). Это ограничивает количество одновременных соединений.
• Снижение отзывчивости: В UI-приложениях или высоконагруженных серверах блокировка приводит к "зависаниям".

Когда использовать? Синхронные API хорошо подходят для:

1. Простых CLI-утилит или скриптов.
2. Операций, где задержка минимальна (работа с памятью, быстрые вычисления).
3. Этапов инициализации приложения.

Для эффективного обслуживания множества одновременных I/O-операций (сетевые запросы, работа с БД) предпочтительны асинхронные (неблокирующие) API или использование пулов потоков для изоляции блокирующих вызовов.