使用ExtDirectSpring整合Spring3和ExtJs4

ExtDirectSpring是一个用于ExtJs4直接调用远程Spring方法的第三方库。我们不再需要在spring方法中封装json对象供外界调用，ExtJs4也不再需要手动解析远程服务器返回过来的Json对象，所有这些操作都由ExtDirectSpring去处理，ExtJs4只需要象调用本地方法一样去操作远程资源。

 

ExtDirectSpring主页地址:

https://github.com/ralscha/extdirectspring

 

以下是一个简要的工程搭建过程（我们假设你已经创建了一个Spring MVC的工程)

1: 在pom.xml中添加相关依赖

 <dependency>
     <groupId>ch.ralschagroupId>
     <artifactId>extdirectspringartifactId>
     <version>1.2.0version>
 dependency>
 <dependency>
     <groupId>commons-fileuploadgroupId>
     <artifactId>commons-fileuploadartifactId>
     <version>1.2.2version>
 dependency>
 <dependency>
     <groupId>commons-iogroupId>
     <artifactId>commons-ioartifactId>
     <version>2.1version>
 dependency>

2: 将含有@ExtDirectMethod标签的类所在包添加到Spring组件管理中

注：所有被暴露出来允许远程访问的方法都需要添加@ExtDirectMethod注解

< context:component-scan   base-package = "com.train.extdirectspring,ch.ralscha.extdirectspring"   />  

3: 在Spring配置文件中添加对ExtDirectSpring的全局配置信息

 <bean id="extDirectSpringConfiguration" class="ch.ralscha.extdirectspring.controller.Configuration" p:timeout="12000"
     p:maxRetries="10" p:enableBuffer="false">
     <property name="exceptionToMessage">
         <map>
             <entry key="java.lang.IllegalArgumentException" value="illegal argument" />
             <entry key="org.springframework.beans.factory.NoSuchBeanDefinitionException">
                 <null />
             entry>
         map>
     property>
 bean>

  到此为止，服务器端的配置基本完成，下面开始讲述页面前端如何配置调用远程后端方法。

4: 下载并复制ExtJs4的关联文件到工程中去

• 从官网下载并解压http://www.sencha.com/products/extjs

• 复制文件夹locale, resources及文件ext-all-debug.js and ext-all.js到WEB工程目录中    

5: 引入ExtJs4的CSS和JS文件到你的页面中

 <link rel="stylesheet" type="text/css" href="/resources/extjs/resources/css/ext-all.css" />
 <script type="text/javascript" src="/resources/extjs/ext-all-debug.js" >script>

  6: 引入ExtDirectSpring提供的api.js/api-debug.js文件到你的页面中

  <script type="text/javascript" src="/spring/api-debug.js">script>

注：这里的/spring/前缀取决于你的web.xml中的Spring Dispatcher的配置。并且该api-debug.js是由系统生成而非一个静态文件。

7: 引入用于当前页面布局的js文件

 <script type="text/javascript" src="/SpringMVC/resources/app/welcome.js">script>

  注：该文件由用户自定义

 从下面开始我们就要开始编写Extjs代码，我们采用Extjs的MVC框架，编写的一般过程为：编写页面布局js(上面的welcome.js) -> 编写model(MVC) -> 编写store(这个对象主要用于数据集的展示，如实现分页排序等功能) -> 编写视图层(MVC)  -> 编写控制层(MVC) -> 编写SpringMVC方法与ExtJs控制层交互

8: 编写上面定义的welcome.js

 

 Ext.Loader.setConfig({
     enabled: true
 });

 Ext.require('Ext.direct.*', function() {
     Ext.direct.Manager.addProvider(Ext.app.REMOTING_API);
 });

 Ext.application({
     controllers : [ 'sample'], //与第12个步骤中文件名一致
 //    autoCreateViewport : true,
     name : 'Mtx', //应用名，可以任取，不重复即可
     appFolder: 'resources/app', //这里配置当前应用下你的ExtJs MVC代码的存放路径

     launch : function() {
         Ext.create('Ext.container.Viewport', {
             items : [ {
                 xtype : 'sampleList', //参考第11步中的视图别名
                 layout : 'fit',
                 margins: 5
             } ]
         });
     }
 });

9:  编写模型Model

按照ExtJs的规范，我们默认将model文件存放在resources/app/model目录下，其中'resources/app'由第8个步骤中的appFolder配置所决定,model是默认的模型存放文件夹名。我们在这里创建一个路径为resources/app/model/sample.js的用于描述model的文件。我们只简单定义id和name两个字段(实际开发中，一般需要根据数据库中的表结构来定义)

 Ext.define('Mtx.model.Sample', {
     extend : 'Ext.data.Model',//所有定义的model对象都需要继承该父对象

     fields : [ {
         name : 'id',
         type : 'int'
     }, {
         name : 'name',
         type : 'string',
     } ],

     proxy : {
         type : 'direct',
         api : {
             read : helloController.read, //这里的四个方法是ExtJs框架默认集成好的，一般我们只需要实现对应的方法就可以轻松实现增删改查操作
             create : helloController.save,
             update : helloController.save,
             destroy : helloController.destroy
         },
         reader : {
             root : 'records'
         }
     }
 });

10: 编写store(这个对象主要用于数据集的展示，如实现分页排序等功能)

和model一样，store的默认存放路径为$appFolder+'/store', 这里对应路径为resources/app/store/sample.js

 Ext.define('Mtx.store.Skus', {
     extend: 'Ext.data.Store',
     model: 'Mtx.model.Sample', //参考第9步中定义的model
     autoLoad: true,
     pageSize: 25,
     remoteSort: true,
     autoSync: true,
     sorters: [ {
         property: 'name',
         direction: 'ASC'
     } ]
 });

 
 11: 编写视图层View

与上面一样，store的默认存放路径为$appFolder+'/view', 这里对应路径为resources/app/view/sample.js

 Ext.define('Mtx.view.Sample', {
     extend : 'Ext.grid.Panel',
     alias : 'widget.sampleList', //别处如果需要引用该View,可以使用别名sampleList

     store : 'sample',//必须与第9步中创建的model文件名一致

     initComponent : function() {
         var me = this;

         Ext.applyIf(me, {
             columns : [ {
                 xtype : 'gridcolumn',
                 dataIndex : 'id', //列中显示数据在model中与之对应的变量名
                 text : 'ID', //表中的列名
                 flex : 1
             }, {
                 xtype : 'gridcolumn',
                 dataIndex : 'name',
                 text : 'Name',
                 flex : 1
             }],

             dockedItems : [ {
                 xtype : 'toolbar',
                 dock : 'top',
                 items : [ {
                     fieldLabel : 'Filter', //增加过滤功能，根据输入的字符与name字段进行模糊匹配
                     labelWidth : 40,
                     xtype : 'textfield',
                     itemId : 'filtertextfield'
                 }, '->', {
                     xtype : 'pagingtoolbar', //加上分页功能
                     store : me.getStore(),
                     displayInfo : true
                 } ]
             }, ]
         });

         me.callParent(arguments);
     }

 });

12: 编写控制层Controller

还是和上面一样，store的默认存放路径为$appFolder+'/controller', 这里对应路径为resources/app/controller/sample.js。控制层主要用于为视图中的组件绑定不同的事件。