Приветствую, Master Lid. У нас проект древний и разработка не может подключить свагер, причёсывать код надо много + рефакторинг. Посоветуйте как аналитику описывать api вручную, создавать спецификацию на основе имеющихся rest апи и новых. Сами сервисы у нас на источнике - приложение написанное на питоне, а мы с другого приложения обращаемся и обрабатываем ответы, у нас c#. На источнике на реализацию сервисов ставят задачи наши аналитики. Не так давно на проекте, порядок выстроить хочу. Хотелось бы конечно с примерами, пожалуйста.
Когда свагера еще не было, мы описывали rest api вручную, на движке вики. Не знаю, какой пример вам привести. Просто посмотрите, какую информацию выводит свагер или редок, и делайте то же самое вручную. По каждому эндпойнту в доке должна быть описана следующая информация: - метод (GET, POST, PUT, DELETE) - URI эндпойнта (параметры в фигурных скобках указываются) - описание входных параметров (что, зачем, почему) - если запрос методом POST или PUT, то могут быть входные данные (указать, что за данные, в каком формате: JSON, XML, x-www-form-urlencoded и т.п.) - возможные HTTP-коды ответов, что каждый означает (200, 401, 500 и т.д.) - если есть выходные данные, то указать какие (всё то же самое: формат, что выводится и т.д.) - текстовое описание, что делает этот эндпойнт (например, выводит список пользователей, удаляет пользователя и т.п.) Как-то так.
А это принципиально, в каком редакторе демонстрируется исходный код? Если бы я использовал IDE, что-нибудь существенно поменялось бы? В ролике речь не о том, как удобнее всего писать исходный код. Если нравится какая-то определённая IDE -- используйте её. По-моему, это очевидно.
@@MasterLid Всё верно. Вопрос был не о принципах. Они здесь не при чём. Интересно узнать от профессионала что-то новое. Увидел необычную IDE для Java. А в связи с тем, что JetBrains вроде, как собирается уходить из России(в известном смысле). То подумал, что возможно это новые веяния, как вариант замены. В любом случае интересно узнать мнение действующего опытного, знающего человека о сравнении этих двух IDE, для использования в работе.
Для меня это лишь вопрос привычки -- использовать редактор с подсветкой синтаксиса и собирать проект в мавене или грейдле. Кстати, посмотрите ролик по мавену и грейдлу, я там подробно объясняю, почему нужно уметь ими пользоваться, а не полагаться на IDE. Ну и по поводу альтернативы для JetBrains. В VS Code есть куча плагинов для Java. По-моему, даже собирать можно прямо из редактора. Поэтому если нужны всякие дополнительные плюшки, типа автозаполнения, то они есть. Мне не нужны, соответственно не ставил.
@@MasterLid Спасибо за ответ. Теперь обязательно попробую VS. Посмотрю про майвен и гредл. Хотя майвеном много пользовался. Поделитесь пожалуйста ещё вашим мнением по поводу, можно ли полноценно кодить в Vim (Neovim)? Можно ли совсем отказаться от навароченных, но тяжёлых IDE и перейти в простой и неказистый, но лёгкий Vim?
Зачем вам Vim? Просто как личное персональное достижение? Не надо трогать это старое г-но мамонта. В плане лёгкости VS Code очень хорош. До него пользовался Sublime, а еще раньше EditPlus. VS Code пока фаворит.
Добрый день. Я посоветоваться хотел по работе, занимаемся сборкой отчётности из облачной бухгалтерии передаём данные через rest api в облачные своды. В общем суммы по дебета кредита рассаживаем по ячейкам. Разработка пишет на визуал студио генераторы и на выходе json файлы, которые прикладываются в метаописания отчётных форм. Json так то простой, но есть функции разные обработки м задействованны разные сервисы и параметры. Мечтаем чтобы аналитики начали сами формировать json файлы. Разработка предлагает написать дизайнер файлов импорта. Вот как раз по этому вопрос, это ведь не маленькая работа, может уже есть готовые редакторы конструкторы для написания json позволяющие выбирать кючи и параметры заранее заложенные из справочника. Ну например выбрать тот или иной бухгалтерский счёт из саравочника. Или параметр debet. Чтоб был выбор из справочника именно debet а не debIt. Ну как то так. Есть ли программы такие, порекомендовать можете?
в продолжении редактор json нужен, для заполнения этого jsona надо вытаскивать значения из заранее приготовленного справочника, в любом формате его можно сделать, а не из бд.
С визуальными редакторами JSON я не работал. Поиск в гугле по строке "json visual editor" выдаёт несколько полезных ссылок. Как вариант, чтобы не писать самостоятельно весь редактор, можно готовить данные в Excel или Access, а затем преобразовывать в нужный JSON-формат. Для Excel, наверное, нужна библиотека дополнительная, чтобы читать его. А из Access можно выдергивать данные напрямую, через ODBC, например.
Спасибо за хорошую оценку! А мало лайков, наверное, потому, что я не занимаюсь раскруткой канала, не покупаю подписчиков, просмотры, лайки и т.п. Если видео понравилось или показалось полезным, буду благодарен, если поделитесь им в соцсетях, сделаете репост в мессенджерах и всё такое прочее. : )
Приветствую, Master Lid. У нас проект древний и разработка не может подключить свагер, причёсывать код надо много + рефакторинг. Посоветуйте как аналитику описывать api вручную, создавать спецификацию на основе имеющихся rest апи и новых.
Сами сервисы у нас на источнике - приложение написанное на питоне, а мы с другого приложения обращаемся и обрабатываем ответы, у нас c#. На источнике на реализацию сервисов ставят задачи наши аналитики. Не так давно на проекте, порядок выстроить хочу. Хотелось бы конечно с примерами, пожалуйста.
Когда свагера еще не было, мы описывали rest api вручную, на движке вики.
Не знаю, какой пример вам привести. Просто посмотрите, какую информацию выводит свагер или редок, и делайте то же самое вручную.
По каждому эндпойнту в доке должна быть описана следующая информация:
- метод (GET, POST, PUT, DELETE)
- URI эндпойнта (параметры в фигурных скобках указываются)
- описание входных параметров (что, зачем, почему)
- если запрос методом POST или PUT, то могут быть входные данные (указать, что за данные, в каком формате: JSON, XML, x-www-form-urlencoded и т.п.)
- возможные HTTP-коды ответов, что каждый означает (200, 401, 500 и т.д.)
- если есть выходные данные, то указать какие (всё то же самое: формат, что выводится и т.д.)
- текстовое описание, что делает этот эндпойнт (например, выводит список пользователей, удаляет пользователя и т.п.)
Как-то так.
@@MasterLid Спасибо большое!
Отличная серия роликов. Никакой воды, все четко и подробно рассказано ... Спасибо.
И вам спасибо за положительную оценку! Рад поделиться опытом.
С Новым Годом! : )
Гля дядька на пафосе))) Шутка. Приятный образ и всё по делу. Подписочку оформил ;)
Крутой дядя! Мне нравится такая подача.
Все по делу!
Спасибо
Лайк + подписка !!! Спасибо @Master Lid.
Всегда пожалуйста! Добро пожаловать на канал! 😎
Спасибо за видео.
А почему для Java выбрана Visual Studio? Очень интересно узнать причины?
А это принципиально, в каком редакторе демонстрируется исходный код?
Если бы я использовал IDE, что-нибудь существенно поменялось бы?
В ролике речь не о том, как удобнее всего писать исходный код.
Если нравится какая-то определённая IDE -- используйте её. По-моему, это очевидно.
@@MasterLid Всё верно. Вопрос был не о принципах. Они здесь не при чём. Интересно узнать от профессионала что-то новое. Увидел необычную IDE для Java. А в связи с тем, что JetBrains вроде, как собирается уходить из России(в известном смысле). То подумал, что возможно это новые веяния, как вариант замены. В любом случае интересно узнать мнение действующего опытного, знающего человека о сравнении этих двух IDE, для использования в работе.
Для меня это лишь вопрос привычки -- использовать редактор с подсветкой синтаксиса и собирать проект в мавене или грейдле. Кстати, посмотрите ролик по мавену и грейдлу, я там подробно объясняю, почему нужно уметь ими пользоваться, а не полагаться на IDE.
Ну и по поводу альтернативы для JetBrains. В VS Code есть куча плагинов для Java. По-моему, даже собирать можно прямо из редактора. Поэтому если нужны всякие дополнительные плюшки, типа автозаполнения, то они есть. Мне не нужны, соответственно не ставил.
@@MasterLid Спасибо за ответ. Теперь обязательно попробую VS. Посмотрю про майвен и гредл. Хотя майвеном много пользовался. Поделитесь пожалуйста ещё вашим мнением по поводу, можно ли полноценно кодить в Vim (Neovim)? Можно ли совсем отказаться от навароченных, но тяжёлых IDE и перейти в простой и неказистый, но лёгкий Vim?
Зачем вам Vim? Просто как личное персональное достижение? Не надо трогать это старое г-но мамонта.
В плане лёгкости VS Code очень хорош. До него пользовался Sublime, а еще раньше EditPlus. VS Code пока фаворит.
как сгенерировать клиента на основе описания реста?
Добрый день. Я посоветоваться хотел по работе, занимаемся сборкой отчётности из облачной бухгалтерии передаём данные через rest api в облачные своды. В общем суммы по дебета кредита рассаживаем по ячейкам.
Разработка пишет на визуал студио генераторы и на выходе json файлы, которые прикладываются в метаописания отчётных форм.
Json так то простой, но есть функции разные обработки м задействованны разные сервисы и параметры. Мечтаем чтобы аналитики начали сами формировать json файлы. Разработка предлагает написать дизайнер файлов импорта. Вот как раз по этому вопрос, это ведь не маленькая работа, может уже есть готовые редакторы конструкторы для написания json позволяющие выбирать кючи и параметры заранее заложенные из справочника. Ну например выбрать тот или иной бухгалтерский счёт из саравочника. Или параметр debet.
Чтоб был выбор из справочника именно debet а не debIt. Ну как то так.
Есть ли программы такие, порекомендовать можете?
в продолжении
редактор json нужен, для заполнения этого jsona надо вытаскивать значения из заранее приготовленного справочника, в любом формате его можно сделать, а не из бд.
С визуальными редакторами JSON я не работал. Поиск в гугле по строке "json visual editor" выдаёт несколько полезных ссылок. Как вариант, чтобы не писать самостоятельно весь редактор, можно готовить данные в Excel или Access, а затем преобразовывать в нужный JSON-формат. Для Excel, наверное, нужна библиотека дополнительная, чтобы читать его. А из Access можно выдергивать данные напрямую, через ODBC, например.
@@MasterLid спасибо
Top
умница автор, почему только мало лайков непонятно
Спасибо за хорошую оценку!
А мало лайков, наверное, потому, что я не занимаюсь раскруткой канала, не покупаю подписчиков, просмотры, лайки и т.п. Если видео понравилось или показалось полезным, буду благодарен, если поделитесь им в соцсетях, сделаете репост в мессенджерах и всё такое прочее. : )