浩的博客

Python开发入门与实战14-基于Extjs的界面

14. 基于Extjs的界面

上一章我们实现了一个原生的html例子,本章我们将采用Extjs实现界面的展现,来说明MVC模式下我们是怎么考虑界面与业务层的关系的。

14.1. 引用Extjs目录

首先,我们在inventory app下增加一个static目录,拷贝Extjs发布目录到static下,本章节例子我们采用的是Extjs 4.1.1版本进行说明演示,Django项目能够访问static目录我们需要修改项目setting.py的STATIC_ROOT项的值,项目才能正确装载引用的静态文件。

# Absolute path to the directory static files should be collected to.

# Don't put anything in this directory yourself; store your static files

# in apps' "static/" subdirectories and in STATICFILES_DIRS.

# Example: "/home/media/media.lawrence.com/static/"

import os.path

STATIC_ROOT = os.path.join(os.path.dirname(os.path.dirname(__file__)), 'static').replace('\\', '/')

14.2. 增加inventoryQueryExtjs.html模板文件

我们仿照上一章页面结构实现Extjs查询界面模板,模板代码如下:

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="utf-8" />
    <title></title>
    <link href="../static/ExtJs/resources/css/ext-all.css" rel="stylesheet" />
    <script src="../static/ExtJs/bootstrap.js"></script>
    <script type="text/javascript">
        Ext.onReady(function () {

        //    var button1 = Ext.create('Ext.button.Button', {
        //        text: 'search',
        //        handler: function () {
        //            myStore.load({
        //                params: { q: '螺母' }
        //            });
        //        }
        //    });

        
            //定义Extjs端 model
            Ext.define('inventory', {
                extend: 'Ext.data.Model',
                fields: [
                    { name: 'InventoryId', type: 'string' },
                    { name: 'ItemName', type: 'string' },
                    { name: 'Amount', type: 'string' },
                ]
            });

            //申明一个Store类型的变量
            var myStore = Ext.create('Ext.data.Store', {
                model: 'inventory',
                id: 'store1',
                proxy: {
                    type: 'ajax',
                    url: '/getInventoryByItemName/', //Store与后台的交互url
                    reader: {
                        type: 'json',
                    }
                }
            });

            //定义查询TextField和Button
            var textField1 = Ext.create('Ext.form.Panel', {
                width: '100%',
                renderTo: 'div0',
                layout: {
                    type: 'hbox', // 子元素横向布局
                    padding: 5
                },

                items: [
                    {
                        xtype: 'textfield',
                        name: 'query',
                        id: 'query',
                        fieldLabel: 'Item Name:',
                    },
                    {
                        xtype:'button',
                        text: 'search',
                        handler: function () {
                            myStore.load({
                                params: { q: Ext.getCmp("query").getValue() }  //Store装载数据是传入查询参数
                            });
                        }
                    }
                ]
            });

            var grid = Ext.create('Ext.grid.Panel', {
                title: '列表',
                store: myStore,
                id: 'grid1',
                columns: [
                    { text: 'id', dataIndex: 'InventoryId' },
                    { text: 'ItemName', dataIndex: 'ItemName' },
                    { text: 'Amount', dataIndex: 'Amount' }
                ],
                width: '100%',
                height: 500,
                forceFit: true,
                renderTo: 'div1',
            });

        });

    </script>
</head>
<body>
    <div id="div0"></div>
    <div id="div1"></div>

</body>
</html>

代码说明:Extjs页面我们首先定义了一个界面使用的model类,界面控件包括文本框、按钮、grid和store。Store里我们使用了一个重要的后台交互url: / getInventoryByItemName,这个url以json格式字符串来返回查询结果,最后,返回的结果集绑定到grid里显示,查询按钮的事件里,我们根据查询条件返回的json重新装载store,刷新grid显示。关于Extjs更多的控件和用法,请参考Extjs管网,笔者在这里更多的是说明思路。

接下里我们在views里面增加getInventoryByItemName函数以json返回数据集,并发布到urls.py里。

14.3. 数据交互url

我们在views.py里增加函数getInventoryByItemName,请注意实现代码里,仍然是委托调用了biz层的getInventoryByItemName,这个函数的功能与原来的inventoryQuery基本功能是一致的,只是增加了Json格式化的代码部分,同时直接返回Json字符串,而不是加载模板返回渲染的网页,代码如下:

def getInventoryByItemName(request):
    error = False
    inventorysJson = '[]'
    if 'q' in request.GET:
        q = request.GET['q']
        if not q:
            error = True
        elif len(q) > 20:
            error = True        
        else:
            biz = InventoryBiz()
            inventorys =biz.getInventoryByItemName(q)    
            inventorysJson=u'[' 

            for inventory in inventorys:
                inventorysJson = inventorysJson + u'{"InventoryId":"' + str( inventory.InventoryId) + u'","ItemName":"' +  inventory.Item.ItemName + u'","Amount":"' + str( inventory.Amount) + u'"}'
            inventorysJson = inventorysJson + u']'


    return HttpResponse(inventorysJson)

