如何用新的 ISerializable class 替换旧版 class
How to replace a legacy class with a new ISerializable class
我们有一个遗产 class A
,它是 [Serializable]
,但不是 ISerializable
。
由于各种原因,必须修补此 class 以实现 ISerializable。
问题是我们仍然需要能够加载旧的保存文件,这些文件使用 .NET 的默认实现来序列化 class A
。
换句话说,当加载旧的存档文件时,class A
必须像旧版本一样反序列化,然后转换为新版本的 class A
,这样在保存时同样,我们使用了 ISerializable
的新实现。
在不破坏向后兼容性的情况下修补 class A
的最合适方法是什么?
解决方案 1
首先,更改项目的程序集版本。
// AssemblyInfo.cs:
[assembly: AssemblyVersion("2.0.0.0")]
为游戏存档数据创建一个新类型。
// The legacy savegame data. Keep it as it is.
[Serializable]
public class Savegame
{
// ... the legacy fields
}
// The new savegame data. This implements ISerializable
[Serializable]
public class SavegameNew : Savegame, ISerializable
{
// this constructor will execute on deserialization. You will deserialize
// both the legacy and new types here.
private SavegameNew(SerializationInfo info, StreamingContext context)
{
foreach (SerializationEntry entry in info)
{
// you can iterate the serialized elements like this
// if this is a new format you will get the new elements, too
}
}
public void GetObjectData(SerializationInfo info, StreamingContext context)
{
// custom serialization of the new type
}
}
现在您需要一个将旧格式映射到新格式的活页夹 class:
internal class SavegameBinder : SerializationBinder
{
public override Type BindToType(string assemblyName, string typeName)
{
// Of course, use the assembly version of the old version here.
// You don't even need to change the assembly version, though than can lead to ambiguity
AssemblyName asmName = new AssemblyName(assemblyName);
if (asmName.Version == new Version(1, 0, 0, 0) && typeName == typeof(Savegame).FullName)
return typeof(SavegameNew);
// otherwise we do not change the mapping
return null;
}
}
你可以这样使用它:
// the saveStream can contain either the old other the new format
BinaryFormatter bf = new BinaryFormatter() { Binder = new SavegameBinder() };
SavegameNew data = (SavegameNew)bf.Deserialize(saveStream);
解决方案 2
使用此解决方案,您无需将 Savegame
映射到 SavegameNew
。如果不更改程序集版本,您甚至不需要活页夹 class.
如果更改程序集版本,SavegameBinder
应该 return 新程序集的 Savegame
类型。遗留 Savegame
应该实现 IObjectReference
接口,所以一旦它被反序列化,它就可以 return 一个 SavegameNew
实例。
// The legacy savegame data
[Serializable]
public class Savegame: IObjectReference
{
// ... the legacy fields
public object GetRealObject(StreamingContext context)
{
return new SavegameNew(...);
}
}
我们有一个遗产 class A
,它是 [Serializable]
,但不是 ISerializable
。
由于各种原因,必须修补此 class 以实现 ISerializable。
问题是我们仍然需要能够加载旧的保存文件,这些文件使用 .NET 的默认实现来序列化 class A
。
换句话说,当加载旧的存档文件时,class A
必须像旧版本一样反序列化,然后转换为新版本的 class A
,这样在保存时同样,我们使用了 ISerializable
的新实现。
在不破坏向后兼容性的情况下修补 class A
的最合适方法是什么?
解决方案 1
首先,更改项目的程序集版本。
// AssemblyInfo.cs:
[assembly: AssemblyVersion("2.0.0.0")]
为游戏存档数据创建一个新类型。
// The legacy savegame data. Keep it as it is.
[Serializable]
public class Savegame
{
// ... the legacy fields
}
// The new savegame data. This implements ISerializable
[Serializable]
public class SavegameNew : Savegame, ISerializable
{
// this constructor will execute on deserialization. You will deserialize
// both the legacy and new types here.
private SavegameNew(SerializationInfo info, StreamingContext context)
{
foreach (SerializationEntry entry in info)
{
// you can iterate the serialized elements like this
// if this is a new format you will get the new elements, too
}
}
public void GetObjectData(SerializationInfo info, StreamingContext context)
{
// custom serialization of the new type
}
}
现在您需要一个将旧格式映射到新格式的活页夹 class:
internal class SavegameBinder : SerializationBinder
{
public override Type BindToType(string assemblyName, string typeName)
{
// Of course, use the assembly version of the old version here.
// You don't even need to change the assembly version, though than can lead to ambiguity
AssemblyName asmName = new AssemblyName(assemblyName);
if (asmName.Version == new Version(1, 0, 0, 0) && typeName == typeof(Savegame).FullName)
return typeof(SavegameNew);
// otherwise we do not change the mapping
return null;
}
}
你可以这样使用它:
// the saveStream can contain either the old other the new format
BinaryFormatter bf = new BinaryFormatter() { Binder = new SavegameBinder() };
SavegameNew data = (SavegameNew)bf.Deserialize(saveStream);
解决方案 2
使用此解决方案,您无需将 Savegame
映射到 SavegameNew
。如果不更改程序集版本,您甚至不需要活页夹 class.
如果更改程序集版本,SavegameBinder
应该 return 新程序集的 Savegame
类型。遗留 Savegame
应该实现 IObjectReference
接口,所以一旦它被反序列化,它就可以 return 一个 SavegameNew
实例。
// The legacy savegame data
[Serializable]
public class Savegame: IObjectReference
{
// ... the legacy fields
public object GetRealObject(StreamingContext context)
{
return new SavegameNew(...);
}
}