django基础01
创建项目
-
通过命令行的方式:首先要进入到安装了django的虚拟环境中。然后执行命令:
django-admin startproject [项目的名称]
这样就可以在当前目录下创建一个项目了。
-
通过pycharm的方式:文件->新建项目->选择django。然后指定项目所在的路径,以及Python解释器,再点击Create就可以创建项目了。
运行项目
-
终端:进入到项目文件夹中,然后执行以下命令即可运行:
python manage.py runserver
-
pycharm:直接点击右上角的绿色三角箭头按钮就可以了。注意:用pycharm运行项目,要避免一个项目运行多次。。在项目配置中,把“只用单一实例”那个选项勾选上,避免以上的问题。
改变端口号
- 在终端:运行的时候加上一个端口号就可以了。命令为:
python manage.py runserver 9000
。 - 在pycharm中:右上角->项目配置->port。改成你想要的端口号,重新运行。
让同局域网中的其他电脑访问本机的项目
-
让项目运行到额时候,host为0.0.0.0。
- 在终端,使用命令:
python manage.py runserver 0.0.0.0:8000
。 - 在pycharm,右上角->项目配置->host。改成
0.0.0.0
。
- 在终端,使用命令:
-
在
settings.py
文件中,配置ALLOWED_HOSTS
,将本机的ip地址添加进去。示例代码如下:ALLOWED_HOSTS = ['192.168.0.103']
注意:要关闭自己电脑的防火墙才行。
项目结构分析
manange.py
:以后和项目交互基本上都是基于这个文件。一般都是在终端输入python manage.py [子命令]。可以输入python manage.py help看下能做什么事情。除非你知道你自己在做什么,一般情况下不应该编辑这个文件。settings.py
:保存项目所有的配置信息。urls.py
:用来做url与视图函数映射的。以后来了一个请求,就会从这个文件中找到匹配的视图函数。wsig.py
:专门用来做部署的。不需要修改。
django推荐的项目规范
按照功能或者模块进行分层,分成一个个app。所有和某个模块相关的视图都写在对应的app的views.py中,并且模型和其他的也是类似。然后django已经提供了一个比较方便创建app的命令叫做python manage.py startapp [app的名称]
。把所有的代码写在各自的app中。
DEBUG模式
- 如果开启了DEBUG模式,那么以后我们修改了Django项目的代码,然后按下ctrl+s,那么Django就会自动的给我们重启项目,不需要手动重启。
- 如果开启了DEBUG模式,那么以后Django项目中的代码出现bug了,那么在浏览器中和控制台会打印出错信息。
- 在生产环境中,禁止开启DEBUG模式,不然有很大的安全隐患。
- 如果将DEBUG设置为False,那么必须要设置ALLOWED_HOSTS.
ALLOWED_HOSTS
这个变量是用来设置以后别人只能通过这个变量中的ip地址或者域名来进行访问。
前端参数传递
-
采用url路径中使用PATH的方式传递参数,采用
<int:id>
的方式来传递,一定要在视图函数中的参数中对参数进行接收,否则报错 -
采用查询字符串的方式,在url后面加上
?xxx=xxx
的方式来传递参数,后端接收参数使用request.GET.get("xxx")
的方式来获取参数 -
使用表单的方式来传递,在后端使用
request.POST.get(“xxx”)
来获取前端传递的参数 -
使用json的方式进行传递,在后端使用
data = request.body.decode("utf-8")
和json.loads(data)
来获取json格式的数据
url转换器
使用格式/<int:id>/
的格式来使用转换器,如果不指定转换器类型,默认使用的是str转换器
django默认的转换器
DEFAULT_CONVERTERS = {
'int': IntConverter(),
'path': PathConverter(),
'slug': SlugConverter(),
'str': StringConverter(),
'uuid': UUIDConverter(),
}
class IntConverter:
regex = '[0-9]+'
def to_python(self, value):
return int(value)
def to_url(self, value):
return str(value)
def register_converter(converter, type_name):
REGISTERED_CONVERTERS[type_name] = converter()
get_converters.cache_clear()
- 自定义url转换器
参照官方的转换器写法定义一个转换器类,将这个转换器类注册到DEFAULT_CONVERTERS中
1、定义一个类,直接继承自object就可以
2、在类中定义一个属性regex,这个属性是用来限制url转换器规则的正则表达式。
3、实现to_python(self,value)方法,这个方法是将url中的值转换下,然后传给视图函数的。
4、实现to_url(self,value)方法,这个方法是在做url反转的时候,将传进来的参数转换后拼接成一个正确的url。
5、将定义好的转换器,使用'django.urls.converters.register_converter'方法注册到django中。
from django.urls import register_converter
class CategoryConverter(object):
regex = r'\w+|(\w+\+\w+)+'
def to_python(self, value):
# 将url里的'python+django+pandas'转换成:['python', 'django', 'pandas']传给视图函数
result = value.split('+')
return result
def to_url(self, value):
if isinstance(value, list):
# 将视图函数里的['python', 'django', 'pandas']转换成'python+django+pandas'传给URL
result = '+'.join(value)
return result
else:
raise RuntimeError('转换url的时候,分类参数必须为列表')
# register_converter(上面自己定义的类名,自定义的类型名(在urls.py文件中使用))
register_converter(CategoryConverter, 'cate')
在app根目录下的__init__.py中添加:
from . import converters
在urls.py中使用即可,如:
path('article/<cate:classify>',views.article_classify_list,name='article_classify'),
urls模块化
如果项目变得越来越大。那么url会变得越来越多。如果都放在主urls.py
文件中,那么将不太好管理。因此我们可以将每个app自己的urls放到自己的app中进行管理。一般我们会在app中新建一个urls.py文件用来存储所有和这个app相关的子url。
需要注意的地方:
- 应该使用
include
函数包含子urls.py
,并且这个urls.py
的路径是相对于项目的路径。示例代码如下:urlpatterns = [ path('admin/', admin.site.urls), path('book',include('book.urls')) ]
- 在
app
的urls.py
中,所有的url匹配也要放在一个叫做urlpatterns
的变量中,否则找不到。 url
是会根据主urls.py
和app中的urls.py
进行拼接的,因此注意不要多加斜杠。
include函数的用法
- include(module,namespace=None):
- module:子url的模块字符串。
- namespace:实例命名空间。这个地方需要注意一点。如果指定实例命名空间,那么前提必须要先指定应用命名空间。也就是在子
urls.py
中添加app_name
变量。
- include((pattern_list, app_namespace), namespace=None):
include
函数的第一个参数既可以为一个字符串,也可以为一个元组,如果是元组,那么元组的第一个参数是子urls.py
模块的字符串,元组的第二个参数是应用命名空间。也就是说,应用命名空间既可以在子urls.py
中通过app_name
指定,也可以在include
函数中指定。 - include(pattern_list):
pattern_list
是一个列表。这个列表中装的是path
或者re_path
函数。实例代码如下:path('movie/',include([ path('',views.movie), path('list/',views.movie_list), ]))
url反转和重定向
需要用到i的函数from django.shortcuts import redirect,resolve_url
url反转需要在url定义的时候给url取个名字,在urls.py记得使用app_name指定应用命名空间,以后在做反转的时候front:index
来反转index对应的的url
重定向直接调用redirect(args) 参数可以是一个模型,或者是url字符串或者视图函数的名字
reverse用法
-
如果在反转url的时候,需要添加参数,那么可以传递
kwargs
参数到revers
函数中。示例代码如下:detail_url = reverse('detail',kwargs={"article_id":1,'page':2})
-
如果想要添加查询字符串的参数,则必须手动的进行拼接。示例代码如下:
login_url = reverse('login') + "?next=/"
偏函数
在Python中的functools中partial来实现 ,这个函数的作用是给有固定参数的函数一个简单的封装
def _index(arg1,arg2,arg3=None):
print(arg1)
print(arg2)
print(arg3)
from functools import partial
index = partial(_index,2,arg3=4)
index(3)
>>>
2
3
4
URL映射的时候指定默认参数
使用path或者是re_path的后,在route中都可以包含参数,而有时候想指定默认的参数,这时候可以通过以下方式来完成。示例代码如下:
from django.urls import path
from . import views
urlpatterns = [
path('blog/', views.page),
path('blog/page<int:num>/', views.page),
]
# View (in blog/views.py)
def page(request, num=1):
# Output the appropriate page of blog entries, according to num.
...
当在访问blog/的时候,因为没有传递num参数,所以会匹配到第一个url,这时候就执行view.page这个视图函数,而在page函数中,又有num=1这个默认参数。因此这时候就可以不用传递参数。而如果访问blog/1的时候,因为在传递参数的时候传递了num,因此会匹配到第二个url,这时候也会执行views.page,然后把传递进来的参数传给page函数中的num。
re_path用法
- re_path和path的作用都是一样的。只不过
re_path
是在写url的时候可以用正则表达式,功能更加强大。 - 写正则表达式都推荐使用原生字符串。也就是以
r
开头的字符串。 - 在正则表达式中定义变量,需要使用圆括号括起来。这个参数是有名字的,那么需要使用
?P<参数的名字>
。然后在后面添加正则表达式的规则。示例代码如下:from django.urls import re_path from . import views urlpatterns = [ # r"":代表的是原生字符串(raw) re_path(r'^$',views.article), # /article/list/<year>/ re_path(r"^list/(?P<year>\d{4})/$",views.article_list), re_path(r"^list/(?P<month>\d{2})/$",views.article_list_month) ]
- 如果不是特别要求。直接使用
path
就够了,省的把代码搞的很麻烦(因为正则表达式其实是非常晦涩的,特别是一些比较复杂的正则表达式,今天写的明天可能就不记得了)。除非是url中确实是需要使用正则表达式来解决才使用re_path
。
为什么需要url命名?
因为url是经常变化的。如果在代码中写死可能会经常改代码。给url取个名字,以后使用url的时候就使用他的名字进行反转就可以了,就不需要写死url了。
如何给一个url指定名称?
在path
函数中,传递一个name
参数就可以指定。示例代码如下:
urlpatterns = [
path('',views.index,name='index'),
path('login/',views.login,name='login')
]
应用命名空间
在多个app之间,有可能产生同名的url。这时候为了避免反转url的时候产生混淆,可以使用应用命名空间,来做区分。定义应用命名空间非常简单,只要在app
的urls.py
中定义一个叫做app_name
的变量,来指定这个应用的命名空间即可。示例代码如下:
# 应用命名空间
app_name = 'front'
urlpatterns = [
path('',views.index,name='index'),
path('login/',views.login,name='login')
]
以后在做反转的时候就可以使用应用命名空间:url名称
的方式进行反转。示例代码如下:
login_url = reverse('front:login')
应用(app)命名空间和实例命名空间
一个app,可以创建多个实例。可以使用多个url映射同一个app。所以这就会产生一个问题。以后在做反转的时候,如果使用应用命名空间,那么就会发生混淆。为了避免这个问题。我们可以使用实例命名空间。实例命名空间也是非常简单,只要在include
函数中传递一个namespace
变量即可。示例代码如下:
urlpatterns = [
path('',include('front.urls')),
# 同一个app下有两个实例
path('cms1/',include('cms.urls',namespace='cms1')),
path('cms2/',include('cms.urls',namespace='cms2')),
]
以后在做反转的时候,就可以根据实例命名空间来指定具体的url。示例代码如下:
def index(request):
username = request.GET.get("username")
if username:
return HttpResponse('CMS首页')
else:
# 获取当前的命名空间
current_namespace = request.resolver_match.namespace
return redirect(reverse("%s:login"%current_namespace))
视图函数
- 视图函数的第一个参数必须是request。这个参数绝对不能少。
- 视图函数的返回值必须是
django.http.response.HttpResponseBase
的子类的对象。