Delphi MVCFramework + Swagger dokumentace parametrů ?

[Duhacek]

Zdravím delphisty,
prosím kdo používáte DMVCF + dokumentaci Swagger – dá se do ní nějak přidat "volitelný" parametr z URL cesty (viz obr) ?
Tedy aby v přehledu endpointu /zamestnanec byl nejen parametr "idzamestnance" ale i "cislo" ?

Díky.

[Radek Červinka]

[MVCSwagParam(plPath, 'Id', 'user id', ptInteger, True, '1')]

plPath je to co potrebujes

[Radek Červinka]

resp cele

Kód: Delphi [Vybrat]

1.     [MVCPath('/UserRight/($Id)')]
2.     [MVCHTTPMethod([httpGET])]
3. {$IFNDEF DEBUG}    [MVCRequiresRole('role1')] {$ENDIF}
4.     [MVCSwagSummary('User', 'List all UserRights by User', 'GetUserRight')]
5.     [MVCSwagParam(plPath, 'Id', 'user id', ptInteger, True, '1')]
6.     [MVCSwagResponses(200, 'Success', TUserRight, True)]
7.     [MVCSwagResponses(500, 'Internal Server Error')]
8.     procedure GetUserRight(const Id: Integer);
9.  

[Duhacek]

plPath je to co potrebujes

Tak bohužel, když u parametru "cislo" změním plQuery na plPath, ve swagger docu se to neukáže.

Potřeboval bych tam něco ve stylu viz obr.

[Radek Červinka]

Tak jeste jednou, viz. priloha

Kód: Delphi [Vybrat]

1.     [MVCPath('/UserRight/($Id)')]
2.     [MVCHTTPMethod([httpGET])]
3. {$IFNDEF DEBUG}    [MVCRequiresRole('roleextra')] {$ENDIF}
4.     [MVCSwagSummary('User', 'List all UserRights by User', 'GetUserRight')]
5.     [MVCSwagParam(plPath, 'Id', 'user id', ptInteger, True, '1')]
6.     [MVCSwagParam(plQuery, 'data', 'extra data id', ptInteger, True, '1')]
7.     [MVCSwagResponses(200, 'Success', TUserRight, True)]
8.     [MVCSwagResponses(500, 'Internal Server Error')]
9.     procedure GetUserRight(const Id: Integer);
10.  

[Duhacek]

Tak jeste jednou, viz. priloha

Díky moc, mám to zřejmě nějaké "nabourané", protože u sebe nevidím ani ten text ze MVCSwagSummary, který u tebe zobrazen je...

[Radek Červinka]

Mas v uses MVCFramework.Swagger.Commons ?
Delphi jako chybejici atribut nehlasi jako chybu pri kompilaci, jen proste v RTTI neni. Jinam mam DMVC asi pul roku stare, ale to se asi nezmenilo.
Podivej se do examplu, tam to bylo.

[Duhacek]

Super 👍
Už je to OK, měl jsem sice MVCFramework.Swagger.Commons v hlavním dpr, ale po přidání i do té unity kontroleru to začalo fungovat.

[Radek Červinka]

Jinak samozrejme to vyhodi warning
[dcc32 Warning] uControlerxx.pas(119): W1074 Unknown custom attribute