Django框架系列指南 一【1,创建Django工程】

本章节包含,虚拟环境管理,工程创建,子应用创建,测试创建函数视图和路由。

学完本章节,你可以从0到1的访问到自己写的hello world!

一,虚拟环境:

有关虚拟环境你需要熟悉以下命令

1. 创建虚拟环境

mkvirtualenv django_py3_1.11 -p python3

注意需要联网

2. 安装Django

使用django 1.11.11版本,注意需要联网

pip install django==1.11.11

3. 复习虚拟环境和pip的命令

# 虚拟环境
mkvirtualenv  # 创建虚拟环境
rmvirtualenv  # 删除虚拟环境
workon  # 进入虚拟环境、查看所有虚拟环境
deactivate  # 退出虚拟环境

# pip
pip install  # 安装依赖包
pip uninstall  # 卸载依赖包
pip list  # 查看已安装的依赖包
pip freeze  # 冻结当前环境的依赖包

二,工程创建

在django中,项目工程目录可以借助django提供的命令帮助我们创建。

1. 创建

创建工程的命令为:

django-admin startproject 工程名称

例如:想要在桌面的code目录中创建一个名为demo的项目工程,可执行如下命令:

cd ~/Desktop/code
django-admin startproject demo

执行后,会多出一个新目录名为demo,此即为新创建的工程目录。

2. 工程目录说明

查看创建的工程目录,结构如下

 

  • 与项目同名的目录,此处为demo。
  • settings.py 是项目的整体配置文件。
  • urls.py 是项目的URL配置文件。
  • wsgi.py 是项目与WSGI兼容的Web服务器入口。
  • manage.py 是项目管理文件,通过它管理项目。

3. 运行开发服务器

在开发阶段,为了能够快速预览到开发的效果,django提供了一个纯python编写的轻量级web服务器,仅在开发阶段使用。

运行服务器命令如下:

python manage.py runserver ip:端口
或:
python manage.py runserver

可以不写IP和端口,默认IP是127.0.0.1,默认端口为8000

启动后可见如下信息:

Django框架系列指南 一【1,创建Django工程】

 

在浏览器中输入网址“127.0.0.1:8000”便可看到效果。

Django框架系列指南 一【1,创建Django工程】

 

  • django默认工作在调式Debug模式下,如果增加、修改、删除文件,服务器会自动重启。
  • 按ctrl+c停止服务器。

三,创建子应用

 

在Web应用中,通常有一些业务功能模块是在不同的项目中都可以复用的,故在开发中通常将工程项目拆分为不同的子功能模块,各功能模块间可以保持相对的独立,在其他工程项目中需要用到某个特定功能模块时,可以将该模块代码整体复制过去,达到复用。

在Flask框架中也有类似子功能应用模块的概念,即蓝图Blueprint。

Django的视图编写是放在子应用中的。

1. 创建

在django中,创建子应用模块目录仍然可以通过命令来操作,即:

python manage.py startapp 子应用名称

manage.py 为上述创建工程时自动生成的管理文件。

例如,在刚才创建的demo工程中,想要创建一个用户users子应用模块,可执行:

cd ~/Desktop/code/demo
python manage.py startapp users

执行后,可以看到工程目录中多出了一个名为users的子目录。

2. 子应用目录说明

查看此时的工程目录,结构如下:

Django框架系列指南 一【1,创建Django工程】

 

  • admin.py 文件跟网站的后台管理站点配置相关。
  • apps.py 文件用于配置当前子应用的相关信息。
  • migrations 目录用于存放数据库迁移历史文件。
  • models.py 文件用户保存数据库模型类。
  • tests.py 文件用于开发测试用例,编写单元测试。
  • views.py 文件用于编写Web应用视图。

3. 注册安装子应用

创建出来的子应用目录文件虽然被放到了工程项目目录中,但是django工程并不能立即直接使用该子应用,需要注册安装后才能使用。

在工程配置文件settings.py中,INSTALLED_APPS项保存了工程中已经注册安装的子应用,初始工程中的INSTALLED_APPS如下:

Django框架系列指南 一【1,创建Django工程】

 

注册安装一个子应用的方法,即是将子应用的配置信息文件apps.py中的Config类添加到INSTALLED_APPS列表中。

例如,将刚创建的users子应用添加到工程中,可在INSTALLED_APPS列表中添加'users.apps.UsersConfig';

子应用.apps.UserConfig ,这个意思就是在主配置当中,把你的自应用的配置信息导到主应用,这样在初始化项目的时候才能加载和初始化你的项目,UserConfig是在apps.py当中的配置类名

Django框架系列指南 一【1,创建Django工程】

 

四,测试创建函数视图和路由

Django的视图是定义在子应用的views.py中的。

1. 创建

打开刚创建的users模块,在views.py中编写函数视图代码。【后面会介绍更方便的视图创建方法,类视图】

from django.http import HttpResponse

def index(request):
    """
    index视图
    :param request: 包含了请求信息的请求对象
    :return: 响应对象
    """
    return HttpResponse("hello the world!")

说明:

  • 视图函数的第一个传入参数必须定义,用于接收Django构造的包含了请求数据的HttpReqeust对象,通常名为request
  • 视图函数的返回值必须为一个响应对象,不能像Flask一样直接返回一个字符串,可以将要返回的字符串数据放到一个HTTPResponse对象中。

2. 定义路由URL

1) 在子应用中新建一个urls.py文件用于保存该应用的路由。当然,创建完路由,请求怎么找到它呢?需要在总的路由中关联导入,待会儿见;

Django框架系列指南 一【1,创建Django工程】

 

2) 在users/urls.py文件中定义路由信息。

from django.conf.urls import url

from . import views

# urlpatterns是被django自动识别的路由列表变量
urlpatterns = [
    # 每个路由信息都需要使用url函数来构造
    # url(路径, 视图)
    url(r'^index/$', views.index),
]

3) 在工程总路由demo/urls.py中添加子应用的路由数据。

from django.conf.urls import url, include
from django.contrib import admin

urlpatterns = [
    url(r'^admin/', admin.site.urls),  # django默认包含的

    # 添加
    url(r'^users/', include('users.urls')), 
]
  • 使用include来将子应用users里的全部路由包含进工程路由中;
  • r'^users/' 决定了users子应用的所有路由都已/users/开头,如我们刚定义的视图index,其最终的完整访问路径为/users/index/

include函数除了可以传递字符串之外,也可以直接传递应用的urls模块,如

from django.conf.urls import url, include
from django.contrib import admin
import users.urls  # 先导入应用的urls模块

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    # url(r'^users/', include('users.urls')),
    url(r'^users/', include(users.urls)),  # 添加应用的路由
]

4) 启动运行

重新启动django程序

python manage.py runserver

在浏览器中输入网址127.0.0.1:8000/users/index/ 可看到返回的信息

 

Django框架系列指南 一【1,创建Django工程】

到目前为止,就完成类Django的一个简单的入门过程!安装使用,配置,访问到hello world! 

上一篇:django1.11和django2.2中namespace的用法


下一篇:创建goods模型