后端Django + 前端Vue.js快速搭建web项目

  • Z时代
  • 2024-01-10
  • 分类：综合

vue

后端Django + 前端Vue.js快速搭建web项目

2018年06月14日 15:03:11 jack_wise 阅读数：4798

参考网上一篇文章做了点细节补充。

本篇使用Vue.js作为前端框架，代替Django本身较为孱弱的模板引擎，Django则作为服务端提供api接口，使得前后端实现完全分离，更适合单页应用的开发构建。

一、 环境准备

安装环境：

Django系：

Python 3.6 +

Django 1.11.13

Mysql 5.7

Python的MySQL相关模块等

推荐python相关的模块（包括Django）都使用python自带的pip安装器安装。命令：pip install django即可安装最新版本的django,或者pip install django==1.11.13安装指定版本

Vue.js系：

Node.js 8.11.2

有关Vue的模块(包括vue)可以使用node自带的npm包管理器安装。推荐使用淘宝的 cnpm  命令行工具代替默认的 npm

npm install -g cnpm --registry=https://registry.npm.taobao.org

二、 构建Django项目

我们首先使用Django来搭建web后端api框架。

1、 先在终端敲入命令：

django-admin startproject myproject

目录结构：

2、 进入项目根目录，创建一个app：

python manage.py startapp myapp

目录结构：

3、 在myproject下的settings.py配置文件中，把默认的sqllite3数据库换成我们的mysql数据库：

 

  1. # Database

  2. # https://docs.djangoproject.com/en/1.11/ref/settings/#databases

  3.  

  4. DATABASES = {

  5. 'default': {

  6. 'ENGINE': 'django.db.backends.mysql',

  7. 'NAME': 'testcon',

  8. 'USER': 'root',

  9. 'PASSWORD': '123456',

  10. 'HOST': '127.0.0.1',

  11. }

  12. }

并把app加入到installed_apps列表里：

 

  1. INSTALLED_APPS = [

  2. 'django.contrib.admin',

  3. 'django.contrib.auth',

  4. 'django.contrib.contenttypes',

  5. 'django.contrib.sessions',

  6. 'django.contrib.messages',

  7. 'django.contrib.staticfiles',

  8. 'myapp',

  9. ]

4、 在app目录下的models.py里我们简单写一个model如下：

 

  1. # -*- coding: utf-8 -*-

  2. from __future__ import unicode_literals

  3.  

  4. from django.db import models

  5.  

  6. # Create your models here.

  7. class Book(models.Model):

  8. book_name = models.CharField(max_length=64)

  9. add_time = models.DateTimeField(auto_now_add=True)

  10.  

  11. def __unicode__(self):

  12. return self.book_name

只有两个字段，书名book_name和添加时间add_time。如果没有指定主键的话django会自动新增一个自增id作为主键

5、 在app目录下的views里我们新增两个接口，一个是show_books返回所有的书籍列表（通过JsonResponse返回能被前端识别的json格式数据），二是add_book接受一个get请求，往数据库里添加一条book数据：

 

 

  1. from django.shortcuts import render

  2. from django.views.decorators.http import require_http_methods

  3. from django.core import serializers

  4. from django.http import JsonResponse

  5. import json

  6.  

  7. from .models import Book

  8. # Create your views here.

  9.  

  10.  

  11. @require_http_methods(["GET"])

  12. def add_book(request):

  13. response = {}

  14. try:

  15. book = Book(book_name=request.GET.get('book_name'))

  16. book.save()

  17. response['msg'] = 'success'

  18. response['error_num'] = 0

  19. except Exception as e:

  20. response['msg'] = str(e)

  21. response['error_num'] = 1

  22.  

  23. return JsonResponse(response)

  24.  

  25.  

  26. @require_http_methods(["GET"])

  27. def show_books(request):

  28. response = {}

  29. try:

  30. books = Book.objects.filter()

  31. response['list'] = json.loads(serializers.serialize("json", books))

  32. response['msg'] = 'success'

  33. response['error_num'] = 0

  34. except Exception as e:

  35. response['msg'] = str(e)

  36. response['error_num'] = 1

  37.  

  38. return JsonResponse(response)

可以看出，在ORM的帮忙下，我们的接口实际上不需要自己去组织SQL代码

6、 在app目录下，新增一个urls.py文件，把我们新增的两个接口添加到路由里：

from django.conf.urls import url, includeimport views

urlpatterns = [url(r'add_book$', views.add_book, ),url(r'show_books$', views.show_books, ),]

  1. 我们还要把app下的urls添加到project下的urls中，才能完成路由：

 

  1. from django.conf.urls import url, include

  2. from django.contrib import admin

  3. from django.views.generic import TemplateView

  4. import myapp.urls

  5.  

  6. urlpatterns = [

  7. url(r'^admin/', admin.site.urls),

  8. url(r'^api/', include(myapp.urls)),

  9. url(r'^$', TemplateView.as_view(template_name="index.html")),

  10. ]

  1. 在项目的根目录，输入命令：

