Python3教程Web開發實戰梳理-day11(編寫日誌創建頁MVVC)

Day11: 編寫日誌創建頁

在Web開發中,後端代碼寫起來其實是相當容易的。

例如,我們編寫一個用於創建一個Blog的API:

@post('/api/blogs')
def api_create_blog(request, *, name, summary, content):
    check_admin(request)
    if not name or not name.strip():
        raise APIValueError('name', 'name cannot be empty.')
    if not summary or not summary.strip():
        raise APIValueError('summary', 'summary cannot be empty.')
    if not content or not content.strip():
        raise APIValueError('content', 'content cannot be empty.')
    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())
    yield from blog.save()
    return blog

可以看到代碼非常簡潔,編寫後端Python代碼不但很簡單,而且非常容易測試,上面的API:api_create_blog()本身只是一個普通函數。

Web開發真正困難的地方在於編寫前端頁面。前端頁面需要混合HTML、CSS和JavaScript,如果對這三者沒有深入地掌握,編寫的前端頁面將很快難以維護。

更大的問題在於,前端頁面通常是動態頁面,也就是說,前端頁面往往是由後端代碼生成的。

現在比較流行的ASP、JSP、PHP等生成前端頁面的模板形式多爲如下:

<html>
<head>
    <title>{{ title }}</title>
</head>
<body>
    {{ body }}
</body>
</html>

如果在頁面上大量使用JavaScript(事實上大部分頁面都會),模板方式仍然會導致JavaScript代碼與後端代碼綁得非常緊密,以至於難以維護。其根本原因在於負責顯示的HTML DOM模型與負責數據和交互的JavaScript代碼沒有分割清楚。

要編寫可維護的前端代碼絕非易事。和後端結合的MVC模式已經無法滿足複雜頁面邏輯的需要了,所以,新的MVVM:Model View ViewModel模式應運而生。

它借鑑了桌面應用程序的MVC思想,在前端頁面中,把Model用純JavaScript對象表示,View是純HTML

由於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
    ID = '{{ id }}',
    action = '{{ action }}';
function initVM(blog) {
    var vm = new Vue({
        el: '#vm',
        data: blog,
        methods: {
            submit: function (event) {
                event.preventDefault();
                var $form = $('#vm').find('form');
                $form.postJSON(action, this.$data, function (err, r) {
                    if (err) {
                        $form.showFormError(err);
                    }
                    else {
                        return location.assign('/api/blogs/' + r.id);
                    }
                });
            }
        }
    });
    $('#vm').show();
}
$(function () {
    if (ID) {
        getJSON('/api/blogs/' + ID, function (err, blog) {
            if (err) {
                return fatal(err);
            }
            $('#loading').hide();
            initVM(blog);
        });
    }
    else {
        $('#loading').hide();
        initVM({
            name: '',
            summary: '',
            content: ''
        });
    }
});
</script>

{% endblock %}

{% block content %}

    <div class="uk-width-1-1 uk-margin-bottom">
        <div class="uk-panel uk-panel-box">
            <ul class="uk-breadcrumb">
                <li><a href="/manage/comments">評論</a></li>
                <li><a href="/manage/blogs">日誌</a></li>
                <li><a href="/manage/users">用戶</a></li>
            </ul>
        </div>
    </div>

    <div id="error" class="uk-width-1-1">
    </div>

    <div id="loading" class="uk-width-1-1 uk-text-center">
        <span><i class="uk-icon-spinner uk-icon-medium uk-icon-spin"></i> 正在加載...</span>
    </div>

    <div id="vm" class="uk-width-2-3">
        <form v-on="submit: submit" class="uk-form uk-form-stacked">
            <div class="uk-alert uk-alert-danger uk-hidden"></div>
            <div class="uk-form-row">
                <label class="uk-form-label">標題:</label>
                <div class="uk-form-controls">
                    <input v-model="name" name="name" type="text" placeholder="標題" class="uk-width-1-1">
                </div>
            </div>
            <div class="uk-form-row">
                <label class="uk-form-label">摘要:</label>
                <div class="uk-form-controls">
                    <textarea v-model="summary" rows="4" name="summary" placeholder="摘要" class="uk-width-1-1" style="resize:none;"></textarea>
                </div>
            </div>
            <div class="uk-form-row">
                <label class="uk-form-label">內容:</label>
                <div class="uk-form-controls">
                    <textarea v-model="content" rows="16" name="content" placeholder="內容" class="uk-width-1-1" style="resize:none;"></textarea>
                </div>
            </div>
            <div class="uk-form-row">
                <button type="submit" class="uk-button uk-button-primary"><i class="uk-icon-save"></i> 保存</button>
                <a href="/manage/blogs" class="uk-button"><i class="uk-icon-times"></i> 取消</a>
            </div>
        </form>
    </div>

{% endblock %}

此外,還應該在handlers.py中編寫MVC使得界面可達:

@get('/manage/blogs/create')
def manage_create_blog():
    return {
        '__template__': 'manage_blog_edit.html',
        'id': '',
        'action': '/api/blogs'
    }

在MVVM中,Model和View是雙向綁定的。如果我們在Form中修改了文本框的值,可以在Model中立刻拿到新的值。

雙向綁定是MVVM框架最大的作用。藉助於MVVM,我們把複雜的顯示邏輯交給框架完成。由於後端編寫了獨立的REST API,所以,前端用AJAX提交表單非常容易,前後端分離得非常徹底。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章