強業務邏輯抽象API接口

組件

1. 接入類
2. 映射類
3. 動做類

接入類

主要作路由，限流，鑑權等接入放行性質的工做

class App:
    action_map = {}

    def dispatch(self, data):
        try:
            assert data["action"] in self.action_map, ErrorCode.sys_action_not_exist
            action = self.action_map[data["action"]]
            return {
                "code": 0,
                "msg": "",
                "data": action.run(data["params"])
            }
        except AssertionError as e:
            msg, code = e
            return {
                "code": code,
                "msg": msg,
                "data": None
            }
        except Exception:
            traceback.print_exc()
            msg, code = ErrorCode.sys_unknown
            return {
                "code": code,
                "msg": msg,
                "data": None
            }

映射類

名稱到動做類的映射

action_map = {
    'register': RegisterAction
}

動做類

表達一個接口的實際業務邏輯操做，權限，數據schema都在這裏進行配置

class RegisterAction(Action):
    schema = Schema({
        "verify_code": And(str, len),
        "phone": And(str, len),
        "password": And(str, len)
    })
    auth = False

    def run(self, data):
        assert check_verify_code(data["verify_code"]), MyErrorCode.verify_code_wrong
        assert User.get(data["phone"]), MyErrorCode.already_register
        return {"token": "token"}

業務邏輯

操做順序

1. 數據結構與格式驗證，validate
2. 數據正確性驗證，如驗證碼，密碼等，check
3. 數據存在性驗證，exist
4. 數據業務狀態驗證，status
5. 數據業務更改操做並提交至數據庫，run
6. 返回成功，return