python manage.py makemigrations myapp

python manage.py migrate

查询数据库，看到book表已经自动创建了：

  1. 在项目的根目录，输入命令：

python manage.py runserver

启动服务，通过postman测试一下我们刚才写的两个接口：

add_book

show_books

三、 构建Vue.js前端项目

1、 先用npm安装vue-cli脚手架工具（vue-cli是官方脚手架工具，能迅速帮你搭建起vue项目的框架）：

    `npm install -g vue-cli`

安装好后，在project项目根目录下，新建一个前端工程目录：

    vue-init webpack appfront  //安装中把vue-router选上，我们须要它来做前端路由

进入appfront目录，运行命令：

    npm install //安装vue所须要的node依赖

 

 npm install  vue-resource 

 npm install element-ui

现在我们可以看到整个文件目录结构是这样的：

2、 在目录src下包含入口文件main.js，入口组件App.vue等。后缀为vue的文件是Vue.js框架定义的单文件组件，其中标签中的内容可以理解为是类html的页面结构内容，标签中的是js的方法、数据方面的内容，而则是css样式方面的内容：

3、 我们在src/component文件夹下新建一个名为Home.vue的组件，通过调用之前在Django上写好的api，实现添加书籍和展示书籍信息的功能。在样式组件上我们使用了饿了么团队推出的element-ui，这是一套专门匹配Vue.js框架的功能样式组件。由于组件的 编码涉及到了很多js、html、css的知识，并不是本文的重点，因此在此只贴出部分代码：

4、 在src/router目录的index.js中，我们把新建的Home组件，配置到vue-router路由中：

5、 如果发现列表抓取不到数据，可能是出现了跨域问题，打开浏览器console确认：

这时候我们须要在Django层注入header，用Django的第三方包django-cors-headers来解决跨域问题：

       pip install django-cors-headers

settings.py 修改：

 

  1. MIDDLEWARE = [

  2. 'django.middleware.security.SecurityMiddleware',

  3. 'django.contrib.sessions.middleware.SessionMiddleware',

  4. 'corsheaders.middleware.CorsMiddleware',

  5. 'django.middleware.common.CommonMiddleware',

  6. 'django.middleware.csrf.CsrfViewMiddleware',

  7. 'django.contrib.auth.middleware.AuthenticationMiddleware',

  8. 'django.contrib.messages.middleware.MessageMiddleware',

  9. 'django.middleware.clickjacking.XFrameOptionsMiddleware',

  10. ]

  11.  

  12. CORS_ORIGIN_ALLOW_ALL = True

  注意中间件的添加顺序

6、 在前端工程目录下，输入npm run dev启动node自带的服务器，浏览器会自动打开， 我们能看到页面：

尝试新增书籍，新增的书籍信息会实时反映到页面的列表中，这得益于Vue.js的数据双向绑定特性。

  1. 在前端工程目录下，输入npm run build，如果项目没有错误的话，就能够看到所有的组件、css、图片等都被webpack自动打包到dist目录下了：

五、 整合Django和Vue.js

目前我们已经分别完成了Django后端和Vue.js前端工程的创建和编写，但实际上它们是运行在各自的服务器上，和我们的要求是不一致的。因此我们须要把Django的TemplateView指向我们刚才生成的前端dist文件即可。

1、 找到project目录的urls.py，使用通用视图创建最简单的模板控制器，访问 『/』时直接返回 index.html:

 

  1. urlpatterns = [

  2. url(r'^admin/', admin.site.urls),

  3. url(r'^api/', include(myapp.urls)),

  4. url(r'^$', TemplateView.as_view(template_name="index.html")),

  5. ]

2、 上一步使用了Django的模板系统，所以需要配置一下模板使Django知道从哪里找到index.html。在project目录的settings.py下：

 

  1. TEMPLATES = [

  2. {

  3. 'BACKEND': 'django.template.backends.django.DjangoTemplates',

  4. 'DIRS': ['appfront/dist'],

  5. 'APP_DIRS': True,

  6. 'OPTIONS': {

  7. 'context_processors': [

  8. 'django.template.context_processors.debug',

  9. 'django.template.context_processors.request',

  10. 'django.contrib.auth.context_processors.auth',

  11. 'django.contrib.messages.context_processors.messages',

  12. ],

  13. },

  14. },

  15. ]

  16.  

3、 我们还需要配置一下静态文件的搜索路径。同样是project目录的settings.py下：

 

  1. # Add for vuejs

  2. STATICFILES_DIRS = [

  3. os.path.join(BASE_DIR, "appfront/dist/static"),

  4. ]

4、 配置完成，我们在project目录下输入命令python manage.py runserver，就能够看到我们的前端页面在浏览器上展现：

注意服务的端口已经是Django服务的8000而不是node服务的8080了

项目源码：

https://github.com/HubDou/vue-django.git

以上是 后端Django + 前端Vue.js快速搭建web项目 的全部内容， 来源链接： utcz.com/z/378199.html

回到顶部