是一款將Excel表格文件快速生成json和C#數(shù)據(jù)類的高效插件,詳情了解如下:
該插件有兩種模式,分別是命令行和圖像界面;為了更方便愉快的進(jìn)行大規(guī)模轉(zhuǎn)換,可以寫兩個批處理文件來實現(xiàn):
文件執(zhí)行單個選中Excel文件轉(zhuǎn)換,則執(zhí)行該路徑下所有xlsx文件;輸出文件夾的位置為,如果該目錄下無文件夾,則自動創(chuàng)建:
.bat詳情如下:
@SET OUTPUT_FOLDER=.\output
@SET EXE=.\tool\excel2json.exe
if not exist %OUTPUT_FOLDER% md %OUTPUT_FOLDER%
@echo off
set path=%1
echo 源文件路徑%path%
set name=%~n1
echo 源文件名%name%
set outputpath=%OUTPUT_FOLDER%\%name%
echo 輸出文件路徑%outputpath%
@CALL %EXE% --excel %path% --json %outputpath%.json --header 3 --csharp %outputpath%.cs -a
pause
前兩行分別為輸出目錄和.exe文件路徑,后面使用該變量作為參數(shù)時格式為[%變量名%];[.\]代表相對路徑
第四行,如果不存在該路徑文件夾則自動創(chuàng)建,注意如果沒有這一行也沒有對應(yīng)參數(shù)所指示的路徑,這時并不會自動創(chuàng)建路徑而是會直接報錯
第七行,一個%表示參數(shù)輸入,得到當(dāng)前選擇的首個文件路徑
第九行,得到當(dāng)前選擇的首個文件文件名(不包含后綴)
類似的還有:
%~d1\ 得到當(dāng)前選擇的首個文件所在磁盤符
%~dp1 得到當(dāng)前選擇的首個文件目錄(不包含文件名和文件后綴名)
%~nx1 得到當(dāng)前選擇的首個文件文件名和后綴
這里主要是為了保持輸出文件名與選擇文件名一致,最終輸出路徑為設(shè)置的輸出路徑目錄+源文件名
第十四行,調(diào)用@CALL 執(zhí)行對應(yīng)路徑下的exe文件,根據(jù)提供的命令行設(shè)置啟動參數(shù)。
.bat詳情如下:
@SET EXCEL_FOLDER=.\
@SET OUTPUT_FOLDER=.\output
@SET EXE=.\tool\excel2json.exe
@ECHO Converting excel files in folder %EXCEL_FOLDER% ...
if not exist %OUTPUT_FOLDER% md %OUTPUT_FOLDER%
for /f "delims=" %%i in ('dir /b /a-d /s %EXCEL_FOLDER%\*.xlsx') do (
@echo processing %%~nxi
@CALL %EXE% --excel %EXCEL_FOLDER%\%%~nxi --json %OUTPUT_FOLDER%\%%~ni.json --header 3 --csharp %OUTPUT_FOLDER%\%%~ni.cs -a
)
pause
上面這個批處理文件在幫助頁面中有類似示例,利用for循環(huán)對路徑內(nèi)的文件遍歷查詢和批量執(zhí)行。具體說明如下:
dir /b /a-d /s 從指定路徑遍歷搜索文件,路徑即為當(dāng)前文件夾下的所有.xlsx文件,也可以修改前面的excel所在文件夾參數(shù)配置其他位置
%%~nxi與%%~ni 與.bat中類似,只不過不是1(首個文件)而是循環(huán)體中的變量i(當(dāng)前遍歷的文件),i對應(yīng)數(shù)目索引的指定文件
需要注意的是,在cmd模式下的循環(huán)變量為單個%+循環(huán)標(biāo)識符(即%i),但在批處理文件中需要兩個百分號才行(即%%i)
提供已經(jīng)寫好批處理的文件包下載鏈接:
這里統(tǒng)一將Execl導(dǎo)出為了單張數(shù)組類型,方便在Unity中進(jìn)一步反序列化,如果想導(dǎo)出字典,可自行修改,或利用圖形界面分別導(dǎo)出
之所以默認(rèn)導(dǎo)出數(shù)組類型,因為Unity默認(rèn)的解析字典類型幾乎是不可能,即使強行可以,那也是用的兩個List做對應(yīng)關(guān)系,跟真正的字典類型導(dǎo)出的Json文件格式區(qū)別很大,如果直接解析出來就是個空文件。
當(dāng)然了,如果只是用于數(shù)據(jù)保存和讀寫,先序列化后再反序列化回來的話,這樣是不會出任何問題的,用兩個List來做對應(yīng)關(guān)系來序列化字典是完全可行的,這個可以詳細(xì)見后面的補充實驗;反過來如果專門利用外部文件來執(zhí)行反序列化,就有很多地方需要額外注意,很容易就反序列化失敗。
查看工程的源代碼就可以知道,里邊用的Json序列化方式為.Json,如果實在需要用字典來解析,可以直接導(dǎo)入.Json到Unity中使用。
為了方便對比,下面分別進(jìn)行數(shù)組Json與字典Json的反序列化測試:
1.數(shù)組型Json(或List型)
比如下面這段Json和C#文件:(通過導(dǎo)出)
[
{
"ID": "4l523",
"Hp": 5,
"Atk": 6.3,
"Def": 7,
"State": ""
},
{
"ID": "p6",
"Hp": 7,
"Atk": 8,
"Def": 2.3,
"State": ""
},
{
"ID": 0.3,
"Hp": 0.2,
"Atk": "2.3,7",
"Def": 9,
"State": ""
}
]
[ ]
public class Buff
{
public string ID; // 編號
public int Hp; // 血量
public float Atk; // 攻擊
public float Def; // 防御
public BuffData State; // 狀態(tài)
}
上面的Json中,因為腹黑的我在Excel表格中故意填錯了一些與當(dāng)前類型不匹配的數(shù)據(jù),導(dǎo)致出來的Json中的數(shù)據(jù)比較怪異批處理遍歷當(dāng)前文件夾,例如第三組中的ID,Hp,Atk,Def與當(dāng)前的數(shù)據(jù)類型不符,且Atk一個表格中填了兩個數(shù)字;
當(dāng)我們企圖直接利用反序列化該數(shù)組時,Unity會給你一個錯誤——JSON must an type.:
= .(json.text);
序列化數(shù)組時需要一個額外轉(zhuǎn)換,它必須包含一個默認(rèn)的簽名類型才行批處理遍歷當(dāng)前文件夾,所以在Json文件外圍增加一個array的簽名即可成功反序列化:
using UnityEngine;
public class JsonHelper
{
public static T[] GetJsonArray
(string json) {
string newJson = "{ \"array\": " + json + "}";
Wrapper
wrapper = JsonUtility.FromJson >(newJson); return wrapper.array;
}
[System.Serializable]
private class Wrapper
{
public T[] array;
}
}
需要注意的是,如果以該方式反序列化數(shù)組,之前導(dǎo)出的Json文件不能包含文件名,在上面的腳本中統(tǒng)一將文件名添加為array。而的文件名稱必須與類中的泛型數(shù)組T[]的變量名保持一致,才能保證反序列化出指定數(shù)據(jù)。
如果不利用泛型的話,則需要每個文件單獨寫一個類來進(jìn)行反序列化,同樣的數(shù)組的變量名必須與Json中的Array名保持一致。
為了更方便的通過ID來讀取數(shù)據(jù),也可以將得到的數(shù)組再遍歷一遍重新寫入一個字典中,通過反射在獲取ID的值作為鍵,但前提是規(guī)定每一個Json文件中必須有ID這一字段:
public class JsonDatas
{
public Dictionary<string, T> Dict = new Dictionary<string, T>();
public static JsonDatas
FromJson(string json) {
var re = new JsonDatas
(); var datas = JsonHelper.GetJsonArray
(json); foreach(var data in datas)
{
var info = data.GetType().GetField("ID");
var idstr = info.GetValue(data).ToString();
re.Dict.Add(idstr, data);
}
return re;
}
public T Get(string ID)
{
return Dict[ID];
}
}
反射取字段值得時遇到了一個坑,特意記錄一下:
Type.( name) 這個是取字段的值,取不了屬性
Type.( name) 這個是取屬性的值,取不了字段
這兩個取出來的內(nèi)容是不一樣的,請注意區(qū)分,不然半天也查不出錯誤出在哪里(說的就是我本人)
調(diào)試后的結(jié)果如下,能夠成功解析出Json了:
如此順利甚至讓人有點驚訝,之前瞎填的錯誤數(shù)據(jù)類型是怎么反序列化的呢?來看看第三組數(shù)據(jù)為什么沒有報錯 ,神奇的是,竟然自動幫你轉(zhuǎn)化為了對應(yīng)的數(shù)據(jù)類型:
ID 0.3被轉(zhuǎn)為了“0.”;Hp 0.2 變?yōu)榱?;更震驚的是,Atk竟然也沒有報錯,而是成功解析出了逗號前面的數(shù)字,emmm有點迷。
2.字典型Json
如果非要導(dǎo)出字典型Json來反序列化,那就不能再用Unity自帶的了,最好導(dǎo)入和序列化時用的是一樣的.Json
這里是與Unity適配的.Json包.9.0.1.下載地址:
如果是利用.Json反序列化單個不帶任何簽名的字典,只用一句話就可以了,不需要建立任何新類:
= .>(json.text);
試比較帶簽名和不帶簽名的Json:
{
"Buff": {
"4l523": {
"ID": "4l523",
"Hp": 5,
"Atk": 6.3,
"Def": 7,
"State": ""
},
"p6": {
"ID": "p6",
"Hp": 7,
"Atk": 8,
"Def": 2.3,
"State": ""
},
"0.3": {
"ID": 0.3,
"Hp": 2,
"Atk": 7,
"Def": 9,
"State": ""
}
}
}
{
"4l523": {
"ID": "4l523",
"Hp": 5,
"Atk": 6.3,
"Def": 7,
"State": ""
},
"p6": {
"ID": "p6",
"Hp": 7,
"Atk": 8,
"Def": 2.3,
"State": ""
},
"0.3": {
"ID": 0.3,
"Hp": 2,
"Atk": 7,
"Def": 9,
"State": ""
}
}
只要帶有簽名或者存在多個表單文件在同一個Json中,就只能重新建立新類并解析該新類了,新類中的變量順序和變量名都必須與Json文件中的順序與簽名保持一致才能成功反序列化:
public class Buffs
{
//變量名稱Buff必須與Json中的簽名Buff一樣
public Dictionary<string, Buff> Buff = new Dictionary<string, Buff>();
}
叫人失落的是,.Json并不會良心的幫你把錯誤的數(shù)據(jù)自動轉(zhuǎn)換,而是直接給你拋出一個錯誤,害的我只能手動修正錯誤數(shù)據(jù),這一點和不同。
補充:
一個有趣的實驗——強行用Unity中的字典序列化方式來序列化Json文件會是怎樣?
開始之前,我們要明白的是,Unity默認(rèn)情況下沒有給出任何字典序列化的方式,它只能蠢蠢的序列化List或者Array,但這并不能阻止我們,我們可以討巧的利用接口來實現(xiàn)一個偽序列化,本質(zhì)上還是用的兩個List:
using UnityEngine;
using System;
using System.Collections.Generic;
// Dictionary
[Serializable]
public class Serialization
: ISerializationCallbackReceiver{
[SerializeField]
List
keys; [SerializeField]
List
values;
Dictionary
target; public Dictionary
ToDictionary() { return target; }
public Serialization(Dictionary
target) {
this.target = target;
}
public void OnBeforeSerialize()
{
keys = new List
(target.Keys); values = new List
(target.Values); }
public void OnAfterDeserialize()
{
var count = Math.Min(keys.Count, values.Count);
target = new Dictionary
(count); for (var i = 0; i < count; ++i)
{
target.Add(keys[i], values[i]);
}
}
}
把之前反序列化出的數(shù)據(jù)再用該偽序列化方式來序列化為Json文件:
var SerializedBuff= new Serialization<string, Buff>(new Dictionary<string, Buff>());
var data = JsonConvert.DeserializeObject
(json.text); foreach(var item in data.Buff)
{
SerializedBuff.ToDictionary().Add(item.Key, item.Value);
}
var jsont = JsonUtility.ToJson(SerializedBuff);
Debug.Log(jsont);
jsont文本內(nèi)容如下:
{
"keys":[
"4l523",
"p6",
"0.3"],
"values":[
{
"ID":"4l523",
"Hp":5,
"Atk":6.300000190734863,
"Def":7.0,
"State":{
}
},
{
"ID":"p6",
"Hp":7,
"Atk":8.0,
"Def":2.299999952316284,
"State":{
}
},
{
"ID":"0.3",
"Hp":2,
"Atk":7.0,
"Def":9.0,
"State":{
}
}]
}
我們發(fā)現(xiàn)它確實和之前的Json文件結(jié)構(gòu)大不相同,因為它根本不是字典而是兩個List做對應(yīng)關(guān)系,實際上是Keys在一起在一起,只不過它們的索引是相互對應(yīng)的。
當(dāng)我們已經(jīng)將Json文件轉(zhuǎn)化為了Unity可識別的形式后,就可以很容易的再進(jìn)行反序列化了:
往期精選
聲明:發(fā)布此文是出于傳遞更多知識以供交流學(xué)習(xí)之目的。若有來源標(biāo)注錯誤或侵犯了您的合法權(quán)益,請作者持權(quán)屬證明與我們聯(lián)系,我們將及時更正、刪除,謝謝。