# -*- coding: utf-8 -*-
# 作者: 煮酒品茶
"""
package.module
~~~~~~~~~~~~~~
python实现的图书的一个restful api.
参考restful设计指南 URL:
/blog//05/restful_api.html
restful api 一般模式:
GET(SELECT):从服务器取出资源(一项或多项)。
POST(CREATE):在服务器新建一个资源。
PUT(UPDATE):在服务器更新资源(客户端提供改变后的完整资源)。
PATCH(UPDATE):在服务器更新资源(客户端提供改变的属性)。
DELETE(DELETE):从服务器删除资源。
注意:
没有做存储持久化,为了实现例子,实际上应该是从数据库里面拿,而增册改查方法也应该调用
后端的方法。
:copyright: (c) YEAR by zwhset.
:license: GOMEOPS, see LICENSE_FILE for more details.
"""
from flask import Flask, request, jsonify
import random
app = Flask(__name__)
books = [
dict(id=1, isdn=random.randrange(1, 1000), title='a python book', author=dict(
name='l0set', city='hunan'
)),
dict(id=2, isdn=random.randrange(1, 1000), title='a golang book', author=dict(
name='zwhset', city='beijing'
))
]
# error action
@app.errorhandler(405)
def page_not_found(e):
return jsonify(dict(code=1, message='method error.')), 405
# get all books
@app.route('/api/books')
def handle_books():
return jsonify(books)
# get a book
@app.route('/api/book/')
def handle_book(id):
for i, book in enumerate(books):
if book['id'] == id:
return jsonify(book)
return jsonify(dict(code=2, message="don't fund the book"))
# create a new book
@app.route('/api/book', methods=['POST'])
def create_book():
book = request.json
# check params
if ((not 'title' in book and 'author' in book) or
(not isinstance(book['author'], dict)) or
(not 'name' in book['author'] and 'city' in book['author'])):
return jsonify(code=3, message='json author error.')
# create a new book
book['id'] = random.randrange(1, 10000)
book['isdn'] = random.randrange(1, 10000)
books.append(book)
return jsonify(code=0, message='success')
# update book
@app.route('/api/book/', methods=['PUT'])
def update_book(id):
book = request.json
# check params
if ((not 'title' in book and 'author' in book) or
(not isinstance(book['author'], dict)) or
(not 'name' in book['author'] and 'city' in book['author'])):
return jsonify(code=3, message='json author error.')
# 安全考虑,只拿要的数据,其它的不要
book_data = dict(title=book['title'],
author=dict(
name=book['author']['name'],
city=book['author']['city']
))
for i, book in enumerate(books):
# check id
if book['id'] == id:
books[i].update(book_data) # 进行更新操作
return jsonify(code=0, message='success')
return jsonify(dict(code=2, message="don't fund the book"))
# delete a book
@app.route('/api/book/', methods=['DELETE'])
def delete_book(id):
for i, book in enumerate(books):
# check id
if book['id'] == id:
del books[i] # 删除书
return jsonify(code=0, message='success')
return jsonify(dict(code=2, message="don't fund the book"))
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8000)