Json.NET提供依赖注
[.NET] 使用Json.NET提供依赖注入功能(Dependence Injection)
前言
在一些小型项目的开发情景里,系统不需要大型DI Framework所提供的:单一对象生成、生命周期管理...等等延伸功能,只需要,单纯使用反射生成功能,从配置文件取得功能对象来注入到系统。在这样的开发情景中,如果选择Spring .NET、Unity来做为系统的依赖注入模块,无形中就增加了系统的技术门坎、增加了开发人员的知识负担。
本篇文章介绍如何使用Json.NET来反射生成JSON配置文件中所定义的功能对象,让开发人员能够透过设定简单的JSON档案、简洁易懂的指令,来提供系统使用依赖注入的功能。主要为自己留个纪录,也希望能帮助到有需要的开发人员。
开发
加入Json.NET
使用Visual Studio开启项目之后,开发人员可以透过内建的NuGet封装管理员来安装Json.NET套件。
建立依赖注入的接口与实作
建立项目并且加入Json.NET套件之后,就可以先着手在项目内,建立系统所需要依赖注入的接口与实作。
public interface IAnimal
{
// Methods
void Hit();
}
public class Dog : IAnimal
{
// Methods
public void Hit()
{
Console.WriteLine("Dog : " + "Running");
}
}
public class Cat : IAnimal
{
// Fields
private readonly string _cry = null;
// Constructors
public Cat(string cry)
{
// Default
_cry = cry;
}
// Methods
public void Hit()
{
Console.WriteLine("Cat : "+ _cry);
}
}
建立反射生成的配置文件
接着使用Json.NET所定义的格式,来建立对象反射生成所需要的JSON配置文件。在这份配置文件中,每个对象的「$type」属性使用逗号来切割内容。逗号前的内容,代表了这个对象的命名空间+类别名称;逗号后的内容代表了这个对象的组件名称。而其他「$type」之外的属性,则是会被剖析为对象的建构参数、对象属性。
[
{
"$type": "JsonDISample.Dog, JsonDISample"
},
{
"$type": "JsonDISample.Cat, JsonDISample",
"cry": "Meow"
},
{
"$type": "JsonDISample.Cat, JsonDISample",
"cry": "Purr"
}
]
使用Json.NET注入物件
最后使用下列程序代码,从档案中读取JSON配置文件内容,再使用JsonConvert.DeserializeObject反射生成对象,就可以将Json.NET生成的接口与实作,注入系统来使用。另外,在这段程序代码中,要特别注意「JsonSerializerSettings.TypeNameHandling」这个属性必须要设定为All,这样Json.NET才会特别去处理$type属性来反射生成指定对象。
static void Main(string[] args)
{
// ConfigJson
string configJson = System.IO.File.ReadAllText("animals.json");
if (configJson == null) throw new InvalidOperationException();
// SerializerSettings
var serializerSettings = new JsonSerializerSettings();
serializerSettings.TypeNameHandling = TypeNameHandling.All;
// Animal
var animalList = JsonConvert.DeserializeObject<List<IAnimal>>(configJson, serializerSettings);
if (animalList == null) throw new InvalidOperationException();
// Hit
foreach (var animal in animalList)
{
animal.Hit();
}
// End
Console.ReadLine();
}
执行
完成开发步骤后,就可以按下Visual Studio的执行按钮来检视成果。接着观察程序执行的结果,可以发现系统的确依照JSON配置文件的内容,动态生成对象、并且提供这些对象给系统使用。
范例下载
范例程序:点此下载