在Python的web框架中编写创建日志的程序的教程
在web开发中,后端代码写起来其实是相当容易的。
例如,我们编写一个rest api,用于创建一个blog:
@api @post('/api/blogs') def api_create_blog(): i = ctx.request.input(name='', summary='', content='') name = i.name.strip() summary = i.summary.strip() content = i.content.strip() if not name: raise apivalueerror('name', 'name cannot be empty.') if not summary: raise apivalueerror('summary', 'summary cannot be empty.') if not content: raise apivalueerror('content', 'content cannot be empty.') user = ctx.request.user blog = blog(user_id=user.id, user_name=user.name, name=name, summary=summary, content=content) blog.insert() return blog
编写后端python代码不但很简单,而且非常容易测试,上面的api:api_create_blog()本身只是一个普通函数。
web开发真正困难的地方在于编写前端页面。前端页面需要混合html、css和javascript,如果对这三者没有深入地掌握,编写的前端页面将很快难以维护。
更大的问题在于,前端页面通常是动态页面,也就是说,前端页面往往是由后端代码生成的。
生成前端页面最早的方式是拼接字符串:
s = '<html><head><title>' + title + '</title></head><body>' + body + '</body></html>'
显然这种方式完全不具备可维护性。所以有第二种模板方式:
<html> <head> <title>{{ title }}</title> </head> <body> {{ body }} </body> </html>
asp、jsp、php等都是用这种模板方式生成前端页面。
如果在页面上大量使用javascript(事实上大部分页面都会),模板方式仍然会导致javascript代码与后端代码绑得非常紧密,以至于难以维护。其根本原因在于负责显示的html dom模型与负责数据和交互的javascript代码没有分割清楚。
要编写可维护的前端代码绝非易事。和后端结合的mvc模式已经无法满足复杂页面逻辑的需要了,所以,新的mvvm:model view viewmodel模式应运而生。
mvvm最早由微软提出来,它借鉴了桌面应用程序的mvc思想,在前端页面中,把model用纯javascript对象表示:
<script> var blog = { name: 'hello', summary: 'this is summary', content: 'this is content...' }; </script>
view是纯html:
<form action="/api/blogs" method="post"> <input name="name"> <input name="summary"> <textarea name="content"></textarea> <button type="submit">ok</button> </form>
由于model表示数据,view负责显示,两者做到了最大限度的分离。
把model和view关联起来的就是viewmodel。viewmodel负责把model的数据同步到view显示出来,还负责把view的修改同步回model。
viewmodel如何编写?需要用javascript编写一个通用的viewmodel,这样,就可以复用整个mvvm模型了。
好消息是已有许多成熟的mvvm框架,例如angularjs,knockoutjs等。我们选择vue这个简单易用的mvvm框架来实现创建blog的页面templates/manage_blog_edit.html:
{% extends '__base__.html' %} {% block title %}编辑日志{% endblock %} {% block beforehead %} <script> var action = '{{ action }}', redirect = '{{ redirect }}'; var vm; $(function () { vm = new vue({ el: '#form-blog', data: { name: '', summary: '', content: '' }, methods: { submit: function (event) { event.preventdefault(); postapi(action, this.$data, function (err, r) { if (err) { alert(err); } else { alert('保存成功!'); return location.assign(redirect); } }); } } }); }); </script> {% endblock %} {% block content %} <div class="uk-width-1-1"> <form id="form-blog" v-on="submit: submit" class="uk-form uk-form-stacked"> <div class="uk-form-row"> <div class="uk-form-controls"> <input v-model="name" class="uk-width-1-1"> </div> </div> <div class="uk-form-row"> <div class="uk-form-controls"> <textarea v-model="summary" rows="4" class="uk-width-1-1"></textarea> </div> </div> <div class="uk-form-row"> <div class="uk-form-controls"> <textarea v-model="content" rows="8" class="uk-width-1-1"></textarea> </div> </div> <div class="uk-form-row"> <button type="submit" class="uk-button uk-button-primary">保存</button> </div> </form> </div> {% endblock %}
初始化vue时,我们指定3个参数:
el:根据选择器查找绑定的view,这里是#form-blog,就是id为form-blog的dom,对应的是一个<form>标签;
data:javascript对象表示的model,我们初始化为{ name: '', summary: '', content: ''};
methods:view可以触发的javascript函数,submit就是提交表单时触发的函数。
接下来,我们在<form>标签中,用几个简单的v-model,就可以让vue把model和view关联起来:
<!-- input的value和model的name关联起来了 --> <input v-model="name" class="uk-width-1-1">
form表单通过<form v-on="submit: submit">把提交表单的事件关联到submit方法。
需要特别注意的是,在mvvm中,model和view是双向绑定的。如果我们在form中修改了文本框的值,可以在model中立刻拿到新的值。试试在表单中输入文本,然后在chrome浏览器中打开javascript控制台,可以通过vm.name访问单个属性,或者通过vm.$data访问整个model:
如果我们在javascript逻辑中修改了model,这个修改会立刻反映到view上。试试在javascript控制台输入vm.name = 'mvvm简介',可以看到文本框的内容自动被同步了:
双向绑定是mvvm框架最大的作用。借助于mvvm,我们把复杂的显示逻辑交给框架完成。由于后端编写了独立的rest api,所以,前端用ajax提交表单非常容易,前后端分离得非常彻底。