1. Day 11 - 编写日志创建页
    2. 阅读: 9903
    3. Web开发中,后端代码写起来其实是相当容易的。
    4. 例如,我们编写一个REST API,用于创建一个Blog
    5. @post('/api/blogs')
    6. def api_create_blog(request, *, name, summary, content):
    7. check_admin(request)
    8. if not name or not name.strip():
    9. raise APIValueError('name', 'name cannot be empty.')
    10. if not summary or not summary.strip():
    11. raise APIValueError('summary', 'summary cannot be empty.')
    12. if not content or not content.strip():
    13. raise APIValueError('content', 'content cannot be empty.')
    14. blog = Blog(user_id=request.__user__.id, user_name=request.__user__.name, user_image=request.__user__.image, name=name.strip(), summary=summary.strip(), content=content.strip())
    15. yield from blog.save()
    16. return blog
    17. 编写后端Python代码不但很简单,而且非常容易测试,上面的APIapi_create_blog()本身只是一个普通函数。
    18. Web开发真正困难的地方在于编写前端页面。前端页面需要混合HTMLCSSJavaScript,如果对这三者没有深入地掌握,编写的前端页面将很快难以维护。
    19. 更大的问题在于,前端页面通常是动态页面,也就是说,前端页面往往是由后端代码生成的。
    20. 生成前端页面最早的方式是拼接字符串:
    21. s = '<html><head><title>'
    22. + title
    23. + '</title></head><body>'
    24. + body
    25. + '</body></html>'
    26. 显然这种方式完全不具备可维护性。所以有第二种模板方式:
    27. <html>
    28. <head>
    29. <title>{{ title }}</title>
    30. </head>
    31. <body>
    32. {{ body }}
    33. </body>
    34. </html>
    35. ASPJSPPHP等都是用这种模板方式生成前端页面。
    36. 如果在页面上大量使用JavaScript(事实上大部分页面都会),模板方式仍然会导致JavaScript代码与后端代码绑得非常紧密,以至于难以维护。其根本原因在于负责显示的HTML DOM模型与负责数据和交互的JavaScript代码没有分割清楚。
    37. 要编写可维护的前端代码绝非易事。和后端结合的MVC模式已经无法满足复杂页面逻辑的需要了,所以,新的MVVMModel View ViewModel模式应运而生。
    38. MVVM最早由微软提出来,它借鉴了桌面应用程序的MVC思想,在前端页面中,把Model用纯JavaScript对象表示:
    39. <script>
    40. var blog = {
    41. name: 'hello',
    42. summary: 'this is summary',
    43. content: 'this is content...'
    44. };
    45. </script>
    46. View是纯HTML
    47. <form action="/api/blogs" method="post">
    48. <input name="name">
    49. <input name="summary">
    50. <textarea name="content"></textarea>
    51. <button type="submit">OK</button>
    52. </form>
    53. 由于Model表示数据,View负责显示,两者做到了最大限度的分离。
    54. ModelView关联起来的就是ViewModelViewModel负责把Model的数据同步到View显示出来,还负责把View的修改同步回Model
    55. ViewModel如何编写?需要用JavaScript编写一个通用的ViewModel,这样,就可以复用整个MVVM模型了。
    56. 好消息是已有许多成熟的MVVM框架,例如AngularJSKnockoutJS等。我们选择Vue这个简单易用的MVVM框架来实现创建Blog的页面templates/manage_blog_edit.html
    57. {% extends '__base__.html' %}
    58. {% block title %}编辑日志{% endblock %}
    59. {% block beforehead %}
    60. <script>
    61. var
    62. ID = '{{ id }}',
    63. action = '{{ action }}';
    64. function initVM(blog) {
    65. var vm = new Vue({
    66. el: '#vm',
    67. data: blog,
    68. methods: {
    69. submit: function (event) {
    70. event.preventDefault();
    71. var $form = $('#vm').find('form');
    72. $form.postJSON(action, this.$data, function (err, r) {
    73. if (err) {
    74. $form.showFormError(err);
    75. }
    76. else {
    77. return location.assign('/api/blogs/' + r.id);
    78. }
    79. });
    80. }
    81. }
    82. });
    83. $('#vm').show();
    84. }
    85. $(function () {
    86. if (ID) {
    87. getJSON('/api/blogs/' + ID, function (err, blog) {
    88. if (err) {
    89. return fatal(err);
    90. }
    91. $('#loading').hide();
    92. initVM(blog);
    93. });
    94. }
    95. else {
    96. $('#loading').hide();
    97. initVM({
    98. name: '',
    99. summary: '',
    100. content: ''
    101. });
    102. }
    103. });
    104. </script>
    105. {% endblock %}
    106. {% block content %}
    107. <div class="uk-width-1-1 uk-margin-bottom">
    108. <div class="uk-panel uk-panel-box">
    109. <ul class="uk-breadcrumb">
    110. <li><a href="/manage/comments">评论</a></li>
    111. <li><a href="/manage/blogs">日志</a></li>
    112. <li><a href="/manage/users">用户</a></li>
    113. </ul>
    114. </div>
    115. </div>
    116. <div id="error" class="uk-width-1-1">
    117. </div>
    118. <div id="loading" class="uk-width-1-1 uk-text-center">
    119. <span><i class="uk-icon-spinner uk-icon-medium uk-icon-spin"></i> 正在加载...</span>
    120. </div>
    121. <div id="vm" class="uk-width-2-3">
    122. <form v-on="submit: submit" class="uk-form uk-form-stacked">
    123. <div class="uk-alert uk-alert-danger uk-hidden"></div>
    124. <div class="uk-form-row">
    125. <label class="uk-form-label">标题:</label>
    126. <div class="uk-form-controls">
    127. <input v-model="name" name="name" type="text" placeholder="标题" class="uk-width-1-1">
    128. </div>
    129. </div>
    130. <div class="uk-form-row">
    131. <label class="uk-form-label">摘要:</label>
    132. <div class="uk-form-controls">
    133. <textarea v-model="summary" rows="4" name="summary" placeholder="摘要" class="uk-width-1-1" style="resize:none;"></textarea>
    134. </div>
    135. </div>
    136. <div class="uk-form-row">
    137. <label class="uk-form-label">内容:</label>
    138. <div class="uk-form-controls">
    139. <textarea v-model="content" rows="16" name="content" placeholder="内容" class="uk-width-1-1" style="resize:none;"></textarea>
    140. </div>
    141. </div>
    142. <div class="uk-form-row">
    143. <button type="submit" class="uk-button uk-button-primary"><i class="uk-icon-save"></i> 保存</button>
    144. <a href="/manage/blogs" class="uk-button"><i class="uk-icon-times"></i> 取消</a>
    145. </div>
    146. </form>
    147. </div>
    148. {% endblock %}
    149. 初始化Vue时,我们指定3个参数:
    150. el:根据选择器查找绑定的View,这里是#vm,就是idvmDOM,对应的是一个<div>标签;
    151. dataJavaScript对象表示的Model,我们初始化为{ name: '', summary: '', content: ''};
    152. methodsView可以触发的JavaScript函数,submit就是提交表单时触发的函数。
    153. 接下来,我们在<form>标签中,用几个简单的v-model,就可以让VueModelView关联起来:
    154. <!-- inputvalueModelname关联起来了 -->
    155. <input v-model="name" class="uk-width-1-1">
    156. Form表单通过<form v-on="submit: submit">把提交表单的事件关联到submit方法。
    157. 需要特别注意的是,在MVVM中,ModelView是双向绑定的。如果我们在Form中修改了文本框的值,可以在Model中立刻拿到新的值。试试在表单中输入文本,然后在Chrome浏览器中打开JavaScript控制台,可以通过vm.name访问单个属性,或者通过vm.$data访问整个Model
    158. 如果我们在JavaScript逻辑中修改了Model,这个修改会立刻反映到View上。试试在JavaScript控制台输入vm.name = 'MVVM简介',可以看到文本框的内容自动被同步了:
    159. 双向绑定是MVVM框架最大的作用。借助于MVVM,我们把复杂的显示逻辑交给框架完成。由于后端编写了独立的REST API,所以,前端用AJAX提交表单非常容易,前后端分离得非常彻底。
    160. 参考源码
    161. day-11