java - 如何从 CLI 使用 apispark

标签 java restlet swagger

如何内省(introspection)现有 ReSTLet 服务器的资源?

我是这样开始的,但总是遇到错误:

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 资源一起使用?

最佳答案

自省(introspection)

您应该访问this page获得正确的依赖项(有些缺失)和语法。 对于你的情况,我会尝试这样的事情:

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

注意:Introspector 目前正在进行大量重构,您将无法将定义上传到 APISpark。当服务恢复正常时,我会及时通知您最新情况。

SwaggerApplication

SwaggerApplication 将在/api-docs 上提供 Swagger 资源列表,并在/api-docs/{pathToApiDeclaration} 上提供 API 声明。您应该能够看到第二种路径上的方法。

有关在线示例,请查看 http://petstore.swagger.wordnik.com/api/api-docs 。这里描述了与宠物有关的资源:http://petstore.swagger.wordnik.com/api/api-docs/pet (附加资源列表中给出的路径)。 SwaggerApplication 将遵循相同的方案。

在下一个版本或 ReSTLet 中将支持 Swagger 注释,因为我们目前正在研究这个主题,完成后我将更新此线程。如果紧急的话,您可能有兴趣查看 this page 上的最新评论.

希望这有帮助,

关于java - 如何从 CLI 使用 apispark,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/26302081/

相关文章:

java - 为什么我在 MacOSX 上缺少/System/Library/Frameworks/JavaVM.framework/Libraries/libjawt.dylib?

Java 进程占用的内存超过其最大堆大小

java - 如何使用 RESTlet 在 RESTful Web 服务中强制执行 'sessions'?

c# - 带有 api 版本控制的 Autofac 和 swagger 给出了异常

java - Postgres 9.4.4 值太长,类型字符不同

java - Hibernate 无法在不重命名的情况下保存实体

java - ReSTLet:GET 请求使用访问多个资源的查询

java - 使用 jetty 客户端发布会在 reSTLet 中给出空表示

node.js - swagger 2.0 中 JSON 对象的模式类型是什么

json - Swagger 在 Docker Image 中使用本地 json 文件运行