w jakim narzedziu opisać dokumetację do usługi ?

0

ja używam c++ w urządzeniach embedded ale chciałbym aby programista Android połączyć się z moim programem za pomocą HTTP i JSON

znalazłem przykład dokumentacji w tym watku w jakim narzędziu postał ten plik dokumetacji ? i nawet udało się namierzyć w czym to powstało ale pierwsze wrażenie że zbyt skomplikowany ten Spring REST Docs choć dostrzegam w tym szaleństwie parę zalet.

W czym alternatywnym opisać prosty serwer HTTP ?

2

Kiedyś wszedłem w bebechy Swaggera, "podobno" wiodącego narzędzia. Wyobrażałem sobie, że z prostych adnotacji javowskich i refleksji klas, jakie tam są użyte da się stworzyć dokumentację WebAPI, wielka pomyłka, BARZO DUŻO tzreba zrobić, aby przygotować projekt do kompatybilności - dziecko wylane z kąpielą.
Więc nazwa padła, ale nie rekomenduję.

W czym alternatywnym opisać prosty serwer HTTP ?

A już w C++ to dla mnie nie do wyobrażenia, głównie przez brak refleksji. Pewnie gdzies występują u Ciebie stringi z nazwami pól, ale nie wierzę, że to jest podatne na automatyzację. Musiało by być napisane naprawdę z dobrym zamiarem projektowym, więcej deklaratywnie niż kodem algorytmicznym.

ALE

Czy musi być HTTP ? To jest właśnie MSZ ogromny krok wstecz, jaki został zrobiony z realnym REST/JSON, praca ręczna na polu minowym (np pola null)

Apache Thrift albo Google gRPC to (w kontekście tego wątku) oparte są na samodokumentujacym generatorze. Thirt w C++ wymaga boosta, z javą się to żeni bezproblemowo
Poważny zysk wydajnościowy przez brak konwersji, ważne na ubogim embedded czy na androidach

EDIT: w Thrit proponowanym nośnikiem, tzw Transportem jest protokół binarny, ale JSON jest opcją

0

Dziękuje za narzędzi do przejrzenia,
u mnie platforma to dość biedny Linux-arm z dwoma rdzeniami około 600MHz chcę zużyć jak najmniej zasobów.

1 użytkowników online, w tym zalogowanych: 0, gości: 1