JSONLINT：python的json數(shù)據(jù)驗證庫實例解析

更新時間：2017年11月28日 17:24:55 作者：TANGWZ

本文介紹的 jsonlint 啟發(fā)自 python 的表單驗證工具 wtforms，wtforms 通過繼承 Form 類也能進行 json 數(shù)據(jù)驗證，下面通過一些例子給大家詳細介紹，非常不錯，具有參考借鑒價值，需要的朋友參考下吧

JSON(JavaScript Object Notation) 是一種輕量級的數(shù)據(jù)交換格式，易于人閱讀和編寫。

JSON 函數(shù)

使用 JSON 函數(shù)需要導入 json 庫：import json。

函數(shù)	描述
json.dumps	將 Python 對象編碼成 JSON 字符串
json.loads	將已編碼的 JSON 字符串解碼為 Python 對象

隨著前后端分離和 REST APIs 的火熱，開發(fā)者不斷尋找著一種靈活的、優(yōu)雅的方式驗證 json 數(shù)據(jù)。有直接手動獲取數(shù)據(jù)驗證的，也有使用 json scheme 驗證的。前者容易使得函數(shù)變得冗長，還可能存在不少重復的驗證；后者驗證又不靈活。

本文介紹的 jsonlint 啟發(fā)自 python 的表單驗證工具 wtforms，wtforms 通過繼承 Form 類也能進行 json 數(shù)據(jù)驗證，但是 wtforms 對于 json 的數(shù)組（Array）類型處理有著很詭異的行為，需要通過 a-1 、 a-2 這樣來傳遞數(shù)組數(shù)據(jù)，常常不能有效的處理數(shù)組數(shù)據(jù)。 jsonlint 大部分代碼來著 wtforms，可以視為 wtforms 的一個分支。但 jsonlint 刪去了 wtforms 的表單渲染部分，更改了傳入的數(shù)據(jù)格式，最重要的是使用正確的邏輯驗證數(shù)組（Array）和對象（Object）類型。下面是一些例子：

基本的字符串類型json驗證

對于基本的字符串類型，我們只需要創(chuàng)建一個 Json 的子類，填寫對應的 Field 即可。使用方式和 wtforms 類型：

from jsonlint import Json
from jsonlint.fields import StringField
from jsonlint.validators import DataRequired
class MyLint(Json):
 name = StringField(validators=[DataRequired()])
mylint = MyLint({'name': 'demo'})
print mylint.validate() # True
print mylint.name.data # demo

更靈活的驗證 json 數(shù)據(jù)

jsonlint 繼承了 wtforms 的優(yōu)點，可以進行一些更靈活的自定義json數(shù)據(jù)驗證，只要將 field 類的實例名寫成函數(shù) validate_fieldname ，即可自定義驗證改字段：

from jsonlint import Json
from jsonlint.fields import IntegerField
from jsonlint.validators import ValidationError
class AgeLint(Json):
 age = IntegerField()
 def validate_age(form, field):
  if field.data < 13:
   raise ValidationError("We're sorry, you must be 13 or older to register")
agelint = AgeLint({'age': 12})
print agelint.validate() # False
print agelint.age.errors # ["We're sorry, you must be 13 or older to register"]

對數(shù)組類型進行驗證

jsonlint 誕生可以說主要就是為了解決如何驗證數(shù)組類型的問題，在jsonlint這很容易實現(xiàn)：

from jsonlint import Json
from jsonlint.fields import StringField, ListField
from jsonlint.validators import DataRequired, ValidationError
class ListLint(Json):
 cars = ListField(StringField(validators=[DataRequired()]))
 def validate_cars(form, field):
  if 'BMW' in field.data:
   raise ValidationError("We're sorry, you cannot drive BMW")
listlint = ListLint({'cars': ['Benz', 'BMW', 'Audi']})
print listlint.validate() # False
print listlint.cars.errors # ["We're sorry, you cannot drive BMW"]

ListField 類作為一個 Field 容器，容納其它類型 Field 的數(shù)組，將對應類型的數(shù)組直接傳入，即可有效的驗證；ListField 同樣也可以進行自定義驗證。

對對象類型進行驗證

對象類型在一些 REST APIs 的 web 應用中也經(jīng)常存在，對此 jsonlint 也作了支持。只要將 Json 子類傳入 ObjectField 中即可進行驗證：

from jsonlint import Json
from jsonlint.fields import ObjectField, IntegerField, BooleanField
class T(Json):
 status = BooleanField()
 code = IntegerField()
class DataLint(Json):
 data = ObjectField(T)
datalint = DataLint({'data': {'status': True, 'code': 200}})
print datalint.validate() # False
print datalint.data.code.data # 200

寫在最后

jsonlint 誕生初衷就是因為本人想用類似 wtforms 的方式來驗證json，這樣不但有著良好的驗證方式，還可以分割業(yè)務，避免接口主函數(shù)變得十分冗長。例如，可以定義類：

class RegisterLint(UserLint):
 def validata_nickname(self, field):
  ...
 def validate_account(self, field):
  ...
 def create_user(self):
  ...
user = RegisterLint()

這樣既可以使用 RegisterLint 的實例 user 驗證數(shù)據(jù)，同時又能直接執(zhí)行 user.create_user() 進行數(shù)據(jù)庫操作，將數(shù)據(jù)庫邏輯更好的封裝。這樣可以說是在 MVC 設計模式的基礎上獨立出了一層。

想要嘗試使用 jsonlint 可以直接使用 pip 安裝：