代码重构的这个变化会导致系统的整个结构发生很大的变化,后面的章节我们会逐步的讲到。getInventoryByItemName url变成了一个返回Json格式查询结果的url请求,成为一个可以供各种支持json格式客户端调用的API,为我们的客户端未来支持扩展到android、iOS和windows phone等前端展现提供了架构基础。

1.4. 发布Extjs页面

Views.py

…

def inventoryQueryExtjs(request):

    return render_to_response('inventoryQueryExtjs.html')

urls.py 

…

url(r'^inventoryQueryExtjs/$',views.inventoryQueryExtjs),

注意:与原生html不同,采用Extjs技术的页面发布了两个url一个专门用来渲染页面inventoryQueryExtjs,一个变成了专门的返回查询结果的url请求:getInventoryByItemName,这个结构上的变化让业务逻辑层与界面层,实现了进一步的解耦和,未来我们可以不断的衍生界面端(客户端),同时,所有客户端调用统一的后台服务。

最后,访问inventoryQueryExtjs页面的结果如下图:

image

14.5. 采用流行的Bootstrap框架页面

本小节我们延伸一下页面框架,用当下流行的页面框架Bootsstrap实现上面的库存查询界面。

http://getbootstrap.com/ 下载Bootstrap文件;

https://jquery.com/ 下载JQuery文件。

两个文件解压缩后分别拷贝粘贴到工程的static目录下。

这里为了简化数据加载,我们还采用了一个第三方的bootstrap-table作为table grid操作的控件,

http://wenzhixin.net.cn/p/bootstrap-table/docs/?locale=zh 我们下载完整包后只拷贝bootstrap-table.css\bootstrap-table.js到static目录下:

我们新增的inventoryQueryBootstrap.html代码如下:

<!DOCTYPE html>

<html lang="en" xmlns="http://www.w3.org/1999/xhtml">
<head>
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> 
    <title></title>
    <link href="../static/bootstrap/css/bootstrap.min.css" rel="stylesheet" />   
    <script src="../static/JQuery/jquery-2.1.4.min.js"></script>
    <script src="../static/bootstrap/js/bootstrap.min.js"></script> 
    <script src="../static/bootstrap/table/bootstrap-table.js"></script>
</head>

<body>
    <form class="form-inline" role="form">
    <div class="form-group">
        <label for="name">Item Name:</label>
        <input type="text" class="form-control" id="ItemName"placeholder="请输入物料名称">
        <button id="search"  type="button">search</button>
   </div>    
    </form>

    <table id="inventorysTable" data-cache="false">
   <thead>
      <tr>
         <th data-field="InventoryId">Id</th>
         <th data-field="ItemName">ItemName</th>
         <th data-field="Amount">Amount</th>
      </tr>
   </thead>
</table>
</body>
</html>

<script type="text/javascript">
//初始化用户列表设置
        $('#inventorysTable').bootstrapTable(
        {
            striped: true,
            sidePagination: "client",
            url: '/getInventoryByItemName/',          
        });

        //查询按钮点击事件
        $('#search').click(function () {
            var itemName = $('#ItemName').val();
            $('#inventorysTable').bootstrapTable('refresh', {
                url: '/getInventoryByItemName/' + "?q="
                    + encodeURIComponent(itemName),

            });

        });


</script>

注:上面代码中的encodeURIComponent主要是解决IE浏览器的中文显示乱码问题。

页面运行结果如下:

image

14.6. 小结

本章是笔者最想写的章节,也是笔者多年开发经验的一个心得,如何通过好的架构来满足和改进项目系统的架构最后得到一个“低耦合,高内聚”的软件架构,在这个一个结构基础上我们可以不断的改进和重构我们的项目代码,为项目本身业务的进化打下坚实的基础。未来笔者的其它文章会继续引用这一服务来说明其它客户端的开发。

好的系统架构确实会为我们项目的长期带来收益,也可能会牺牲一点短期效率,所以整个团队的项目管理如果是建立在敏捷模式的基础上,就会在一定范围内减少对短期效率的影响。我们不用过度设计,以满足当前需求为准,最快的实现功能,并有合理的粒度的单元测试。这样,未来发现这样的代码结构不满足需要时,我们通过重构来改进代码,并通过单元测试回归来验证代码是否符合原先和现在的设计,最终让项目形成一种可以不断进化的机制。

本章结束python的基本的开发模式就说明完了,我们介绍在django工程里何构如建MVC模式就告一段落了,下一章开始我们讲讲项目的部署和发布。

posted on 2015-08-05 10:37 wuch 阅读(...) 评论(...) 编辑 收藏

My Links

Blog Stats