README-extend.md · OSCHINA-MIRROR/mirrors_Tencent-APIJSON

Функции

Один JSON (транзакция) поддерживает одновременно добавление, изменение, удаление, запрос и псевдонимы

https://github.com/Tencent/APIJSON/issues/468

Использование

JSON поддерживает различные способы определения метода:

Первый способ:

"@post", "@put", "@delete", "@head", "@get", "@gets", "@head", "@heads"

"@post": ["Moment","Comment[]"] , значение является форматом массива, каждое значение = ключ

Необходимо гарантировать уникальность каждого ключа:

ключ = Moment;
ключ= Moment[] будет считаться тем же ключом. Используйте псевдонимы для различения, формат псевдонима: Sys_user_role:sur xxx таблица: псевдоним.

{
   "@post": ["Moment", "Comment:cArray[]", "User:u"], // распределение по POST-запросу соответствующего анализа обработки
   "Moment": {
     // TODO другие поля
   },
   "Comment:cArray[]": [
      {
        // TODO другие поля
      }
   ],
   "@get": ["User"], // распределение GET-запроса соответствующей обработки анализа
   "User:u": {
     // TODO другие поля
   },
   "Privacy": { // обработка по умолчанию в соответствии с URL (/get, /post и т.д.)
     // TODO другие поля
   }
}

Для тех, кто не объявляет явный метод операции, используйте URL (/get, /post и т. д.) для обработки по умолчанию.

Второй способ:

Определение объекта "@method": "GET", значение в верхнем регистре.

{
    "sql@": {
        "@method": "GET",
        "with": true,
        "from": "Sys_role",
        "Sys_role": {
          "@column": "id",
          "role_name": "Роль 1"
        }
    },
    "Sys_user_role:sur[]": {
        "@method": "GET",
        "Sys_user_role": {
            "role_id{}@": "sql"
        }
    },
    "Sys_role_permission:srp[]": {
        "@method": "GET",
        "Sys_role_permission": {
            "role_id{}@": "sql"
        }
    },
    "@explain": true
}

Порядок разбора

Метод объекта.
"@post", "@put", "@delete".
Для тех, кто не объявил явный метод операции, используется обработка по умолчанию, соответствующая URL (/get, /post и т. д.).

Правила автоматического создания тегов

{ "xxx:aa":{ "@tag": "" }}

Правила генерации:

@tag существует, tag = @tag.
@tag не существует:
- Существует псевдоним: key = объект: tag = key удалить псевдоним; key = массив: tag = key удалить псевдоним + [].
- Псевдоним не существует: tag = ключ; tag = ключ + [].

Предложение

Один JSON содержит различные методы операций, URL-метод использует /post, /put.
Значение является массивом JSON, рекомендуется использовать конфигурацию "@post", если она не настроена, выполнить шаг 3.

Таблица запросов

Это только мои настройки для справки, которые будут использоваться в будущем тестировании:

