Что такое REST

1️⃣ Как кратко ответить

REST (Representational State Transfer) — это архитектурный стиль для создания веб-сервисов, который использует стандартные HTTP методы (GET, POST, PUT, DELETE) для взаимодействия с ресурсами, представляемыми в виде URI. RESTful сервисы обеспечивают масштабируемость, простоту и независимость от платформы.

2️⃣ Подробное объяснение темы

REST, или Representational State Transfer, — это архитектурный стиль, который определяет набор ограничений и принципов для создания веб-сервисов. Он был предложен Роем Филдингом в 2000 году в его докторской диссертации. REST не является стандартом или протоколом, а скорее набором рекомендаций для проектирования сетевых приложений.

Основные принципы REST

1. Клиент-серверная архитектура: Клиенты и серверы должны быть независимыми. Клиент не должен знать о внутренней структуре сервера, и наоборот. Это позволяет развивать клиентскую и серверную части независимо друг от друга.

2. Отсутствие состояния (Stateless): Каждый запрос от клиента к серверу должен содержать всю информацию, необходимую для обработки запроса. Сервер не должен хранить никакой информации о состоянии клиента между запросами.

3. Кэширование: Ответы от сервера должны быть явно помечены как кэшируемые или некэшируемые. Это позволяет клиентам повторно использовать ранее полученные ответы, что снижает нагрузку на сервер и улучшает производительность.

4. Единообразие интерфейса: RESTful сервисы должны иметь единообразный интерфейс, что упрощает взаимодействие между компонентами. Это достигается через:

   • Идентификацию ресурсов (обычно через URI).
   • Манипуляцию ресурсами через представления (использование стандартных HTTP методов).
   • Самоописывающие сообщения (каждое сообщение должно содержать всю необходимую информацию для его обработки).
   • Гипермедиа как движущая сила приложения (HATEOAS).

5. Слои: Архитектура может быть многослойной, что позволяет использовать промежуточные серверы для кэширования, балансировки нагрузки и других задач.

6. Код по требованию (опционально): Сервер может передавать исполняемый код клиенту для расширения его функциональности.

Пример RESTful взаимодействия

Рассмотрим пример RESTful взаимодействия с ресурсом "пользователь" на сервере.

• GET /users: Получить список всех пользователей.
• GET /users/{id}: Получить информацию о пользователе с определенным идентификатором.
• POST /users: Создать нового пользователя. Данные пользователя передаются в теле запроса.
• PUT /users/{id}: Обновить информацию о пользователе с определенным идентификатором. Новые данные передаются в теле запроса.
• DELETE /users/{id}: Удалить пользователя с определенным идентификатором.

Пример кода

import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;
​
public class RestClient {
​
    public static void main(String[] args) {
        try {
            // Создаем URL для запроса к RESTful сервису
            URL url = new URL("http://example.com/api/users/1");
​
            // Открываем соединение
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();
​
            // Устанавливаем метод запроса GET
            connection.setRequestMethod("GET");
​
            // Получаем код ответа от сервера
            int responseCode = connection.getResponseCode();
​
            // Проверяем, успешен ли запрос
            if (responseCode == HttpURLConnection.HTTP_OK) {
                // Читаем ответ от сервера
                BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuffer response = new StringBuffer();
​
                // Читаем строку за строкой
                while ((inputLine = in.readLine()) != null) {
                    response.append(inputLine);
                }
​
                // Закрываем поток
                in.close();
​
                // Выводим ответ
                System.out.println("Response: " + response.toString());
            } else {
                System.out.println("GET request not worked");
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

• URL url = new URL("http://example.com/api/users/1");: Создаем объект URL, который указывает на ресурс пользователя с идентификатором 1.
• HttpURLConnection connection = (HttpURLConnection) url.openConnection();: Открываем соединение с указанным URL.
• connection.setRequestMethod("GET");: Устанавливаем метод HTTP запроса как GET для получения данных.
• int responseCode = connection.getResponseCode();: Получаем код ответа от сервера, чтобы проверить успешность запроса.
• BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));: Создаем поток для чтения данных из ответа сервера.
• while ((inputLine = in.readLine()) != null) { response.append(inputLine); }: Читаем ответ построчно и добавляем его в объект StringBuffer.
• System.out.println("Response: " + response.toString());: Выводим полученный ответ на экран.

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