[ 目录 ]
- 0. 前言
- 1. 属性拓展优化
- (1)反射获取转化函数 TryParse
- (2)反射获取EmptyReplace
- (3)属性类型
- (4)属性拓展
- 2. 模板处理
- (1)替换内容
- (2)属性段
- (3)模板特殊符号定义
- (4)模板
- 3. 面板优化
- 4. 结束咯
0. 前言
之前就在做的一个 unity 中使用的 Excel 导出工具,继续完善了一下。
这次改了挺多内容的,一方面是使用了反射然后再优化了代码,属性拓展更加简单,另一方面是优化了模板处理和窗口显示。相关的代码以及Demo已经打包为Unity包,连接如下。上一个版本有比较详细的使用方法介绍,链接也放在下面可供参考
链接:https://pan.baidu.com/s/1AdsaUDOW4e4D-beWUaqhXA?pwd=wsad
提取码:wsad
前一个版本的文章:https://blog.csdn.net/Blue_carrot_/article/details/130954127
1. 属性拓展优化
(1)反射获取转化函数 TryParse
~ TryParse
比如“int.TryParse”,是用于尝试将字符串转化为int类型,这对于数据导出工具来说还是很重要的,可以用于做数据的校验,另外在游戏运行时也可以作为将数据转化为对应类型。
~ 获取TryParse
作为一个unityEditor相关插件,与其他独立的导出工具不同的是,可以直接通过反射获取到程序内正在使用的类。这种情况下,我们可以将写在表格中的类型,用反射来获取到该类型的转化函数TryParse,通过这个函数来校验数据以及导出后的数据处理。
比如,“Color”类型,我们需要从有个方法来校验数据是否正确,另外导出代码时能够写入转化的方法。Unity中已经提供了ColorUtility.TryParseHtmlString来转16进制的颜色,比如“#FF00FF”。我们可以把每个属性对应的函数都列举到一个类中,方便我们去反射调用。如下:
using UnityEngine;
namespace Exporter
{
public static partial class DataTable
{
public delegate bool TryParseFunc<T>(string text, out T result);
public static TryParseFunc<int> TryParse_int = int.TryParse;
public static TryParseFunc<float> TryParse_float = float.TryParse;
public static TryParseFunc<double> TryParse_double = double.TryParse;
public static TryParseFunc<bool> TryParse_bool = bool.TryParse;
public static TryParseFunc<Color> TryParse_Color = ColorUtility.TryParseHtmlString;
}
}
这里用到的是delegate委托,不用担心委托会有额外的开销,委托在新建的时候会有额外一点开销,但执行的时候几乎和原本的函数是一致的。比起反射到各个不同的类中的不同函数,使用委托不用考虑程序集的问题,这样显然会方便很多。那么反射获取函数可以这样处理.
string TryParseDelegateFieldName = "TryParse_" + typeName;
FieldInfo tryParseFuncFieldInfo = typeof(DataTable).GetField(TryParseDelegateFieldName);
Delegate tryParseFunc = tryParseFuncFieldInfo?.GetValue(null) as Delegate;
~ 使用TryParse
这个时候因为已经获取到了TryParse的委托,那么只要调用Invoke去使用就可以了
object[] tryParseParameters = new object[2] { "", tryParseOutParameter };
(bool)tryParseFunc.Method.Invoke(tryParseFunc.Target, tryParseParameters);
(2)反射获取EmptyReplace
EmptyReplace其实只是为了当这个表格没有配置时,我期望能够有个默认的值,比如说bool类型,希望没有填值的时候能为“False”。基本反射获取也和上边的一样。这里就只放一下定义
using UnityEngine;
namespace Exporter
{
public static partial class EmptyReplace
{
public static string Default_int = "0";
public static string Default_float = "0";
public static string Default_double = "0";
public static string Default_bool = "FALSE";
public static string Default_Color = "#FFFFFF";
}
}
(3)属性类型
那么对于一个属性而言PropertyInfo,可以抽象如下
internal class PropertyInfo
{
private string typeName
public bool Check(string str)
public void ReplaceParse()
}
- typeName:属性类型名,在表中可区分哪个类型
- Check:类型的校验方式,用于检查数据是否正确
- ReplaceParse:这个主要是为了生成代码做处理,告知运行是如何转化数据为是个属性
这个两个方法基本在获取到TryPrase的时候就可以解决了。就不多赘述了,完整的代码如下,可供参考。
using System;
using System.Reflection;
using System.Text;
namespace Exporter
{
internal class PropertyInfo
{
private string typeName;
private bool isStringProperty;
private Delegate tryParseFunc;
public string emptyReplace;
private object tryParseOutParameter;
private object[] tryParseParameters;
private string TryParseDelegateFieldName => "TryParse_" + typeName;
private string EmptyReplaceFieldName => "Default_" + typeName;
public string EmptyReplace => emptyReplace;
public bool Init(string typeName)
{
this.typeName = typeName;
this.isStringProperty = typeName == "string";
if (isStringProperty)
{
emptyReplace = "";
return true;
}
else
{
FieldInfo tryParseFuncFieldInfo = typeof(DataTable).GetField(TryParseDelegateFieldName);
tryParseFunc = tryParseFuncFieldInfo?.GetValue(null) as Delegate;
FieldInfo emptyReplaceInfo = typeof(EmptyReplace).GetField(EmptyReplaceFieldName);
object value = emptyReplaceInfo?.GetValue(null);
emptyReplace = value != null ? value as string : "";
tryParseParameters = new object[2] { "", tryParseOutParameter };
return tryParseFunc != null;
}
}
public bool Check(string str)
{
if (isStringProperty)
{
return true;
}
else
{
tryParseParameters[0] = str;
return (bool)tryParseFunc.Method.Invoke(tryParseFunc.Target, tryParseParameters);
}
}
public void ReplaceParse(StringBuilder template, bool isArray, bool isOutputKey, string propertyName)
{
// 获取值
string getValueFromKey = "DataTable.GetStringFromKey";
string value = Config.Inst.PropertyParseValue;
if (isOutputKey)
{
value = getValueFromKey + "(" + value + ")";
}
// 获取函数
string TryParseDelegateName = "DataTable." + TryParseDelegateFieldName;
string parse = "";
if (isStringProperty && isArray)
{
// 字符数组
parse = string.Format("DataTable.SplitStrng({0})", value);
}
else if (isStringProperty && !isArray)
{
// 字符
parse = value;
}
else if (!isStringProperty && isArray)
{
// 其他属性数组
parse = "DataTable.ParseArr<{0}>({1}, {2})";
parse = string.Format(parse, typeName, value, TryParseDelegateName);
}
else if (!isStringProperty && !isArray)
{
// 其他属性
parse = "DataTable.Parse<{0}>({1}, {2})";
parse = string.Format(parse, typeName, value, TryParseDelegateName);
}
template.Replace("{parse}", parse);
}
}
}
(4)属性拓展
那在此之后,我们去拓展一个属性,只需要创建一个对应的委托即可!
比如Vector2Int,我们只需要在DataTable中写入转化函数即可。(这里是需要前置一个V,比如“V1,1000”,主要是为了区别数字与字符串。如果没有前置字符,Excel在常规时会认为他是个数,比如"1,1000",会被识别为数字11000,为了防止到时候失误,所以加了个V)
public static TryParseFunc<Vector2Int> TryParse_Vector2Int = (string text, out Vector2Int result) =>
{
if (!text.StartsWith("V"))
{
result = Vector2Int.zero;
return false;
}
string[] temp = text.Substring(1, text.Length - 1).Split(",");
int x, y;
if (temp.Length == 2 &&
int.TryParse(temp[0], out x) &&
int.TryParse(temp[1], out y))
{
result = new Vector2Int(x, y);
return true;
}
else
{
result = Vector2Int.zero;
return false;
}
};
2. 模板处理
代码模板独立成一个文本Template_code.txt,这样比起在UnIty中会更容易更改,另外重新更改了替换方式,尽量将能改的内容都写在样本中。
(1)替换内容
模板最常用的就是替换啦,这里我们可以设定“ {sheetName}“ 和“{fileName}”这两个字符,这样可以用于替换文件名和表格名。
(2)属性段
对于一个属性,要替换的内容有类型,名字之类的,但因为属性数量不同,所以单纯的替换就比较麻烦,这里加入属性段的概念,[properties][propertiesEnd]用于标记属性段,此时标记的部分就会按照属性来依次重复,然后对应的去替换属性的相关值
(3)模板特殊符号定义
那么,我们约定模板内的特殊符号以及其作用。
内容 | 作用 |
---|---|
{fileName} | 替换文件名 |
{sheetName} | 替换表格名 |
{parse} | 替换属性转化方式 |
{type} | 替换属性类型 |
{name} | 替换属性名字 |
{note} | 替换属性注释 |
{setting} | 替换属性设置 |
[properties] | 标记属性段的开始 |
[properties] | 标记属性段的结束 |
(4)模板
估计单讲没什么感觉,直接看模板估计就知道这么设定的作用了。
using System.Collections.Generic;
using UnityEngine;
using Exporter;
namespace GDT
{
/// <summary>
/// {sheetName} data,{fileName}.xlsx
/// </summary>
public class DR{sheetName}: IDataRow
{
[properties]
/// <summary>
/// {note} {setting}
/// </summary>
public {type} {name} { get; protected set; }
[propertiesEnd]
public void ParseDataRow(string input)
{
string[] text = input.Split('\t');
int index = 0;
[properties]
{name} = {parse};
[propertiesEnd]
}
private void AvoidJIT()
{
new Dictionary<int, DR{sheetName}>();
}
}
}
3. 面板优化
主要是之前只弹出提示窗口显示有限,而且显示不完,所以特地额外弄了个窗口来显示这个内容。然后加了点富文本,方便显示。具体就不说怎么弄了,项目里面都有。关于Editor相关的内容以后再写文章记录一下吧。现在就简单放一下图吧。
4. 结束咯
这个处理的主要内容就讲完咯,下回有空再见吧。以后的可能会完善的内容有,关联额外检查、公式导出、Json导出等。不过等用到了再去弄吧,做这个东西还挺花时间的。然后,使用上有问题的话,可以再Q我.