如何建立第一个Django工程
第一步,创建工程:
在PyCharm中,选择File->New Project, 如下所示,输入项目名称和Python解释器版本,点击Create创建工程。
创建后,Django将自动生成如下的目录结构:
- 与项目同名的day_django的目录中是配置文件。
- settings.py 是主配置文件
- urls.py 是路由文件
- wsgi.py 是网络通信接口
- templates目录用来存放HTML文件,也就是MTV中的T.
- manager.py 是django项目管理文件, 是django的管理主程序。
第二步,测试Django服务是否可以正常启动:
- 运行服务器
python manage.py runserver 0.0.0.0:8001
- 打开测试网页
http://localhost:8000
第三步,创建APP:
每个django项目中可以包含多个APP,相当于一个大型项目中的分系统、子模块、功能部件等,相互之间比较独立,但也有联系。所有的APP共享项目资源。
在pycharm下方的terminal中输入如下命令:
python manage.py startapp cmdb
就创建了一个名为cmdb的APP,django自动生成如下目录:
第四步,编写路由:
路由都在urls文件里面,它将浏览器输入的url映射到相应的业务处理逻辑。
多个APP的时候,可以在每个app下面放置一个urls.py文件层次较为清晰:
第五步,编写业务处理逻辑:
- 业务处理逻辑都在views.py中,做如下修改:
第六步,运行web服务:
通过以上的修改,我们将index这个url指向了views里面的index()函数,它接收用户请求,并返回一个字符串。
- 启动web服务:
(Django内置了了一个用纯python写的轻量级web服务器,这样就可以不配置用于生产环境的服务器(比如Apache/IIS),而快速开发产品,直至准备好上线。
注意:不要在任何生产环境中使用这个服务器,仅仅用于开发。)
- 命令行方式,在PyCharm的terminal中运行如下命令:
python manager.py runserver 127.0.0.1:8000
- GUI方式
第七步,返回HTML文件:
(关于如何返回Json或Http格式的非HTML静态文件,后面会加以说明)
首先,我们写一个index.html(注意:在templates下面)
然后,修改一下views.py文件:
默认情况下,django会从templates文件夹中查找我们的html文件,因为settings中有如下配置:
所以如果文件默认就在templates中,否则,我们需要在这里增加查找路径。
重启web服务,刷新网页就可以看到最新结果。
第八步,使用数据库:
为什么使用数据库?
虽然上面和用户交互的很好,但是并没有保存任何数据,页面一旦关闭,或者服务器重启,将回到原始社会。比如淘宝/京东的订单,如果没有数据库,会随时丢掉。
django使用自带的ORM框架操作数据库,并且自带轻量级的sqlite3数据库。
首先,注册app,这样的话,我们的数据库就知道应该给哪个app建表。
然后,在settings.py中,配置数据库相关的参数,如果使用自带的sqlite,就不需要修改了。
然后,修改models.py文件:
每个模型都用一个类表示,该类继承自django.db.models.Model。
每个模型都有一些类变量,在模型中每个类变量都代表了数据库中的一个字段,如上面的(user_name, user_pwd),这就是字段的名字,并且是机器可读的格式。将在Python代码中用到它们,把它们用作表的列名。
如果对SQL语句比较熟悉,还可以通过如下命令查看django生成的sql语句:
python manage.py sql app_name
对于sqlite而言,产生的sql语句如下所示:
BEGIN;
CREATE TABLE "UserInfo" (
"id" integer NOT NULL PRIMARY KEY,
"user_name" varchar(32),
"user_pwd" varchar(32),
COMMIT;
然后,创建迁移文件:
python manage.py makemigrations
作用是:通过运行makemigrations告诉Django,已经对模型做了一些更改(在这个例子中,创建了一个新的模型),并且会将这些更改记录为迁移文件。
迁移是Django如何储存模型的变化(以及我们的数据库模式),它们只是磁盘上的文件。当然,我们可以阅读这些迁移文件,位置是
/cmdb/migrations/oo1_initial.py。它被设计成可人为编辑的模式。
然后,使迁移文件生效:
python manage.py migrate
作用是:查看INSTALLED_APPS设置并根据day_django/settings.py文件中的数据库设置创建任何必要的数据库表。
migrate命令会找出还没有被应用的迁移文件(Django使用数据库中一个叫做django_migrations的特殊表来追踪哪些迁移文件已经被应用过),并且在我们的数据库上运行它们,本质上来说,就是是我们的数据库模式和改动后的模型进行同步。
如果某些APP的model没有发生变化,就不会被migrate作用而变化。
将生成、应用迁移文件分成两个命令来执行,是因为有可能需要将迁移文件提交到版本控制系统中,并跟随应用一起发生变化;这样做可以使开发变得更加简单,也对其他开发者以及上线生产非常有用。
第九步,返回Json格式数据:
通常来说,Django只作为后台是一种高效的处理方式,因此通常需要返回Json格式的数据。
其urls中的调用方式并无不同: