Spring Surf入门 - 二次开发 - Alfresco技术论坛

Alfresco技术论坛



查看: 1320|回复: 0

Spring Surf入门

[复制链接]


40

主题

41

帖子

427

积分

管理员

Rank: 9Rank: 9Rank: 9

积分
427
QQ
发表于 2019-4-8 21:20:42 | 显示全部楼层 |阅读模式
1、什么是Spring Surf?

Spring Surf是Spring的一个扩展工程。  它允许你用script脚本的方式提供web服务,同时在脚本里能够调用spring bean

Spring Surf包括了以下几个方面

    * Surf
    * Web Scripts
    * Web Editor
    * Spring Roo Add-on
    * SpringSource Tool Suite Plugin
    * Sample Sites
    * PHP and Groovy scripting for Spring Web Applications

实际上必须的就是1和2,即Surf和webscripts。 其他几项都是为了辅助开发方面的应用


2、Spring Surf 来源

它来源于一个文档和内容管理系统Alfresco。 Alfresco在向外提供内容服务时,发现仅提供REST层面的服务实现的功能很有限,  换而言之仅通过Web调用在处理事务、同步、性能等方面问题很多, 为此,Alfresco提供了一个脚本环境,允许用户定义自己的逻辑脚本跑在服务器端。  脚本就可以直接在服务器端调用封装好的bean服务, 而整个逻辑过程通常是事务性的。


另一个方面,随着运用的深入,在share基础上进行二次开发对于一般用户来说显得十分困难。因此Alfresco提出了以Spring Surf为基础构建应用,再调用Alfresco服务的解决方案。可以说Spring Surf是目前Alfresco二次开发的最佳解决方案。

从代码来看, Spring Surf 的核心部分的代码都是由Alfresco提交的。


3、Hello Spring Surf

首先 来到 http://www.springsurf.org/ 即其官方网站
下载

    * Spring Surf Empty Web Application



    * Spring Surf Quick Start Web Application

最好是后者, 还有几个例子

把war扔在tomcat下,启动

找到WEB-INF\webscripts目录

创建一个test目录

创建3个文件放在这个目录下


(1) Web服务描述文件 test.get.desc.xm
  1.     <webscript>  
  2.     <shortname>Company Header</shortname>  
  3.     <description>Company Header</description>  
  4.     <url>/test/gs</url>  
  5.     </webscript>  
复制代码
(2) 请求处理脚本 test.get.js

  1. model.headerTitle = "Hello WebScripts";
复制代码
(3) 页面模板文件 test.get.html.ftl

  1.     <div class="left">  
  2.     <table width="100%">  
  3.     <tr>  
  4.     <td nowrap><img src="${url.context}/res/images/SurfLogo200.jpg" alt="Surf" height="75px" /></td>  
  5.     <td style="padding-top: 10px; font-size: 28px; font-family: Helvetica; color: #AAAAAA;"   nowrap>  ${headerTitle}</td>  
  6.     <td width="100%"></td> </tr>  
  7.     </table>  
  8.     </div>  
复制代码
重新启动tomcat 再访问
http://127.0.0.1:8080/spring-sur ... rt-1.0.0.M3/test/gs

怎么样,3个文件完成一个服务,是不是感觉也很一般?


4、三个文件的分工。

因为有了工具,可能开发这些东西会稍微轻松一些。   但这里还要把3个文件的用途说一下

*.desc.xml文件描述了这个服务, 在上面例子中,只是指定了服务的url。 这个参数也是唯一必须的配置项。

还有一些别的配置,比如一个比较全的配置会写成这样

  1.     <webscript kind="org.alfresco.httpsonly">   
  2.       <shortname>Hello World</shortname>  
  3.       <description>Greet a user</description>  
  4.       <url>/sample/helloworld?to={name}</url>  
  5.       <url>/sample/helloworld.xml?to={name}</url>  
  6.       <format default="html">extension</format>  
  7.       <lifecycle>sample</lifecycle>  
  8.       <authentication runas="fred">user</authentication>  
  9.       <transaction>required</transaction>  
  10.       <family>Sample</family>  
  11.       <cache>  
  12.         <never>false</never>  
  13.         <public>false</public>  
  14.         <mustrevalidate/>  
  15.       </cache>  
  16.       <negotiate accept="text/html">html</negotiate>  
  17.       <negotiate accept="text/xml">xml</negotiate>  
  18.     </webscript>  
复制代码
指定多个url,指定运行的用户或指定必须登录, 指定需要事务,指定处理缓存等


*.js   指定了页面的处理逻辑。 在样例应用中,只有页面对象和http相关对象可供调用。  用户可以把自己的服务封装成js对象在这个文件里调用。

*.ftl是一个freemaker模板文件。它和*.js文件共享一些对象。


5、Spring Surf的意义


看了以上的介绍,可能有人会问, 构建一个web服务的确会比较有趣,但能给我们带来更多的东西呢?

其实大家有没有发现,这个web服务不涉及到任何Java代码, 换而言之,当服务增、改、删除时, 整个服务器是不需要重启的,并且应该也不会有Classloader的创建或者类重新加载。 并且服务的描述、开发和重部署都有了一个明确的规则 这就很方便第3方应用提供者基于一个平台构建服务。


而且Spring Surf同时集成了Remote调用Alfresco服务的方式,同时Spring Surf Webscripts 和Alfresco JavaScript Webscripts是几乎一样的构造逻辑,也就是在后台直接编写js方法调用java bean对象。这种前后端几乎一样的编写方式,大大降低了二开成本。


回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则



QQ|小黑屋| Alfresco技术论坛 ( 闽ICP备15015720号 )

GMT+8, 2020-2-27 12:26 , Processed in 0.102195 second(s), 19 queries .

快速回复 返回顶部 返回列表