Сервисный технологический стек

Интерпретация маршрутов

1. rest/** — префикс для бэкенд-маршрутов;
2. app/** — префикс для предоставления фронтенд-маршрутов;
3. tool/** — маршрут без аутентификации;
4. rest/common/** — только для инструментов проверки подлинности.

Разделение сервисов

# yf-gateway — входной шлюз
# yf-basics — комплексный сервис
# yf-model — jar сущности
# yf-common — jar инструментальных зависимостей
# yf-oauth — единый сервис аутентификации и авторизации
# yf-upm-service — родительский pom для бизнес-сервисов
# yf-basics — базовый сервис

@Проект предназначен только для обучения@

Все интерфейсы на стороне сервера используют стиль RESTful, мобильные и веб-интерфейсы используют один и тот же набор интерфейсов. Чтобы компенсировать отсутствие состояния в RESTful и отсутствие сеансов на мобильных устройствах, был внедрён механизм токенов. Основная функция сеанса — хранить информацию о сеансе, а токен используется только для аутентификации пользователя. Поэтому использование токенов на мобильных устройствах проще и безопаснее, чем использование сеансов, и это также соответствует определению RESTful без сохранения состояния.

В настоящее время поддерживаются четыре типа вызовов методов интерфейса: GET, POST, PUT и DELETE. Поскольку в настоящее время процессор не поддерживает PUT и DELETE, если клиент не поддерживает эти методы, используйте POST для вызова интерфейса и передайте параметр _method=PUT/DELETE в качестве дополнения.

Для PUT, POST и DELTE передаваемые параметры должны иметь тип содержимого Content-Type: application/x-www-form-urlencoded.

Описание интерфейса

Все серверные интерфейсы используют стиль RESTful. Мобильные и веб-устройства используют один и тот же набор интерфейсов, чтобы компенсировать отсутствие сохранения состояния в RESTful и сеансов на мобильных устройствах. Для этого был внедрён токен-механизм. Сеанс хранит информацию о сеансе. Токен используется только для идентификации пользователя. Использование токенов на мобильных устройствах более простое и безопасное, чем сеансов, и соответствует определению RESTful без состояния.

Поддерживаются четыре метода вызова интерфейса: GET, POST, PUT и DELETE. Процессор в настоящее время не поддерживает методы PUT и DELETE. Если клиент не поддерживает их, используйте метод POST для вызова интерфейса, передав параметр _method = PUT / DELETE в качестве дополнения.

Тип содержимого для параметров PUT должен быть Content-Type: application/x-www-form-urlencoded.

Возврат интерфейса

Обычно, если запрос достигает системы, возвращается HTTP Status 200. Если запрос не достигает системы, то возвращается стандартное состояние браузера. Отсутствие результата также считается успешным.

Пример возвращаемого значения: { "code": "200", "msg": "success", "data": {xxx：xxx,xxx} }

Объяснение возвращаемых значений

Таблица сопоставления кодов состояния бизнеса | Код состояния | Описание | |-1 | Неизвестная причина или определение исключения | |200 | Успех бизнеса | |1000 | Параметр не существует | |3000 | Ошибка аутентификации | |4000 | Недействительный параметр | |404 | Ресурс не найден |