摘要：項(xiàng)目地址使用文檔使用案例是一個(gè)前端數(shù)據(jù)狀態(tài)管理工具。它面向復(fù)雜的前端數(shù)據(jù)管理，用于在前端結(jié)構(gòu)化數(shù)據(jù)的不斷變化中，清晰地控制數(shù)據(jù)變動(dòng)，使數(shù)據(jù)變動(dòng)不引起錯(cuò)誤，并且方便表單數(shù)據(jù)的恢復(fù)校驗(yàn)格式化提交。

項(xiàng)目地址：https://github.com/tangshuang...

使用文檔：https://www.tangshuang.net/71...

使用案例：https://github.com/tangshuang...

TySheMo是一個(gè)前端數(shù)據(jù)（狀態(tài)）管理工具。它面向復(fù)雜的前端數(shù)據(jù)管理，用于在前端結(jié)構(gòu)化數(shù)據(jù)的不斷變化中，清晰地控制數(shù)據(jù)變動(dòng)，使數(shù)據(jù)變動(dòng)不引起錯(cuò)誤，并且方便表單數(shù)據(jù)的恢復(fù)、校驗(yàn)、格式化提交。

在需要對(duì)數(shù)據(jù)類型進(jìn)行校驗(yàn)，數(shù)據(jù)變動(dòng)引發(fā)界面變動(dòng)，數(shù)據(jù)校驗(yàn)，格式化后輸出數(shù)據(jù)，保證數(shù)據(jù)運(yùn)算時(shí)得到想要的結(jié)果等一系列復(fù)雜的數(shù)據(jù)變化需求，TySheMo可以在項(xiàng)目中發(fā)揮不錯(cuò)的的作用。雖然它不追求性能，但是在確保數(shù)據(jù)類型和格式安全上，它具有非常優(yōu)秀的思想，讓對(duì)數(shù)據(jù)有強(qiáng)烈依賴的業(yè)務(wù)可以在復(fù)雜的邏輯中保證不出錯(cuò)。

雖然我們已經(jīng)有typescript這樣的類型檢查系統(tǒng)，但是，typescript是在編譯時(shí)進(jìn)行類型檢查的，在運(yùn)行時(shí)，我們需要對(duì)一些動(dòng)態(tài)的數(shù)據(jù)（特別是從后臺(tái)api返回的數(shù)據(jù)）進(jìn)行類型和格式檢查。在支持graphql的系統(tǒng)中似乎不必這么擔(dān)心，但目前大多數(shù)的restful應(yīng)用，還是需要有一個(gè)工具去做這樣的一件事。

TySheMo將數(shù)據(jù)類型的檢查抽象出三個(gè)層面的對(duì)象：原型、類型、規(guī)則。它們分別在原子、結(jié)構(gòu)、邏輯層面對(duì)數(shù)據(jù)進(jìn)行校驗(yàn)，而且是在運(yùn)行時(shí)。如果校驗(yàn)失敗，你還可以通過(guò)拋出的錯(cuò)誤得到更為詳細(xì)的信息。

TySheMo內(nèi)部提供了多個(gè)數(shù)據(jù)原型（類似基礎(chǔ)數(shù)據(jù)類型）擴(kuò)展，并且直接使用js標(biāo)準(zhǔn)庫(kù)中的內(nèi)置對(duì)象作為原型，免去需要用字符串來(lái)定義類型的麻煩。內(nèi)置了Dict, List, Enum, Tuple, Range這幾種類型。通過(guò)對(duì)后臺(tái)api數(shù)據(jù)的檢查，就可以即時(shí)避免由于api返回?cái)?shù)據(jù)類型或結(jié)構(gòu)引起的錯(cuò)誤。同時(shí)，它還提供了更為豐富的類型檢查規(guī)范，你可以閱讀它的文檔了解更多用法。

