Day 11 - 编写日志创建页

在Web开发中,后端代码写起来其实是相当容易的。

例如,我们编写一个REST API,用于创建一个Blog:

  1. @api
  2. @post('/api/blogs')
  3. def api_create_blog():
  4. i = ctx.request.input(name='', summary='', content='')
  5. name = i.name.strip()
  6. summary = i.summary.strip()
  7. content = i.content.strip()
  8. if not name:
  9. raise APIValueError('name', 'name cannot be empty.')
  10. if not summary:
  11. raise APIValueError('summary', 'summary cannot be empty.')
  12. if not content:
  13. raise APIValueError('content', 'content cannot be empty.')
  14. user = ctx.request.user
  15. blog = Blog(user_id=user.id, user_name=user.name, name=name, summary=summary, content=content)
  16. blog.insert()
  17. return blog

编写后端Python代码不但很简单,而且非常容易测试,上面的API:api_create_blog()本身只是一个普通函数。

Web开发真正困难的地方在于编写前端页面。前端页面需要混合HTML、CSS和JavaScript,如果对这三者没有深入地掌握,编写的前端页面将很快难以维护。

更大的问题在于,前端页面通常是动态页面,也就是说,前端页面往往是由后端代码生成的。

生成前端页面最早的方式是拼接字符串:

  1. s = '<html><head><title>'
  2. + title
  3. + '</title></head><body>'
  4. + body
  5. + '</body></html>'

显然这种方式完全不具备可维护性。所以有第二种模板方式:

  1. <html>
  2. <head>
  3. <title>{{ title }}</title>
  4. </head>
  5. <body>
  6. {{ body }}
  7. </body>
  8. </html>

ASP、JSP、PHP等都是用这种模板方式生成前端页面。

如果在页面上大量使用JavaScript(事实上大部分页面都会),模板方式仍然会导致JavaScript代码与后端代码绑得非常紧密,以至于难以维护。其根本原因在于负责显示的HTML DOM模型与负责数据和交互的JavaScript代码没有分割清楚。

要编写可维护的前端代码绝非易事。和后端结合的MVC模式已经无法满足复杂页面逻辑的需要了,所以,新的MVVM:Model View ViewModel模式应运而生。

MVVM最早由微软提出来,它借鉴了桌面应用程序的MVC思想,在前端页面中,把Model用纯JavaScript对象表示:

  1. <script>
  2. var blog = {
  3. name: 'hello',
  4. summary: 'this is summary',
  5. content: 'this is content...'
  6. };
  7. </script>

View是纯HTML:

  1. <form action="/api/blogs" method="post">
  2. <input name="name">
  3. <input name="summary">
  4. <textarea name="content"></textarea>
  5. <button type="submit">OK</button>
  6. </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

  1. {% extends '__base__.html' %}
  2. {% block title %}编辑日志{% endblock %}
  3. {% block beforehead %}
  4. <script>
  5. var
  6. action = '{{ action }}',
  7. redirect = '{{ redirect }}';
  8. var vm;
  9. $(function () {
  10. vm = new Vue({
  11. el: '#form-blog',
  12. data: {
  13. name: '',
  14. summary: '',
  15. content: ''
  16. },
  17. methods: {
  18. submit: function (event) {
  19. event.preventDefault();
  20. postApi(action, this.$data, function (err, r) {
  21. if (err) {
  22. alert(err);
  23. }
  24. else {
  25. alert('保存成功!');
  26. return location.assign(redirect);
  27. }
  28. });
  29. }
  30. }
  31. });
  32. });
  33. </script>
  34. {% endblock %}
  35. {% block content %}
  36. <div class="uk-width-1-1">
  37. <form id="form-blog" v-on="submit: submit" class="uk-form uk-form-stacked">
  38. <div class="uk-form-row">
  39. <div class="uk-form-controls">
  40. <input v-model="name" class="uk-width-1-1">
  41. </div>
  42. </div>
  43. <div class="uk-form-row">
  44. <div class="uk-form-controls">
  45. <textarea v-model="summary" rows="4" class="uk-width-1-1"></textarea>
  46. </div>
  47. </div>
  48. <div class="uk-form-row">
  49. <div class="uk-form-controls">
  50. <textarea v-model="content" rows="8" class="uk-width-1-1"></textarea>
  51. </div>
  52. </div>
  53. <div class="uk-form-row">
  54. <button type="submit" class="uk-button uk-button-primary">保存</button>
  55. </div>
  56. </form>
  57. </div>
  58. {% endblock %}

初始化Vue时,我们指定3个参数:

el:根据选择器查找绑定的View,这里是#form-blog,就是id为form-blog的DOM,对应的是一个&lt;form&gt;标签;

data:JavaScript对象表示的Model,我们初始化为{ name: '', summary: '', content: ''}

methods:View可以触发的JavaScript函数,submit就是提交表单时触发的函数。

接下来,我们在&lt;form&gt;标签中,用几个简单的v-model,就可以让Vue把Model和View关联起来:

  1. <!-- input的value和Model的name关联起来了 -->
  2. <input v-model="name" class="uk-width-1-1">

Form表单通过&lt;form v-on="submit: submit"&gt;把提交表单的事件关联到submit方法。

需要特别注意的是,在MVVM中,Model和View是双向绑定的。如果我们在Form中修改了文本框的值,可以在Model中立刻拿到新的值。试试在表单中输入文本,然后在Chrome浏览器中打开JavaScript控制台,可以通过vm.name访问单个属性,或者通过vm.$data访问整个Model:

mvvm-1

如果我们在JavaScript逻辑中修改了Model,这个修改会立刻反映到View上。试试在JavaScript控制台输入vm.name = 'MVVM简介',可以看到文本框的内容自动被同步了:

mvvm-2

双向绑定是MVVM框架最大的作用。借助于MVVM,我们把复杂的显示逻辑交给框架完成。由于后端编写了独立的REST API,所以,前端用AJAX提交表单非常容易,前后端分离得非常彻底。

原文: https://wizardforcel.gitbooks.io/liaoxuefeng/content/py2/105.html