В разделе "4.8.24.2 Fixed Fields" есть несколько полей, но в том API, YAML которого у меня есть, их нет, но там есть куча других.
В разделах "4.8.24 Schema Object" и "4.8.24.1 Properties" есть несколько ссылок, я там полазал, но не нашел описания того, что я вижу в своём ямле.
У меня что-то такое:
Здравствуйте, Marty, Вы писали:
M>Я вообще в этой теме новичек. Подскажите, где чего внятное искать? M>ЗЫ Это вроде про REST — т.е. web. Если в другой раздел писать, то куда?
А ты с какой целью интересуешься?
В целом это чисто утилитарная вещь.
То есть, типичный сценарий использования — сгенерировать прокси для REST клиента, чтобы руками его не писать.
То чем давно был IDL (COM), потом wcf/soap...
То есть, зачем там какую-то схему копать-то?
Обычно есть софт, который за тебя это делает, если ты пользователь, а не член комитета W3C
Типа "Add Service...", Yes, Yes, Finish.
Здравствуйте, bnk, Вы писали:
M>>Я вообще в этой теме новичек. Подскажите, где чего внятное искать? M>>ЗЫ Это вроде про REST — т.е. web. Если в другой раздел писать, то куда?
bnk>А ты с какой целью интересуешься?
Хочу генератор написать. Для плюсиков нашел только для кути, мне оно не подходит. Да и вообще, все эти генераторы в основном на джаве, как-то надо было — полдня приседал, пока заработало
bnk>В целом это чисто утилитарная вещь. bnk>То есть, типичный сценарий использования — сгенерировать прокси для REST клиента, чтобы руками его не писать. bnk>То чем давно был IDL (COM), потом wcf/soap...
Я типа в курсе
bnk>То есть, зачем там какую-то схему копать-то? bnk>Обычно есть софт, который за тебя это делает, если ты пользователь, а не член комитета W3C
Ну, вот я что-то софта нормального не нашел. Ну и тут нюанс — мне не надо ничего по HTTP(S) передавать, и кучу все генерить соответственно, не надо, а вот как раз типы и их (де)сериализацию C++ <-> JSON — мне хочется получить удобные для себя, а такого мне ни один инструмент не даст
Здравствуйте, Marty, Вы писали:
bnk>>А ты с какой целью интересуешься?
M>Хочу генератор написать. Для плюсиков нашел только для кути, мне оно не подходит.
Фига у тебя свободного времени
Что делают программисты, когда собираются вместе?
Пишут фреймворк!
bnk>>То есть, зачем там какую-то схему копать-то? bnk>>Обычно есть софт, который за тебя это делает, если ты пользователь, а не член комитета W3C
M>Ну, вот я что-то софта нормального не нашел. Ну и тут нюанс — мне не надо ничего по HTTP(S) передавать, и кучу все генерить соответственно, не надо, а вот как раз типы и их (де)сериализацию C++ <-> JSON — мне хочется получить удобные для себя, а такого мне ни один инструмент не даст
Для C++ у меня к сожалению нет идей. Я использовал тот самый swagger-codegen на жаве (openapi-generator).
Там вообще-то все на шаблонах, которые можно переписать по своему усмотрению (и это достаточно просто) https://openapi-generator.tech/docs/templating/
Здравствуйте, bnk, Вы писали:
M>>Хочу генератор написать. Для плюсиков нашел только для кути, мне оно не подходит.
bnk>Фига у тебя свободного времени bnk>
bnk>Что делают программисты, когда собираются вместе?
bnk>Пишут фреймворк!
Да чего там писать-то?
bnk>Для C++ у меня к сожалению нет идей. Я использовал тот самый swagger-codegen на жаве (openapi-generator).
Чота я посмотрел, по-моему, разобраться в этом будет гораздо дольше, чем самому накидать. Беглый взгляд показал, что там и на богомерзской джаве чего-то лабать придётся. А так, на православных плюсиках по-быстрому наколбашу
Здравствуйте, Marty, Вы писали:
M>Да чего там писать-то?
Да оно часто так кажется, пока не начнешь на самом деле писать
bnk>>https://openapi-generator.tech/docs/templating/
M>Чота я посмотрел, по-моему, разобраться в этом будет гораздо дольше, чем самому накидать. Беглый взгляд показал, что там и на богомерзской джаве чего-то лабать придётся. А так, на православных плюсиках по-быстрому наколбашу M>Но хотя в сорцы этого генератора глянуть можно
Не, там только шаблоны надо править, все делается из командной строки, капот открывать не обязательно (в исходники на жаве залазить не нужно)
Шаблоны там на mustache.
Здравствуйте, bnk, Вы писали:
bnk>Не, там только шаблоны надо править, все делается из командной строки, капот открывать не обязательно (в исходники на жаве залазить не нужно)
Здравствуйте, Marty, Вы писали:
M>Здравствуйте, bnk, Вы писали:
bnk>>Не, там только шаблоны надо править, все делается из командной строки, капот открывать не обязательно (в исходники на жаве залазить не нужно)
M>Это максимально просто?
Ну, типа, да
bnk>>Шаблоны там на mustache.
M>Ещё мусташ какой-то ковырять
Лучше день потерять зато потом за пять минут долететь
https://swagger.io/tools/
насчет с++ не знаю. интересовал C# F#.
если сервис нормальный, то проблем нет, а если типы сложные, то или генерация не проходит(банально названия файлов могут быть длинные)
или в рантайме (F# на rsdn api) падает.
но конечно лучше сначала попробовать сгенерить.
Здравствуйте, Marty, Вы писали:
M>Меня интересует раздел component/schemas — https://spec.openapis.org/oas/v3.1.0#schema-object M>В разделе "4.8.24.2 Fixed Fields" есть несколько полей, но в том API, YAML которого у меня есть, их нет, но там есть куча других.
"Элементов базового словаря" (keywords from base vocabulary). Эта спецификация писалась марсианами, поэтому нужно уметь немного читать по марсиански.
M>В разделах "4.8.24 Schema Object" и "4.8.24.1 Properties" есть несколько ссылок, я там полазал, но не нашел описания того, что я вижу в своём ямле.
Ну... Вот вам properties, required, type, default.
M>Я вообще в этой теме новичек. Подскажите, где чего внятное искать?
По схеме можно немного полистать официальный учебник. Там, конечно, не много. Но общее впечатление позволяет составить.
А накидайте мне плс ссылок на какие-нибудь OpenAPI спеки, которые вы видели/использовали.
У меня есть сейчас спека от тинькова по ихнему АПИ, я с ней разбираюсь, но там скорее всего не все возможности использованы.
Я пока решил пойти таким путем (чтобы разобраться, что там вообще бывает/может быть):
Гружу схему в JSON
Десериализую в свои структуры
Сериализую обратно в JSON
Делаю json-diff между тем, что на входе, и тем, что я сериализовал из своих структур
Смотрю по дифу, какие поля не обработал — дописываю и по новой
Чтобы получше разобраться, нужно больше всяких разных OpenAPI спек
Здравствуйте, maxkar, Вы писали:
M>Ну... Вот вам properties, required, type, default.
M>>Я вообще в этой теме новичек. Подскажите, где чего внятное искать?
M>По схеме можно немного полистать официальный учебник. Там, конечно, не много. Но общее впечатление позволяет составить.