TySheMo提供了一種定義結(jié)構(gòu)化數(shù)據(jù)的方式，用于對(duì)一個(gè)結(jié)構(gòu)化數(shù)據(jù)進(jìn)行規(guī)范化定義。數(shù)據(jù)模式是一個(gè)抽象的數(shù)據(jù)結(jié)構(gòu)范型，它不是具體的數(shù)據(jù)，但規(guī)定了數(shù)據(jù)本身的結(jié)構(gòu)規(guī)范。并且，作為工具庫(kù)，TySheMo提供了Schema類，schema實(shí)例擁有根據(jù)定義規(guī)范數(shù)據(jù)的能力。

更為重要的是Schema是一種數(shù)據(jù)結(jié)構(gòu)和行為邏輯約束的范例。行業(yè)里有json schema這樣的先驅(qū)，我們?cè)谶@些先行者的基礎(chǔ)上，提煉出對(duì)業(yè)務(wù)有幫助的部分，形成一套類似后臺(tái)數(shù)據(jù)庫(kù)結(jié)構(gòu)描述一樣的定義語(yǔ)言，用以在前端去描述一個(gè)結(jié)構(gòu)化，但隨時(shí)變化的數(shù)據(jù)對(duì)象。

它基于數(shù)據(jù)類型檢查系統(tǒng)，你需要在type屬性傳入對(duì)應(yīng)的類型。對(duì)于Schema實(shí)例而言，它是無(wú)狀態(tài)的，它所提供的接口是純粹的工廠，不會(huì)產(chǎn)生任何內(nèi)部資源。這樣的設(shè)計(jì)，使得Schema有可能成為規(guī)范，在開發(fā)中/測(cè)試中，確保業(yè)務(wù)中給的數(shù)據(jù)是按照規(guī)范給定的，否則，就會(huì)拋出錯(cuò)誤。

TySheMo提供了基于Schema的數(shù)據(jù)模型Model，是一個(gè)管理狀態(tài)數(shù)據(jù)的容器。數(shù)據(jù)被放在數(shù)據(jù)模型中管理時(shí)，由于Schema的約束，數(shù)據(jù)不得不按照規(guī)范運(yùn)行。它提供了當(dāng)代數(shù)據(jù)響應(yīng)的特性，你可以觀察數(shù)據(jù)變化，從而來(lái)決定如何變動(dòng)界面。

作為工具庫(kù)，TySheMo從業(yè)務(wù)出發(fā)對(duì)數(shù)據(jù)模型的寫作方式進(jìn)行了約束。一個(gè)數(shù)據(jù)模型，是一個(gè)class，并且需要定義它的schema。要將數(shù)據(jù)放到模型中進(jìn)行管理，你必須實(shí)例化模型，并且使用模型接口進(jìn)行數(shù)據(jù)修改和格式化。但到最后，你會(huì)發(fā)現(xiàn)，模型的使用異常簡(jiǎn)單，真正復(fù)雜的部分，往往在于，如何通過(guò)Schema制定你的數(shù)據(jù)規(guī)范。

這只是對(duì)Model的數(shù)據(jù)響應(yīng)最簡(jiǎn)單的一個(gè)演示，你還可以通過(guò)Model提供的能力，完成更多的事情。你可以把它和react, vue, angular結(jié)合使用，你可以在任何應(yīng)用中使用它。特別是在表單數(shù)據(jù)管理上，TySheMo可以做到非常出色。關(guān)于Model的細(xì)節(jié)和更多特性，你可以閱讀使用文檔了解。

TySheMo不解決所有問(wèn)題，而是專注將一個(gè)應(yīng)用中的某個(gè)局部的數(shù)據(jù)管理做到極致。你從來(lái)沒(méi)有體驗(yàn)過(guò)，同一個(gè)表單的業(yè)務(wù)邏輯，你不需要修改業(yè)務(wù)邏輯代碼部分，而只需要修改UI交互的邏輯，就可以完全適應(yīng)react, vue, angular。你也許不需要它，但也許也需要它，這取決于你如何在你但應(yīng)用中管理你的數(shù)據(jù)。如果你對(duì)這個(gè)項(xiàng)目感興趣，可以通過(guò)github參與項(xiàng)目。

（完）