Vestful v1.0.rc.1 发布,通用 Restful 服务框架

来源: 投稿
作者: Voovan
2017-03-14

Vestful 是基于 Voovan 开发的通用 Restful 服务框架。旨在为广大开发者提供一个快速、稳定、功能丰富、自产文档的 Restful 框架。目的是在完成业务实现的同时,说明文档、接口服务等同时完成。

Vestful 已经在 Dockerfly 开源项目中使用,表现良好,并且 dockerfly开源项目的项目点评中有很多朋友问到如何在页面的 js 中调用 java 类? 我悄悄的告诉你:"答案就在这里."

特点:

1.使用 Vestful 可以快速的通过页面中的 js直接操作后台java 类(new、调用方法等等),同时提供安全控制。

  • 支持类可访问控制,控制那些类可以被前台操作。 

  • 支持类或者包的别名控制,对某些不想暴露类路径或者类的完全现定名的可以通过别名的方式隐藏类。

  • 前端实例化的对象的存活时间控制,防止 OOM。使用对象的方法等操作会默认自动刷新存活时间。

2.仅仅通过两个注解就可以自动将方法暴露成 Restful 接口,并生成完善的Restful 接口说明文档。

3.自动识别路径中的变量、常规请求变量、URLEncode以及MUTILPART提交变量。 

  • 变量来源优先: 路径变量 > URLEncode以及MUTILPART提交变量 > 常规请求变量。

4. 支持 HTTP 协议中的方法以及任意的自定义 HTTP 方法。

5. 由于 HTTP 协议发送的请求为字符串,所以方法的参数类型目前支持常规的 Java基础类型、Collection、Map及自定义类型。

6. 对方法的参数个数、返回值类型等没有要求,可以使用任意类型。如果方法返回的是一个自定义的对象,会自动转换成 JSON 字符串的形式返回。

7. 需要访问说明文档,请在对应的接口URL后增加!, 如接口路径为/test, 访问文档则通过/test!来访问。

演示地址:

    接口服务演示:http://vestful.voovan.org/vestful/test!

    接口方法演示:http://vestful.voovan.org/vestful/test/testWithReturnObject!

    Call java 类演示:http://vestful.voovan.org

接口说明文档截图:


<script src="/DirectObject/genScript/java.util.ArrayList"></script> //具体内容请参照 WEBAPP/test.html <script >    arraylist1 = new ArrayList();    arraylist1.add("aaaa");    arraylist2 = new ArrayList();    arraylist2.add("bbbb");    //支持在前台构造的 java 对象的相互引用    arraylist1.addAll(arraylist2);    //手工释放对象,如果不手工释放则根据配置文件里的存活时常进行释放    arraylist1.release();    arraylist2.release(); <script/>

具体的使用方法请访问:https://git.oschina.net/helyho/Vestful

展开阅读全文
44 收藏
分享
加载中
最新评论 (4)

引用来自“游客”的评论

这个说啥好,RPC硬和restful融合还牵扯到java上,这个轮子有点屌
往大的方面看只要是能够开发 http 访问的语言,都可以通过这个 RPC 操作 JAVA 类,只是目前我的场景仅仅针对 js.
2017-03-15 19:22
0
回复
举报

引用来自“游客”的评论

这个说啥好,RPC硬和restful融合还牵扯到java上,这个轮子有点屌
关于融合 java 的调用,我设计的时候主要是为了解决自己开发上的痛点.
通过 RPC 的方式操作 JAVA 类,解决了我开发上的很多问题.
至少不用专门设计 restful接口,编写 restful 文档,前端开发人员参照 javadoc 就可以用 js 进行开发.节省一些冗余的工作.
2017-03-15 19:19
0
回复
举报

引用来自“小马哥_mark”的评论

怎么感觉比swagger麻烦
其实配置的东西不算多,编写业务类的时候使用两个注解,其他就没有什么了.感谢你的关注
2017-03-15 19:16
0
回复
举报
后面的代码为毛我排好版的,怎么发出来就成了未排版的了,囧死.
2017-03-14 17:50
0
回复
举报
更多评论
5 评论
44 收藏
分享
返回顶部
顶部