这篇文章主要为大家详细介绍了 Python 采用 Django 制作简易的知乎日报 API,感兴趣的小伙伴们可以参考一下
Django 是一个开放源代码的 web 应用框架,由 Python 写成。采用了 MVC 的软件设计模式,即模型 M,视图 V 和控制器 C。它最初是被开发来用于管理劳伦斯出版集团旗下的一些以新闻内容为主的网站的,即是 CMS(内容管理系统)软件。并于 2005 年 7 月在 BSD 许可证下发布。这套框架是以比利时的吉普赛爵士吉他手 Django Reinhardt 来命名的。
现在我主要教大家如何去实战,做一个简易的知乎日报 API
首先你要熟悉 django 的基本用法,会写模型,会写视图函数,会配置 url。
1. 配置字符编码
因为我们等一下要使用中文,所以要先设好字符编码
在 settings.py 里将 LANGUAGE_CODE 设为'zh-CN'
然后添加这两行
FILE_CHARSET='utf-8'
DEFAULT_CHARSET='utf-8'
还要进入到数据库
依次输入
- set character_set_client=utf8 ;
- set character_set_connection=utf8 ;
- set character_set_database=utf8 ;
- set character_set_results=utf8 ;
- set character_set_server=utf8 ;
- set character_set_system=utf8 ;
设置完成之后,输入
show variables like 'character%';
对照一下结果是否是这样
2. 然后开始写模型
- class News(models.Model):
- created = models.DateTimeField(auto_now_add=True)
- title = models.CharField(max_length=100)
- image = models.CharField(max_length=100)
- theme_id =models.IntegerField()
- class Meta:
- ordering = ('created',)
- def __unicode__(self):
- return self.title
- class NewsDetail(models.Model):
- news = models.ForeignKey(News)
- created = models.DateTimeField(auto_now_add=True)
- content = models.CharField(max_length=1000)
- image = models.CharField(max_length=99)
- class Meta:
- ordering = ('created',)
- def __unicode__(self):
- return self.news.title
这里不难理解,这里我分两层,第一层是概括,第二层是详细内容,然后以概括的作为外键
概括主要包含标题,配图地址和主题
详细内容包括内容和配图地址
3. 将模式序列化
这是 rest_framework 非常强大的一点
在 app 里新建一个 serializers.py, 然后创建继承自 ModelSerializer 的类
- from rest_framework import serializers
- class NewsSerializer(serializers.ModelSerializer):
- class Meta:
- model = News
- fields = ('id', 'title', 'image', 'theme_id')
- class NewsDetailSerializer(serializers.ModelSerializer):
- class Meta:
- model = NewsDetail
- fields = ('id', 'image', 'content')
model 为模型,fields 为你想要查询显示的字段
4. 然后再写视图函数
rest_framework.renderers 中的 JSONRenderer 可以将对象渲染为 json 形式的字符串
- from rest_framework.renderers import JSONRenderer
- class JSONResponse(HttpResponse):
- """
- 用于返回JSON数据.
- """
- def __init__(self, data, **kwargs):
- content = JSONRenderer().render(data)
- kwargs['content_type'] = 'application/json'
- content='{"news":'+content+'}'
- super(JSONResponse, self).__init__(content, **kwargs)
我们在字符串外面在包一个 news,这样获取比较方便
如何像知乎日报的那样获取最新的几个 news 呢
- @csrf_exempt
- def latest_news(request):
- """
- 展示最新的10个news.
- """
- if request.method == 'GET':
- news = News.objects.all()[:10]
- serializer = NewsSerializer(news, many=True)
- return JSONResponse(serializer.data)
因为返回的是一个集合所以 NewsSerializer 的 many 参数要设为 True
返回某个主题的前几个 news
- @csrf_exempt
- def theme_news(request,theme_id):
- """
- 展示某个主题的前10个news.
- """
- if request.method == 'GET':
- news=News.objects.filter(theme_id=theme_id)[:10]
- serializer = NewsSerializer(news, many=True)
- return JSONResponse(serializer.data)
返回某个 id 的 news 的详细内容
- @csrf_exempt
- def news_detail(request,news_id):
- """
- 显示某个news的内容.
- """
- try:
- news = NewsDetail.objects.get(news_id=news_id)
- except Snippet.DoesNotExist:
- return HttpResponse(status=404)
- if request.method == 'GET':
- serializer = NewsDetailSerializer(news)
- # print serializer.data
- return JSONResponse(serializer.data)
这里获取的是单个对象所以不用加 many 参数
5. 配置 url
- urlpatterns = [
- ...
- url(r'^api/4/news/latest$', latest_news),
- url(r'^api/4/news/theme/(?P<theme_id>[0-9]+)/$', theme_news),
- url(r'^api/4/news/(?P<news_id>[0-9]+)/$', news_detail),
- ]
括号包住的是要传入的参数,逗号后面的是匹配 url 成功后要执行的视图函数
括号里面有一些正则表达式,自己可以去百度搜一下怎么写
最后就可以把项目跑起来
效果如下
来源: http://www.phperz.com/article/17/0314/291058.html