Что такое REST?

REST (Representational State Transfer) был введен и определен в 2000 году Роем Филдингом (Roy Fielding) в его докторской диссертации. REST - это архитектурный стиль для проектирования распределенных систем. Это не стандарт, а набор ограничений, таких как отсутствие состояния, наличие отношений клиент/сервер и единый интерфейс. REST не связан строго с HTTP, но чаще всего ассоцируется с ним.

Принципы REST

  • Ресурсы (Resources) предоставляют понятные URI структуры каталогов.
  • Представления (Representations) передают JSON или XML для представления объектов данных и атрибутов.
  • Сообщения (Messages) явно используют методы HTTP (например, GET, POST, PUT и DELETE).
  • Взаимодейтсвия без состояния (Stateless interactions) не сохраняют клиентский контекст на сервере между запросами. Зависимости состояния ограничивают масштабируемость. Клиент хранит состояние сеанса.

HTTP методы

Используйте HTTP методы для сопоставления операций CRUD (создание, получение, обновление, удаление) с HTTP запросами.

GET

Получить информацию. GET-запросы должны быть безопасными и идемпотентными, то есть независимо от того, сколько раз они повторяются с одинаковыми параметрами, результаты одинаковы. Они могут иметь побочные эффекты, но пользователь не ожидает их, поэтому они не могут быть критическими для работы системы. Запросы также могут быть частичными или условными.

Получить адрес с идентификатором 1:

GET /addresses/1

POST

Запрос, чтобы ресурс в URI что-то сделал с предоставленным объектом. Часто POST используется для создания новой сущности, но также может использоваться для обновления сущности.

Создать новый адрес:

POST /addresses

PUT

Сохранить объект в URI. PUT может создать новый объект или обновить существующий. Запрос PUT идемпотентен. Идемпотентность - это основное различие между ожиданиями PUT и POST-запроса.

Изменить адрес с идентификатором 1:

PUT /addresses/1

Примечание. PUT заменяет существующую сущность. Если предоставляется только подмножество элементов данных, остальные будут заменены пустыми или null.

PATCH

Обновить только указанные поля объекта в URI. Запрос PATCH не является ни безопасным, ни идемпотентным (RFC 5789). Это связано с тем, что операция PATCH не может гарантировать, что весь ресурс обновлен.

PATCH /addresses/1

DELETE

Запросить удаление ресурса; тем не менее, ресурс не должен быть удален немедленно. Это может быть асинхронный или длительный запрос.

Удалить адрес с идентификатором 1:

DELETE /addresses/1

HTTP коды состояния

Коды состояния указывают результат HTTP-запроса.

  • 1XX- информационный
  • 2XX- успех
  • 3XX- перенаправление
  • 4XX- ошибка клиента
  • 5XX- ошибка сервера

Типы носителей

HTTP заголовки Accept и Content-Type можно использовать для описания содержимого, отправляемого или запрашиваемого в HTTP запросе. Клиент может установить для Accept значение application/json, если он запрашивает ответ в JSON. И наоборот, при отправке данных установка для Content-Type значения application/xml сообщает клиенту, что данные, отправляемые в запросе, представляют собой XML.

Комментарии

Отправить комментарий

Популярные сообщения из этого блога

Методы класса Object в Java

Изображение
Класс Object является корнем иерархии классов. У каждого класса есть Object как суперкласс. Все объекты, включая массивы, реализуют методы этого класса. Методы класса Object Метод getClass() public final Class getClass() Возвращает класс времени исполнения (runtime class) этого Object. Возвращенный объект Class - это объект, который заблокирован статическими синхронизированными методами представленного класса. Фактический тип результата - Class<? extends |X|> где |X| заменяется статическим типом выражения, для которого вызывается getClass. Например, в этом фрагменте кода не требуется приведение: Number n = 0; Class c = n.getClass(); Метод getClass() возвращает: Объект Class, представляющий класс времени исполнения (runtime class) этого объекта. Метод hashCode public int hashCode() Возвращает значение хэш-кода для объекта. Этот метод поддерживается для использования хэш-таблиц, таких как те, что предоставляются HashMap. Основной контракт метода hashCo
Далее...

Как получить текущий timestamp в Java

Изображение
Чтобы получить текущий timestamp в Java : package main; import java.sql.Timestamp; public class Main { public static void main(String[] args){ Timestamp timestamp = new Timestamp(System.currentTimeMillis()); System.out.println(timestamp); } } Вывод: 2019-10-03 10:09:21.61 Вот еще два более подробных примера как получить текущий timestamp в Java: 1. java.sql.Timestamp Есть два метода получить текущий java.sql.Timestamp package main; import java.sql.Timestamp; import java.text.SimpleDateFormat; import java.util.Date; public class Main { private static final SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy.MM.dd.HH.mm.ss"); public static void main(String[] args) { // Метод 1 Timestamp timestamp = new Timestamp(System.currentTimeMillis()); System.out.println(timestamp); // Метод 2 - через Date Date date = new Date(); System.out.println(new Timestamp(date.getTime()
Далее...

Основные опции JVM для повышения производительности и отладки

Изображение
Если вы являетесь Java-разработчиком или администратором Java приложения, вам поможет в работе знание того, что означают опции JVM, а также их важность и как они влияют на ваше приложение. Обзор параметров JVM Если говорить о параметрах JVM, то есть три типа параметров, которые вы можете включить в JVM: стандартные, нестандартные и расширенные параметры. Если вы используете расширенную опцию, вы всегда используете опцию с -XX. Точно так же, если вы применяете нестандартную опцию, вы используете -X. Стандартные опции ничего не добавляют к опции. Какие параметры JVM используются вашим приложением? Если приложение работает в Linux, вы можете использовать ps -ef | grep java для идентификации процесса Java и просмотра параметров JVM, напечатанных как аргументы процесса. Если в системе выполняется более одного Java-процесса, вам может потребоваться использовать ключевое слово, уникальное для вашего Java-приложения. Если ваш аргумент слишком длинный, попробуйте использовать ps
Далее...