一、功能需求分析
1、banner
2、推荐文章列表
3、文章标签导航
4、文章列表
5、分页
二、模型设计
根据功能分析，我们需要如下表，大量的经验和功能积累
1、表和字段分析
a 文章分类表
b 文章表
c 文章评论表
d 推荐文章表
e 轮播图表
2、模型定义
定义一个基类模型，抽取公共字段
创建时间、更新时间、逻辑删除
a 分析每个表功能、根据字段编写模型代码
三、文章标签导航功能
1.接口设计
类目 说明
请求方式 GET
url /
参数说明 无参数
2.返回结果
返回新闻页面，直接在模版渲染
#insert news tag data
INSERT INTO tb_tag(name, create_time, update_time, is_delete) values
('Python基础', now(), now(), 0),
('Python高级', now(), now(), 0),
('Python函数', now(), now(), 0),
('PythonGUI', now(), now(), 0),
('Linux教程', now(), now(), 0),
('Python框架', now(), now(), 0);
四、新闻列表功能
1、业务流程分析
a 判断前端传递标签分类ID是否为空，是否为整数，是否超过范围
b 判断前端传递当前文章页数是否为空，是否为整数，是否超过范围
2、接口设计
类目 说明
请求方式 GET
url /news/
参数说明:
参数名 类型 是否必须 描述
tag 整数 否 标签分类ID
page 整数 是 当前文章页数
3、返回结果：
json
{
"errno": "0",
"errmsg": "",
"data": {
"total_pages": 61,
"news": [
{
"digest": "在python用import或者from...import或者from...import...as...来导入相应的模块，作用和使用方法与C语言的include头文件类似。其实就是引入...",
"title": "import方法引入模块详解",
"author": "python",
"image_url": "/media/jichujiaochen.jpeg",
"tag_name": "Python基础",
"update_time": "2018年12月17日 14:48"
},
{
"digest": "如果你原来是一个php程序员，你对于php函数非常了解（PS：站长原来就是一个php程序员），但是现在由于工作或者其他原因要学习python，但是p...",
"title": "给曾经是phper的程序员推荐个学习网站",
"author": "python",
"image_url": "/media/jichujiaochen.jpeg",
"tag_name": "Python基础",
"update_time": "2018年12月17日 14:48"
}
]
}
}
mysql -u root -p -D tzpj < tb_news_20181217.sql. 导入数据库
news/modile.py代码
from django.db import models
from utils.models import BaseModel
class Tag(BaseModel):
"""
文章分类标签模型
"""
# 字段
name = models.CharField('标签名', max_length=64, help_text='标签名')
class Meta:
ordering = ['-update_time', '-id'] #排序
db_table = "tb_tag" #指明数据库表名
verbose_name = '文章标签' #在admin站点中显示点名称
verbose_name_plural = verbose_name #显示点复数名称
def __str__(self):
return self.name
class News(BaseModel):
"""
文章模型
"""
title = models.CharField('标题', max_length=150, help_text='标题')
digest = models.CharField('摘要', max_length=200, help_text='摘要')
content = models.TextField('内容', help_text='内容')
clicks = models.IntegerField('点击量', default=0, help_text='点击量')
image_url = models.URLField('图片url', default='', help_text='图片url')
tag = models.ForeignKey('Tag', on_delete=models.SET_NULL, null=True)
author = models.ForeignKey('user.User', on_delete=models.SET_NULL, null=True)
class Meta:
ordering = ['-update_time', '-id'] #排序
db_table = "tb_news" #指明数据库表名
verbose_name = '新闻' #在admin站点中显示点名称
verbose_name_plural = verbose_name #显示点复数名称
def __str__(self):
return self.title
class Comments(BaseModel):
"""
评论模型
"""
content = models.TextField('内容', help_text='内容')
author = models.ForeignKey('user.User', on_delete=models.SET_NULL, null=True)
news = models.ForeignKey('News', on_delete=models.CASCADE)
class Meta:
ordering = ['-update_time', '-id'] #排序
db_table = "tb_comments" #指明数据库表名
verbose_name = '评论' #在admin站点中显示点名称
verbose_name_plural = verbose_name #显示点复数名称
def __str__(self):
return '<评论{}>'.format(self.id)
class HotNews(BaseModel):
"""
推荐文章模型
"""
news = models.OneToOneField('News', on_delete=models.CASCADE)
priority = models.IntegerField('优先级', help_text='优先级')
class Meta:
ordering = ['-update_time', '-id'] #排序
db_table = "tb_hotnews" #指明数据库表名
verbose_name = '热门文章' #在admin站点中显示点名称
verbose_name_plural = verbose_name #显示点复数名称
def __str__(self):
return '<热门文章{}>'.format(self.id)
class Banner(BaseModel):
"""
轮播图
"""
image_url = models.URLField('轮播图', help_text='轮播图url')
priority = models.IntegerField('优先级', help_text='优先级')
news = models.OneToOneField('News', on_delete=models.CASCADE)
class Meta:
ordering = ['priority', '-update_time', '-id'] #排序
db_table = "tb_banner" #指明数据库表名
verbose_name = '热门文章' #在admin站点中显示点名称
verbose_name_plural = verbose_name #显示点复数名称
def __str__(self):
return '<轮播图{}>'.format(self.id)
news/views.py代码
import logging
from django.shortcuts import render
from django.views import View
from django.db.models import F
from django.core.paginator import Paginator
from .models import Tag, News
from . import constants
from utils.res_code import json_response
logger = logging.getLogger('django')
def index(request):
"""
新闻首页视图 only默认带ID
url: /
:param request:
:return:
"""
# 新闻标签
tags = Tag.objects.only('name').filter(is_delete=False)
return render(request, 'news/index.html', context={
'tags': tags
})
class NewsListView(View):
"""
新闻列表视图
"""
def get(self, request):
# 1,获取参数
try:
tag_id = int(request.GET.get('tag', 0))
except Exception as e:
logger.error('标签错误， \n{}'.format(e))
tag_id = 0
try:
tag_id = int(request.GET.get('tag', 0))
except Exception as e:
logger.error('标签错误， \n{}'.format(e))
tag_id = 1
# 2，获取查询集 values返回字典
news_queryset = News.objects.values('id', 'title', 'digest','image_url', 'update_time',
'tag__name', 'author__username').annotate(tag_name=F('tag_name'),author=F('author__username'))
#过滤
# if tag_id:
# news = news_queryset.filter(is_dalete=False, tag_id=tag_id)
# else:
# news = news_queryset.filter(is_dalete=False)
news = news_queryset.filter(is_dalete=False, tag_id=tag_id) or news_queryset.filter(is_dalete=False)
# 3，分页
paginator = Paginator(news, constants.PER_PAGE_NEWS_COUNT)
#获取当前页数据 get_page可以容错
news_info = paginator.get_page(page)
# 4，返回数据
data = {
'total_pages': paginator.num_pages,
'news': list(news_info)
}
return json_response(data=data)
序列化：把特定的内存对象转化成可以存储的字符串
utils/res_code.py代码
import datetime
from django.http import JsonResponse
from django.core.serializers.json import DjangoJSONEncoder
class MyJSONEncoder(DjangoJSONEncoder):
def default(self, o):
if isinstance(o, datetime.datetime):
return o.astimezone().strftime('%Y-%m-%d %H:%M:%S') #转换为本地时间
else:
return super().default(o)
def json_response(errno=Code.OK, errmsg='', data=None, kwargs=None):
json_dict = {
'errno': errno,
'errmsg': errmsg,
'data': data
}
if kwargs and isinstance(kwargs, dict):
json_dict.update(kwargs)
return JsonResponse(json_dict, encoder=MyJSONEncoder)
五、推荐新闻
1，接口设计
类目 说明
请求方式 GET
url /
参数说明 无参数
2，返回结果
返回新闻页面，直接在模版渲染
news/vies.py代码
def index(request):
"""
新闻首页视图
url: /
"""
# 新闻标签
tags = Tag.objects.only('name').filter(is_delete=False)
# 热门新闻 objects.select_related('news')一次性从数据库多拿数据
hot_news = HotNews.objects.select_related('news').only('news__title', 'news__image_url', 'news_id').filter(is_delete=False).order_by('priority', '-news__clicks')[:constants.SHOW_HOTNEWS_COUNT]
return render(request, 'news/index.html', context={
'tags': tags,
'hot_news': hot_news
})
六、轮播图功能
接口设计
1，接口说明：
类目 说明
请求方法 GET
url定义 /news/banners/
参数格式 无参数
2，返回结果： # json
{
'erron': '0',
'errmsg': 'ok'
'data': {
'banners':[
{
'image_url':'/media/jichujiaochen.jpeg',
'news_id': 221,
'news_title': 'python算法快速排序'
},
{
'image_url':'/media/python_advanced.jpeg',
'news_id': 707,
'news_title': 'python序列与映射的解包操作'
}
]
}
}