写第一个Django应用(一)

通过教程,我们完成一个投票应用:

  1. 一个通用网址:大家可以投票,并查看投票数。
  2. 一个管理员网址: 管理员添加、修改和删除投票数。

默认您的系统已经安装了Django。您可以在终端输入下面的命令来查看Django的版本。

$ python -m django --version

创建项目

如果您是初次使用Django,您需要建立Django的项目,它包含一个Django实例的配置集,比如:数据库的参数、Django的参数和一些应用的参数。
进入终端,cd进入工作目录,然后输入下面的命令:

$ django-admin startproject mysite

它会在你的工作目录里创建一个mysite的文件夹。

  • 注意:
    您要避免项目名字与Python内置模块或Django组件同名。
  • 项目应该运行在哪里:
    如果您有一个旧版的php项目,那么您需要把它放在web服务器的根目录下(类似于/var/www)。在Django中不必如此。而且把Python脚本放在web服务器的根目录下很不安全,一些黑客很可能看到网站的全部代码。所以把您的代码放在其他的目录下(类似于/home/mycode)。

下面看看startproject创建的文件吧:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        wsgi.py  

这些文件的作用如下:

  • 外层的mysite/是容纳项目的容器。它的名字不重要,所以您可以任意命名它。
  • manage.py: 一个命令行组件,它有助于在Python的promt里与Django的交互。
  • 内层的mysite/是您项目真正的Python包。它是一个Python包,所以可以导入该包的所有对象(比如mysite.urls)。
  • mysite/__init__.py:一个空文件,用来告知Python该目录是一个包。
  • mysite/settings.py:该Django项目的设置/配置。
  • mysite/urls.py:该项目的所有url映射。
  • mysite/wsgi.py:待续。。。

开发模式下的服务器

开始验证您的Django项目能否运行。进入外层的mysite目录,然后运行下列命令:

$ python manage.py runserver

该命令的输出应该是:

...
...
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.


您已经启动了一个Django用以开发的服务器,它是一个用Python写的轻量服务器。用它能快速地进行开发,而不用去管服务器的配置。当然该服务器不能用以发布产品。
好了,现在您可以在浏览器的网址栏输入```http://127.0.0.1:8000```。您会看到Django的欢迎页面```Welcome to Django```。
>###### 更换端口:
**runserver**默认运行的服务器地址是端口为8000的回送地址(```127.0.0.1:8000```)
如果您想要更换服务器的端口,需要在命令行里多加一个端口参数。比如,下面的命令会在8080端口启动服务器:
```$ python manage.py runserver 8080```

如果您想要更换服务器的ip和端口,可以监听所有的公用ip(在局域网里的电脑都能显示您的项目):
```$ python manage.py 0.0.0.0:8080```

>###### 服务器自动重新加载:
当有请求到来的时候,开发服务器会自动重新加载Python代码。所以代码修改后,您不必为了让代码生效来重启服务器。但是,像增加文件等一些行为是需要重启服务器的。

#### 创建投票应用
现在,在您的工作目录里已经有了一个项目。接下来该创建应用了。
在Django里写的每一个应用都有相同的一些内容。所以Django开发了一个组件用来生成一个应用需要的基础目录。
>###### 项目和应用的比较:
项目和应用的不同处有哪些方面?一个应用是一个webapp,它具有特定的功能,能够完成某项任务。比如一个博客系统,一个公共评论区或者一个简单的投票系统。而一个项目是配置和应用的集合。一个项目可以包含多个应用,一个应用也可以部署在多个项目里。

您的应用应该放在Python path里。在本教程中,我们创建的应用放在**manage.py**旁,它将会被视为顶级的模块,而不是**mysite**的子模块。
下面是创建应用目录的命令:
>```$ python manage.py startapp polls```

生成的应用目录如下:

polls/
init.py
admin.py
apps.py
migrations/
init.py
urls.py
models.py
tests.py
views.py

#### 写第一个视图函数
开始写第一个视图函数。打开并编辑文件**polls/views.py**,需要添加的内容如下:

from django.http import HttpResponse

def index(request):
return HttpResponse(r"

Hello world! You're in the index page!

")

在**polls/urls.py**中添加以下代码:

from django.conf.urls import url
from . import views

urlpatterns = [
url(r'^index/$', views.index, name='index'),
]

下面需要在**site/urls**模块添加应用的根级url映射(需要引用django.conf.urls.include)。

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

urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^polls/', include('polls.urls')),
]

**include()**函数可以引用其他的URLs。注意,**include()**里的正则表达式,没有**$**(结束标志),但是有斜杠。当Django处理**include()**时,它将url分割开,一部分与正则表达式相匹配,另外一部分发送到下一层的url映射进行处理。
>什么时候使用include():
除了**admin.site.urls**之外,都需要使用include()来包含应用的urls。

在浏览器地址栏输入```http://localhost:8000/polls```,验证**index**视图能否工作。
**url()**函数需要传入四个参数,两个必须传入的:**正则表达式**和**视图函数**,两个可选参数:**字典**和**url名字**。让我们再来看下这些参数的作用:
- **正则表达式**:在文本中匹配某一种模式。
- **视图函数**:当Django找到一个正则表达式的匹配项,Django会调用对应的视图函数,它会返回一个**HttpResponse**对象。
- **字典**:任意个键值对参数都可以放进一个字典中传入到视图函数。

你可能感兴趣的:(写第一个Django应用(一))