Ellpeck/MLEM
1
0
Fork 0
mirror of https://github.com/Ellpeck/MLEM.git synced 2024-11-29 23:58:34 +01:00
Code Issues Projects Releases Wiki Activity

extract GenericDataHolder behavior into an interface

Browse source
This commit is contained in:
Ell 2020-12-18 16:39:52 +01:00
parent 106102adf6
commit 1f40129ad3
1 changed files with 35 additions and 21 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

56
MLEM/Misc/GenericDataHolder.cs
View file

@ -3,21 +3,14 @@ using System.Collections.Generic;
using System.Runtime.Serialization; using System.Runtime.Serialization;
namespace MLEM.Misc { namespace MLEM.Misc {
/// <summary> /// <inheritdoc />
/// Represents an object that can hold generic key-value based data.
/// A lot of MLEM components extend this class to allow for users to add additional data to them easily.
/// </summary>
[DataContract] [DataContract]
public class GenericDataHolder { public class GenericDataHolder : IGenericDataHolder {
[DataMember] [DataMember(EmitDefaultValue = false)]
private Dictionary<string, object> data; private Dictionary<string, object> data;
/// <summary> /// <inheritdoc />
/// Store a piece of generic data on this object.
/// </summary>
/// <param name="key">The key to store the data by</param>
/// <param name="data">The data to store in the object</param>
public void SetData(string key, object data) { public void SetData(string key, object data) {
if (data == default) { if (data == default) {
if (this.data != null) if (this.data != null)
@ -29,22 +22,14 @@ namespace MLEM.Misc {
} }
} }
/// <summary> /// <inheritdoc />
/// Returns a piece of generic data of the given type on this object.
/// </summary>
/// <param name="key">The key that the data is stored by</param>
/// <typeparam name="T">The type of the data stored</typeparam>
/// <returns>The data, or default if it doesn't exist</returns>
public T GetData<T>(string key) { public T GetData<T>(string key) {
if (this.data != null && this.data.TryGetValue(key, out var val) && val is T t) if (this.data != null && this.data.TryGetValue(key, out var val) && val is T t)
return t; return t;
return default; return default;
} }
/// <summary> /// <inheritdoc />
/// Returns all of the generic data that this object stores.
/// </summary>
/// <returns>The generic data on this object</returns>
public IReadOnlyCollection<string> GetDataKeys() { public IReadOnlyCollection<string> GetDataKeys() {
if (this.data == null) if (this.data == null)
return Array.Empty<string>(); return Array.Empty<string>();
@ -52,4 +37,33 @@ namespace MLEM.Misc {
} }
} }
/// <summary>
/// Represents an object that can hold generic key-value based data.
/// A lot of MLEM components extend this class to allow for users to add additional data to them easily.
/// </summary>
public interface IGenericDataHolder {
/// <summary>
/// Store a piece of generic data on this object.
/// </summary>
/// <param name="key">The key to store the data by</param>
/// <param name="data">The data to store in the object</param>
void SetData(string key, object data);
/// <summary>
/// Returns a piece of generic data of the given type on this object.
/// </summary>
/// <param name="key">The key that the data is stored by</param>
/// <typeparam name="T">The type of the data stored</typeparam>
/// <returns>The data, or default if it doesn't exist</returns>
T GetData<T>(string key);
/// <summary>
/// Returns all of the generic data that this object stores.
/// </summary>
/// <returns>The generic data on this object</returns>
IReadOnlyCollection<string> GetDataKeys();
}
} }