bxcrbq 2010-04-21
1什么是SpringSurf?
SpringSurf是Spring的一个扩展工程。它允许你用script脚本的方式提供web服务,同时在脚本里能够调用springbean
SpringSurf包括了以下几个方面
*Surf
*WebScripts
*WebEditor
*SpringRooAdd-on
*SpringSourceToolSuitePlugin
*SampleSites
*PHPandGroovyscriptingforSpringWebApplications
实际上必须的就是1和2,即Surf和webscripts。其他几项都是为了辅助开发方面的应用
2SpringSurf来源
它来源于一个文档和内容管理系统Alfresco。Alfresco在向外提供内容服务时,发现仅提供REST层面的服务实现的功能很有限,换而言之仅通过Web调用在处理事务、同步、性能等方面问题很多,为此,Alfresco提供了一个脚本环境,允许用户定义自己的逻辑脚本跑在服务器端。脚本就可以直接在服务器端调用封装好的bean服务,而整个逻辑过程通常是事务性的。
从代码来看,SpringSurf的核心部分的代码都是由Alfresco提交的。
3HelloSpringSurf
首先来到http://www.springsurf.org/即其官方网站
下载
*SpringSurfEmptyWebApplication
或
*SpringSurfQuickStartWebApplication
最好是后者,还有几个例子
把war扔在tomcat下,启动
找到WEB-INF\webscripts目录
创建一个test目录
创建3个文件放在这个目录下
1Web服务描述文件test.get.desc.xml
<webscript> <shortname>Company Header</shortname> <description>Company Header</description> <url>/test/gs</url> </webscript>
2请求处理脚本test.get.js
model.headerTitle = "Hello WebScripts";
3页面模板文件test.get.html.ftl
<div class="left"> <table width="100%"> <tr> <td nowrap><img src="${url.context}/res/images/SurfLogo200.jpg" alt="Surf" height="75px" /></td> <td style="padding-top: 10px; font-size: 28px; font-family: Helvetica; color: #AAAAAA;" nowrap> ${headerTitle}</td> <td width="100%"></td> </tr> </table> </div>
重新启动tomcat再访问
http://127.0.0.1:8080/spring-surf-application-quickstart-1.0.0.M3/test/gs
怎么样,3个文件完成一个服务,是不是感觉也很一般?
4三个文件的分工。
因为有了工具,可能开发这些东西会稍微轻松一些。但这里还要把3个文件的用途说一下
*.desc.xml文件描述了这个服务,在上面例子中,只是指定了服务的url。这个参数也是唯一必须的配置项。
还有一些别的配置,比如一个比较全的配置会写成这样
<webscript kind="org.alfresco.httpsonly"> <shortname>Hello World</shortname> <description>Greet a user</description> <url>/sample/helloworld?to={name}</url> <url>/sample/helloworld.xml?to={name}</url> <format default="html">extension</format> <lifecycle>sample</lifecycle> <authentication runas="fred">user</authentication> <transaction>required</transaction> <family>Sample</family> <cache> <never>false</never> <public>false</public> <mustrevalidate/> </cache> <negotiate accept="text/html">html</negotiate> <negotiate accept="text/xml">xml</negotiate> </webscript>
指定多个url,指定运行的用户或指定必须登录,指定需要事务,指定处理缓存等
*.js指定了页面的处理逻辑。在样例应用中,只有页面对象和http相关对象可供调用。用户可以把自己的服务封装成js对象在这个文件里调用。
*.ftl是一个freemaker模板文件。它和*.js文件共享一些对象。
5SpringSurf的意义
看了以上的介绍,可能有人会问,构建一个web服务的确会比较有趣,但能给我们带来更多的东西呢?
其实大家有没有发现,这个web服务不涉及到任何Java代码,换而言之,当服务增、改、删除时,整个服务器是不需要重启的,并且应该也不会有Classloader的创建或者类重新加载。并且服务的描述、开发和重部署都有了一个明确的规则这就很方便第3方应用提供者基于一个平台构建服务。
最后再宣传一下G趣网(www.g-qu.net)。
G趣网正是一个应用平台,第3方可以部署自己的服务。而编写一个服务更为简单,只需要1个js文件。但总体上来说和Surf的想法是大同小异,为了web开发方便对整个框架做了最大程度的简化
访问官方博客http://www.g-qu.net/p/system/oblog/了解更多信息