2014-10-10 47 views
1

如何反思現有的restlet服務器的資源?如何從CLI使用apispark

我開始像這樣就跑總是走入誤區:

java -cp lib/org.restlet.ext.apispark.jar:lib/org.restlet.jar:dist/myrestapi.jar org.restlet.ext.apispark.Introspector -l swagger -v com.example.service.MyRestService -u xxx -p yyy 

我是否需要標註我的服務器資源以及如何實現它讓我的資源和業務上市?

我也嘗試擴展SwaggerApplication,至少可以得到部分結果來查看我的資源,但我也想看到這些方法,並且想用相應的文檔來註釋我的代碼。這怎麼能實現?我如何使用swagger註釋和restlet資源?

回答

2

自省

您應該訪問this page,以獲得正確的依賴關係(有些缺失)和語法。 在你的情況,我想嘗試這樣的事:

java -cp lib/*:dist/myrestapi.jar org.restlet.ext.apispark.Introspector -v -u xxx -p yyy com.example.service.MyRestService 

注:的內部檢查是目前沉重的重構下,你將無法您的定義上傳到APISpark。當服務恢復正常時,我會保持更新。

SwaggerApplication

的SwaggerApplication將服務於揚鞭資源清單上/ API-文檔和API聲明上/ API-文檔/ {pathToApiDeclaration}。您應該能夠看到第二種路徑上的方法。

如需在線示例,請選擇http://petstore.swagger.wordnik.com/api/api-docs。處理寵物的資源在這裏描述:http://petstore.swagger.wordnik.com/api/api-docs/pet(附加資源列表中給出的路徑)。 SwaggerApplication將觀察到相同的方案。

在下一個版本或Restlet中會支持Swagger註釋,因爲我們目前正在研究這個主題,一旦完成,我會更新此線程。如果緊急,您可能有興趣查看關於this page的最新評論。

希望這會有所幫助,