Python-100-Days/Day41-55/43.静态资源和Ajax请求.md

312 lines
11 KiB
Markdown
Raw Normal View History

2019-05-04 15:53:22 +08:00
## 静态资源和Ajax请求
2018-05-23 13:43:33 +08:00
基于前面两个章节讲解的知识我们已经可以使用Django框架来完成Web应用的开发了。接下来我们就尝试实现一个投票应用具体的需求是用户进入应用首先查看到“学科介绍”页面该页面显示了一个学校所开设的所有学科通过点击某个学科可以进入“老师介绍”页面该页面展示了该学科所有老师的详细情况可以在该页面上给老师点击“好评”或“差评”如果用户没有登录在投票时会先跳转到“登录页”要求用户登录登录成功才能投票对于未注册的用户可以在“登录页”点击“新用户注册”进入“注册页”完成用户注册操作注册成功后会跳转到“登录页”注册失败会获得相应的提示信息。
2018-07-08 22:43:08 +08:00
2018-07-09 11:07:48 +08:00
### 准备工作
2019-05-03 16:00:14 +08:00
由于之前已经详细的讲解了如何创建Django项目以及项目的相关配置因此我们略过这部分内容唯一需要说明的是从上面对投票应用需求的描述中我们可以分析出三个业务实体学科、老师和用户。学科和老师之间通常是一对多关联关系一个学科有多个老师一个老师通常只属于一个学科用户因为要给老师投票所以跟老师之间是多对多关联关系一个用户可以给多个老师投票一个老师也可以收到多个用户的投票。首先修改应用下的models.py文件来定义数据模型先给出学科和老师的模型。
2018-07-08 22:43:08 +08:00
```Python
from django.db import models
2019-05-03 16:00:14 +08:00
class Subject(models.Model):
"""学科"""
2019-06-18 08:25:53 +08:00
no = models.IntegerField(primary_key=True, verbose_name='编号')
name = models.CharField(max_length=20, verbose_name='名称')
intro = models.CharField(max_length=511, default='', verbose_name='介绍')
create_date = models.DateField(null=True, verbose_name='成立日期')
is_hot = models.BooleanField(default=False, verbose_name='是否热门')
def __str__(self):
return self.name
class Meta:
db_table = 'tb_subject'
2019-06-18 08:25:53 +08:00
verbose_name = '学科'
verbose_name_plural = '学科'
class Teacher(models.Model):
"""老师"""
no = models.AutoField(primary_key=True, verbose_name='编号')
2019-06-18 08:25:53 +08:00
name = models.CharField(max_length=20, verbose_name='姓名')
detail = models.CharField(max_length=1023, default='', blank=True, verbose_name='详情')
photo = models.CharField(max_length=1023, default='', verbose_name='照片')
good_count = models.IntegerField(default=0, verbose_name='好评数')
bad_count = models.IntegerField(default=0, verbose_name='差评数')
subject = models.ForeignKey(to=Subject, on_delete=models.PROTECT, db_column='sno', verbose_name='所属学科')
class Meta:
db_table = 'tb_teacher'
2019-06-18 08:25:53 +08:00
verbose_name = '老师'
verbose_name_plural = '老师'
2018-07-08 22:43:08 +08:00
```
2018-07-08 23:22:18 +08:00
模型定义完成后可以通过“生成迁移”和“执行迁移”来完成关系型数据库中二维表的创建当然这需要提前启动数据库服务器并创建好对应的数据库同时我们在项目中已经安装了PyMySQL而且完成了相应的配置这些内容此处不再赘述。
2018-07-08 22:43:08 +08:00
2018-07-08 23:22:18 +08:00
```Shell
(venv)$ python manage.py makemigrations vote
2018-07-08 23:22:18 +08:00
...
(venv)$ python manage.py migrate
...
```
2018-07-08 22:43:08 +08:00
> 注意为了给vote应用生成迁移文件需要修改Django项目settings.py文件在INSTALLED_APPS中添加vote应用。
2020-06-24 08:10:58 +08:00
完成模型迁移之后我们可以直接使用Django提供的后台管理来添加学科和老师信息这需要先注册模型类和模型管理类可以通过修改``。
2018-07-08 22:43:08 +08:00
2018-07-08 23:22:18 +08:00
```SQL
from django.contrib import admin
2019-06-18 08:25:53 +08:00
from poll2.forms import UserForm
from poll2.models import Subject, Teacher
2019-06-18 08:25:53 +08:00
class SubjectAdmin(admin.ModelAdmin):
list_display = ('no', 'name', 'create_date', 'is_hot')
ordering = ('no', )
2019-06-18 08:25:53 +08:00
class TeacherAdmin(admin.ModelAdmin):
list_display = ('no', 'name', 'detail', 'good_count', 'bad_count', 'subject')
ordering = ('subject', 'no')
2019-05-03 16:00:14 +08:00
2019-06-18 08:25:53 +08:00
admin.site.register(Subject, SubjectAdmin)
admin.site.register(Teacher, TeacherAdmin)
2018-07-08 22:43:08 +08:00
```
接下来我们就可以修改views.py文件通过编写视图函数先实现“学科介绍”页面。
```Python
2018-07-08 23:22:18 +08:00
def show_subjects(request):
"""查看所有学科"""
subjects = Subject.objects.all()
return render(request, 'subject.html', {'subjects': subjects})
2018-07-08 23:22:18 +08:00
```
2018-07-08 22:43:08 +08:00
2019-05-03 16:00:14 +08:00
至此,我们还需要一个模板页,模板的配置以及模板页中模板语言的用法在之前已经进行过简要的介绍,如果不熟悉可以看看下面的代码,相信这并不是一件困难的事情。
2018-07-08 23:22:18 +08:00
```HTML
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
2019-06-18 08:25:53 +08:00
<title>所有学科信息</title>
<style>/* 此处略去了层叠样式表的选择器 */</style>
2018-07-08 23:22:18 +08:00
</head>
<body>
2019-06-18 08:25:53 +08:00
<h1>所有学科</h1>
2018-07-08 23:22:18 +08:00
<hr>
2019-06-18 08:25:53 +08:00
{% for subject in subjects %}
<div>
<h3>
<a href="/teachers/?sno={{ subject.no }}">{{ subject.name }}</a>
{% if subject.is_hot %}
<img src="/static/images/hot.png" width="32" alt="">
{% endif %}
</h3>
<p>{{ subject.intro }}</p>
</div>
2019-06-18 08:25:53 +08:00
{% endfor %}
2018-07-08 23:22:18 +08:00
</body>
</html>
2018-07-08 22:43:08 +08:00
```
在上面的模板中,我们为每个学科添加了一个超链接,点击超链接可以查看该学科的讲师信息,为此需要再编写一个视图函数来处理查看指定学科老师信息。
2018-07-09 11:07:48 +08:00
```Python
def show_teachers(request):
2019-06-18 08:25:53 +08:00
"""显示指定学科的老师"""
try:
sno = int(request.GET['sno'])
subject = Subject.objects.get(no=sno)
2019-06-18 08:25:53 +08:00
teachers = subject.teacher_set.all()
return render(request, 'teachers.html', {'subject': subject, 'teachers': teachers})
except (KeyError, ValueError, Subject.DoesNotExist):
return redirect('/')
2018-07-09 11:07:48 +08:00
```
显示老师信息的模板页。
2018-07-09 11:07:48 +08:00
```HTML
<!DOCTYPE html>
{% load static %}
2018-07-09 11:07:48 +08:00
<html lang="en">
<head>
<meta charset="UTF-8">
2019-06-18 08:25:53 +08:00
<title>老师</title>
<style>/* 此处略去了层叠样式表的选择器 */</style>
2018-07-09 11:07:48 +08:00
</head>
<body>
2019-05-10 00:29:11 +08:00
<h1>{{ subject.name }}学科老师信息</h1>
<hr>
{% if teachers %}
2019-06-18 08:25:53 +08:00
{% for teacher in teachers %}
<div>
<div>
<img src="{% static teacher.photo %}" alt="">
</div>
<div>
<h3>{{ teacher.name }}</h3>
<p>{{ teacher.detail }}</p>
<p class="comment">
<a href="">好评</a>
(<span>{{ teacher.good_count }}</span>)
<a href="">差评</a>
(<span>{{ teacher.bad_count }}</span>)
</p>
2018-07-09 11:07:48 +08:00
</div>
</div>
2019-06-18 08:25:53 +08:00
{% endfor %}
{% else %}
2019-06-18 08:25:53 +08:00
<h3>暂时没有该学科的老师信息</h3>
{% endif %}
2019-06-18 08:25:53 +08:00
<p>
<a href="/">返回首页</a>
</p>
2018-07-09 11:07:48 +08:00
</body>
</html>
```
### 加载静态资源
2018-07-09 11:07:48 +08:00
在上面的模板页面中,我们使用了`<img>`标签来加载老师的照片,其中使用了引用静态资源的模板指令`{% static %}`,要使用该指令,首先要使用`{% load static %}`指令来加载静态资源我们将这段代码放在了页码开始的位置。在上面的项目中我们将静态资源置于名为static的文件夹中在该文件夹下又创建了三个文件夹css、js和images分别用来保存外部层叠样式表、外部JavaScript文件和图片资源。为了能够找到保存静态资源的文件夹我们还需要修改Django项目的配置文件settings.py如下所示
2018-07-09 11:07:48 +08:00
```Python
# 此处省略上面的代码
STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static'), ]
STATIC_URL = '/static/'
# 此处省略下面的代码
```
接下来修改urls.py文件配置用户请求的URL和视图函数的对应关系。
```Python
from django.contrib import admin
from django.urls import path
from vote import views
urlpatterns = [
path('', views.show_subjects),
path('teachers/', views.show_teachers),
path('admin/', admin.site.urls),
]
```
2019-05-04 15:53:22 +08:00
启动服务器运行项目,进入首页查看学科信息。
2019-06-18 08:25:53 +08:00
![](./res/show_subjects.png)
2018-07-09 11:07:48 +08:00
2019-05-04 15:53:22 +08:00
点击学科查看老师信息。
2019-06-18 08:25:53 +08:00
![](./res/show_teachers.png)
2018-07-09 11:07:48 +08:00
### Ajax请求
接下来就可以实现“好评”和“差评”的功能了,很明显如果能够在不刷新页面的情况下实现这两个功能会带来更好的用户体验,因此我们考虑使用[Ajax](https://zh.wikipedia.org/wiki/AJAX)技术来实现“好评”和“差评”Ajax技术我们在Web前端部分已经介绍过了此处不再赘述。
2018-07-09 11:07:48 +08:00
首先修改项目的urls.py文件为“好评”和“差评”功能映射对应的URL。
2018-07-09 11:07:48 +08:00
```Python
from django.contrib import admin
from django.urls import path
from vote import views
2018-07-09 11:07:48 +08:00
urlpatterns = [
path('', views.show_subjects),
path('teachers/', views.show_teachers),
path('praise/', views.prise_or_criticize),
path('criticize/', views.prise_or_criticize),
2018-07-09 11:07:48 +08:00
path('admin/', admin.site.urls),
]
```
设计视图函数`praise_or_criticize`来支持“好评”和“差评”功能该视图函数通过Django封装的JsonResponse类将字典序列化成JSON字符串作为返回给浏览器的响应内容。
2018-07-09 11:07:48 +08:00
```Python
def praise_or_criticize(request):
"""好评"""
2018-07-09 11:07:48 +08:00
try:
tno = int(request.GET['tno'])
teacher = Teacher.objects.get(no=tno)
if request.path.startswith('/praise'):
2018-07-09 11:07:48 +08:00
teacher.good_count += 1
else:
teacher.bad_count += 1
teacher.save()
data = {'code': 200, 'hint': '操作成功'}
except (KeyError, ValueError, Teacher.DoseNotExist):
data = {'code': 404, 'hint': '操作失败'}
return JsonResponse(data)
2018-07-09 11:07:48 +08:00
```
修改显示老师信息的模板页引入jQuery库来实现事件处理、Ajax请求和DOM操作。
2018-07-09 11:07:48 +08:00
```HTML
<!DOCTYPE html>
{% load static %}
<html lang="en">
<head>
<meta charset="UTF-8">
2019-06-18 08:25:53 +08:00
<title>老师</title>
<style>/* 此处略去了层叠样式表的选择器 */</style>
</head>
<body>
2019-06-18 08:25:53 +08:00
<h1>{{ subject.name }}学科老师信息</h1>
<hr>
2019-06-18 08:25:53 +08:00
{% if teachers %}
{% for teacher in teachers %}
<div class="teacher">
<div class="photo">
<img src="{% static teacher.photo %}" height="140" alt="">
</div>
<div class="info">
<h3>{{ teacher.name }}</h3>
<p>{{ teacher.detail }}</p>
<p class="comment">
<a href="/praise/?tno={{ teacher.no }}">好评</a>
(<span>{{ teacher.good_count }}</span>)
&nbsp;&nbsp;
<a href="/criticize/?tno={{ teacher.no }}">差评</a>
(<span>{{ teacher.bad_count }}</span>)
</p>
</div>
</div>
2019-06-18 08:25:53 +08:00
{% endfor %}
{% else %}
<h3>暂时没有该学科的老师信息</h3>
{% endif %}
<p>
<a href="/">返回首页</a>
</p>
<script src="https://cdn.bootcss.com/jquery/3.4.1/jquery.min.js"></script>
<script>
$(() => {
2019-06-18 08:25:53 +08:00
$('.comment>a').on('click', (evt) => {
evt.preventDefault()
2019-06-18 08:25:53 +08:00
let anchor = $(evt.target)
let url = anchor.attr('href')
$.getJSON(url, (json) => {
if (json.code == 10001) {
let span = anchor.next()
span.text(parseInt(span.text()) + 1)
} else {
2019-06-18 08:25:53 +08:00
alert(json.hint)
}
})
})
})
</script>
</body>
</html>
2018-07-09 11:07:48 +08:00
```
### 小结
2019-05-25 20:32:10 +08:00
到此为止,这个投票项目的核心功能已然完成,在下面的章节中我们会要求用户必须登录才能投票,没有账号的用户可以通过注册功能注册一个账号。