Однократное добавление:
POST   User_address     {"MUST":"addr","UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}, "REFUSE": "id"}
Пакетное добавление:
POST User_address[]  {"User_address[]": [{"MUST":"addr","REFUSE": "id"}], "UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}}
Однократное изменение:
PUT User_address   {"User_address":{ "MUST":"id","REFUSE": "userId", "UPDATE": {"@role": "OWNER,ADMIN","childFunTest-()": "childFunTest(addr)"}} }
Пакетное изменение:
PUT User_address[]  {"User_address[]": [{"MUST": "id","REFUSE": "userId"}], "UPDATE": {"@role": "OWNER,ADMIN"}}
Удаление:
DELETE User_address   {"User_address":{ "MUST":"id{}","REFUSE": "!", "INSERT": {"@role": "OWNER,ADMIN"}} }

Псевдонимы

Формат:

Sys_user_role: сур xxx таблица: псевдоним

Комментарий: cArray []

Реализация идеи

В то время я ссылался на пример автора: процесс регистрации. Я увидел, что можно обойти проверку, объединив несколько операторов JSON в один, чтобы выполнить пакетную обработку. Поэтому я подумал о том, как реализовать один JSON, который поддерживает различные методы работы и транзакции.

Анализируя исходный код, я познакомился с процессом проверки, процессом анализа и выполнения JSON, процессом генерации SQL-операторов анализа JSON и некоторыми правилами совместимости и проверки.

После обсуждения с автором я очень благодарен автору за предоставленные решения и идеи. Постепенно я понял принципы проектирования и структуру фреймворка apijson.

Один JSON (транзакции) поддерживает добавление, изменение, удаление, запросы и псевдонимы. Идея реализации заключается в следующем:

Модуль проверки:

Анализ JSON для объектов, временных переменных, подзапросов, псевдонимов и тегов.

Добавьте метод к свойствам объекта JSON.

"Sys_role": {
        "@method": "PUT",
        "id": "6aedce0d-2a29-4fbe-aeed-0ba935ca6b41",
        "id{}@": "sql",
        "role_code": "code-subrange-4",
        "role_name": "роль-поддиапазон-4"
    }

Анализ объекта:

Используйте атрибут @method объекта, чтобы заменить метод Parser.

Поддержка транзакций:

Дальнейшая оптимизация

Отдельно определите URL-метод и выполните разные процессы в зависимости от метода.

Разделите его с существующим методом, чтобы избежать двусмысленности.

Самый внешний слой добавляет параметр «транзакция»: true, чтобы указать запуск транзакции. В настоящее время это URL-адреса put и post для управления запуском транзакции, а также при фиксации AbstractParser onCommit определяет transactionIsolation (4: запуск транзакции, 0: запрос без транзакции).

Более подробную информацию см. в: https://github.com/Tencent/APIJSON/issues/468.

Завершите «@Explain».

Если нет плана выполнения, верните SQL-оператор. Вы можете увидеть JSON-оператор, выполняемый в каждой строке SQL в ответе, чтобы облегчить поиск и устранение неисправностей.

Поддержка @version.

Определите различные сценарии добавления, изменения, удаления и других правил выполнения. Пожалуйста, разделите их по версии.

Таблица запросов основана на тегах, методах и версиях для обеспечения уникальности.

Функция предварительного выполнения.

Функция предварительного выполнения может добавлять операторы JSON к

... mysql8 with-as表达式

mysql8 с выражением with-as

Предварительные условия:

версия mysql: 8+;
mysql-connector-java: 8.0.31 — версия поддерживает with-as;
druid: 1.2.15 — версия поддерживает with-as.

Необходимо удалить конфигурацию druid wall.

Тестовый случай: запрос одной ссылки range ref

// Тестирование mysql8 with as выражения
// Таблица пользователей
// Таблица ролей пользователей
// Ролевая таблица
// Пример 1: одна ссылка range ref
{
    "sql@": {
        "@method": "GET",
        "with": true,
        *from: «Sys_role»,*
        "Sys_role": {
          "@column": "id",
          "role_name": "Роль 1"
        }
    },
    "Sys_user_role:sur[]": {
        "@method": "GET",
        "Sys_user_role": {
            "role_id{}@": "sql"
        }
    },
    "Sys_role_permission:srp[]": {
        "@method": "GET",
        "Sys_role_permission": {
            "role_id{}@": "sql"
        }
    },
    "@explain": true
}  

// Второй способ написания
{
    "@get": ["sql@","Sys_user_role:sur[]","Sys_role_permission:srp[]"],
    "sql@": {
        "with": true,
        "from": "Sys_role",
        "Sys_role": {
          "@column": "id",
          "role_name": "Роль 1"
        }
    },
    "Sys_user_role:sur[]": {
        "Sys_user_role": {
            "role_id{}@": "sql"
        }
    },
    "Sys_role_permission:srp[]": {
        "Sys_role_permission": {
            "role_id{}@": "sql"
        }
    },
    "@explain": true
}

Результат выполнения в mysql8: