前言
最近有个朋友说他每天工作时都要查看某些官方网站的通告,一看就是十几个网站,每个网站来回切,很是烦躁,于是问我有没有比较elegant 的解决办法。作为一个程序员,能用代码解决的绝不动手。起初是用Python 写了个简单的脚本,通过爬取这些网站的通告,再通过目录的形式展示出来,方便查看。
但是作为一个iOS 开发,考虑做成个App 来查看更为方便,顺带着也学下后端的知识,自己写个API,搭建个服务器啥的。经调研打算先从Django 入手。Django 是使用 Python 编写的一个开源 Web 框架,可以用它来快速搭建一个高性能的网站。本文先入个门,Let's do it!
1.搭建环境
安装pip
sudo easy_install pip
安装Django
sudo pip install Django==1.11
要注意的是要根据自己的Python 版本选择对应的Django 版本,python 版本对应关系
安装Django REST framework
sudo pip install djangorestframework
2.跑起来
创建项目
django-admin startproject apiproject
运行Web 服务
python manage.py runserver
在浏览器输入 http://127.0.0.1:8000/ ,看到如下的页面提示信息
修改语言
settings.py
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'
改为
# 把英文改为中文
LANGUAGE_CODE = 'zh-hans'
# 把国际时区改为中国时区
TIME_ZONE = 'Asia/Shanghai'
刷新下
3.创建应用APP
创建
django-admin.py startapp api
添加App
4.数据库模型
创建model
from django.db import models
class Category(models.Model):
name = models.CharField(max_length=100)
url = models.CharField(max_length=200)
class Article(models.Model):
title = models.CharField(max_length=200)
date = models.CharField(max_length=50)
url = models.CharField(max_length=200)
category = models.ForeignKey(Category)
迁移数据库
相当于创建数据库表
python manage.py makemigrations
python manage.py migrate
创建 Admin 后台管理员账户
用于登录后台
python manage.py createsuperuser
在 Admin 后台注册模型
from django.contrib import admin
from .models import Category, Article
admin.site.register(Article)
admin.site.register(Category)
运行开发服务器,访问 http://127.0.0.1:8000/admin/
输入账号密码
5.序列器(Serializers)
from .models import Article, Category
from rest_framework import serializers
class ArticleSerializer(serializers.HyperlinkedModelSerializer):
class Meta:
model = Article
fields = ('title', 'date', 'url', 'category')
class CategorySerializer(serializers.HyperlinkedModelSerializer):
class Meta:
model = Category
fields = ('name', 'url')
6.视图(Views)
from .models import Article, Category
from rest_framework import viewsets
from .serializers import ArticleSerializer, CategorySerializer
class ArticleViewSet(viewsets.ModelViewSet):
queryset = Article.objects.all()
serializer_class = ArticleSerializer
class CategoryViewSet(viewsets.ModelViewSet):
queryset = Category.objects.all()
serializer_class = CategorySerializer
7.URLs
from django.conf.urls import url, include
from rest_framework import routers
from django.contrib import admin
from api import views
router = routers.DefaultRouter()
router.register(r'articles', views.ArticleViewSet)
router.register(r'categorys', views.CategoryViewSet)
urlpatterns = [
url(r'^admin/', admin.site.urls),
url(r'^', include(router.urls)),
# url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))
]
8.测试API
http://127.0.0.1:8000/articles/
这时还没有数据,需要往数据库里添加几条数据
这里有个问题输入中文后,后续添加修改会出现编码错误的页面
需要在manager.py 添加这段代码就没问题了
import sys
reload(sys)
sys.setdefaultencoding('utf-8')
添加通告
再试一下,YES!鸡冻!
但是这里发现个小问题,category字段应该只是分类的名字,我们改下序列器,顺便把id 也加上
class ArticleSerializer(serializers.HyperlinkedModelSerializer):
category = serializers.ReadOnlyField(source='category.name')
class Meta:
model = Article
fields = ('id', 'title', 'date', 'url', 'category')
class CategorySerializer(serializers.HyperlinkedModelSerializer):
class Meta:
model = Category
fields = ('id', 'name', 'url')
再试下
大功告成!三个小时的成果,对于新手来说已经很爽了
后续
目前只是本地服务,而且只有一个API,之后会完善更多的API,并且部署到阿里云的服务器上,先定下这个小目标吧!生命在于折腾!