thx

чем лучше декомпилировать java жар

Fernflower / CFR

https://habr.com/post/358072/

С 1с это жестко и плиторно

Fernflower / CFR

это я слышал. Доктор, скойжыте, а если шарп тест девелопыря зостовляют декомпилировать AUT и менять ее, то это ОК?

Народ, если я делаю: val stream = Files.lines(Paths.get("./file.txt"))

Мне после использования нужно stream.close() ?

stream в таком случае ни разу не стрим

Ну, он же ленивый, значит, чтение файла происходит по мере доступа к стриму, значит, файл остается открытым

а, тьфу, стримы из восьмёрки

см. javadoc, третий абзац

Есть какие-нибудь стандарты по написанию JavaDoc для REST API?

Суть такова: есть контроллер, имплементирующий несколько REST точек. Нужно написать JavaDoc, но хотелось бы узнать про наличие стандартов, по которым эта документация пишется. Гугл выдаёт информацию по спекам для различных утилит.

см. javadoc, третий абзац

thx

Есть какие-нибудь стандарты по написанию JavaDoc для REST API?

ну есть несколько подходов, spring rest docs — генерит доки с тестов и джавадоков

ну есть несколько подходов, spring rest docs — генерит доки с тестов и джавадоков

Нет-нет, мне именно стандарты: что должно присутствовать в документации, в какой последовательности, вот это всё

а swagger — поставь ещё этих аннотаций, да выпей яду

Как оформить содержимое BODY и т.п.

так это ведь и гугл кодстайле есть

вот, например сваггер по мотивам петстор http://petstore.swagger.io/

Неееет, мне именно стандарт какой-нибудь, для описания всего этого

его, конечно же нету

у rest’a как бы нету как такового стандарта

Например. Документация для REST endpoint контроллера должна иметь следующую структуру: 1. Метод

2. endpoint 3. описание header (если требуется) 4. описание body (если требуется)

ты сваггер то открывал

Пойду пить йад, чего поделать

ты сваггер то открывал

Это для автогенерации.

А мне нужен аналог ГОСТ 7.32 для JavaDoc

Как-то так

ну не совсем авто

там хуева туча описания, всякие @Api ApiOperation @ApiModel

Ну это всё-равно разброд и шатания. Печально что нет никаких требований к документации.

Ну это всё-равно разброд и шатания. Печально что нет никаких требований к документации.

ну, голове описание апи — скучно

ну всё как в REST

много кто генерит всякие юзер гайды

посмотри на github хотя бы

ну, голове описание апи — скучно

Для веселушек можно Spring REST чего-то там поюзать. Оно после теста генерит кучу всего

rest docs

https://developer.github.com/v3/

но вот я не знаю как это поддерживать в актуальном состоянии

если ты что-то меняешь в схеме

Угу. Поэтому я хочу тупо в JavaDoc описать всё что надо, а в README.md просто ссылку на контроллер дать

ну их актуальность тоже нужно поддерживать

Ну изменил схему@поправил JavaDoc.

Вроде всё ок

ахахахахахахах

это так не работает

генераторы хотя бы помогают актуальной держать схему

ладно уже описание эндпоинта

Ну это да.

Но у меня вопрос был всё же не про этом

А мне нужен аналог ГОСТ 7.32 для JavaDoc

Щас бы программы по гостам писать

Щас бы программы по гостам писать

Не программы а документацию

разбор полетов с radio-t еще никто не сравнивал? :)

А чё их сравнивать?

Они про разное

да сам стиль подачи

Не программы а документацию

JavaDoc - это считай часть программы. Не нужны тут никакие ГОСТы. Хочешь по гостам - пиши сопроводительную документацию к разработке

Мне больше радиот заходит, но если интересная тема в разборе, то тож слушаю

JavaDoc - это считай часть программы. Не нужны тут никакие ГОСТы. Хочешь по гостам - пиши сопроводительную документацию к разработке

Не совсем про то. Просто я немного залип, что и в какой последовательности писать в JavaDoc. Думал м.б. есть какой-нибудь стандарт про это, или общепринятая практика

А мне нужен аналог ГОСТ 7.32 для JavaDoc

Common sense не подходит?

Common sense не подходит?

Читаю, спасибо

А кто у вас клиент вашего API?

Может ему и не нужна дока вовсе

А кто у вас клиент вашего API?

Для себя пишу

Может ему и не нужна дока вовсе

HATEOAS

Или как там

Мне больше радиот заходит, но если интересная тема в разборе, то тож слушаю

я обычно не критикую то, что не могу сделать лучше. но вот просто решил попробовать слушать разбор полетов. в общем ребята может и классные специалисты, но над дикцией нужно работать и качество звука просто отвратительное было в моем первом 157 выпуске

а от фонового звука в конечном итоге заболела голова :)

Для себя пишу

Аа, ну теперь то стало понятно желание «делать по стандартам». Ну как найдёшь что нибудь - делись опытом)

Аа, ну теперь то стало понятно желание «делать по стандартам». Ну как найдёшь что нибудь - делись опытом)

Мне уже объяснили что их нет.

Мне уже объяснили что их нет.

но ты поищи, ты как-то быстро заешься

но ты поищи, ты как-то быстро заешься

Нету. Прежде чем вопрос задать, я изрядно гуглил.

Потому и спросил

В спортлото

В России заблокирован LinkedIn? Они там совсем ебанулись. Ещё бы гитхаб заблокировали.

это только сейчас звучит как шутка, однажды ФСБ понадобятся все ключи шифрования для всех репозиториев…

и гитхаб прикроют быстро

а почему нет, можно же и там общаться

террористам

если выяснится что террористы общались текстом гит коммитов

конечно

Потом бабки Путина снова снимут видео где они сожгут черного кота

Кто в России

https://docs.datastax.com/en/developer/java-driver/3.4/

работает?

работает?

Сайт висит, а драйвер работает :)

видимо роскомнадзору он не нравится

ибо с сервера на амазоне все работает

Ребята, с праздником!!!))?

сайт висит

Скоро белый впн сделают, заживём)

скоро по паспортам в интернеты ходить б3дем

с автоматическим баном интернета на 2 часа при попытке использования прокси или впн, как в туркменистане

с автоматическим баном интернета на 2 часа при попытке использования прокси или впн, как в туркменистане

Да не, они вполне адекватные, надо было попробовать и посмотреть что будет)