using HslCommunication.Core; using System; using System.IO; using System.Text; namespace HslCommunication.BasicFramework { /***************************************************************************** * * 一些类的基类,实现一些共同的基础功能 * * Create Date : 2017-05-03 17:45:37 * * * 2018年3月6日 21:38:37 * 修改:提炼接口,完善注释和分块 * * *****************************************************************************/ /// <summary> /// 支持字符串信息加载存储的接口,定义了几个通用的方法 /// </summary> public interface ISoftFileSaveBase { /// <summary> /// 获取需要保存的数据,需要重写实现 /// </summary> /// <returns>需要存储的信息</returns> string ToSaveString(); /// <summary> /// 从字符串加载数据,需要重写实现 /// </summary> /// <param name="content">字符串数据</param> void LoadByString(string content); /// <summary> /// 不使用解密方法从文件读取数据 /// </summary> void LoadByFile(); /// <summary> /// 不使用加密方法保存数据到文件 /// </summary> void SaveToFile(); /// <summary> /// 文件路径的存储 /// </summary> string FileSavePath { get; set; } } /// <summary> /// 文件存储功能的基类,包含了文件存储路径,存储方法等 /// </summary> /// <remarks> /// 需要继承才能实现你想存储的数据,比较经典的例子就是存储你的应用程序的配置信息,通常的格式就是xml文件或是json文件。具体请看例子: /// </remarks> /// <example> /// 下面举例实现两个字段的普通数据存储 /// <code lang="cs" source="HslCommunication_Net45.Test\Documentation\Samples\BasicFramework\SoftFileSaveBaseExample.cs" region="SoftFileSaveBase1" title="简单示例" /> /// 然后怎么调用呢? /// <code lang="cs" source="HslCommunication_Net45.Test\Documentation\Samples\BasicFramework\SoftFileSaveBaseExample.cs" region="Example" title="调用示例" /> /// 如果你想实现加密存储,这样就不用关心被用户看到了。 /// <code lang="cs" source="HslCommunication_Net45.Test\Documentation\Samples\BasicFramework\SoftFileSaveBaseExample.cs" region="SoftFileSaveBase2" title="加密示例" /> /// 如果还是担心被反编译获取数据,那么这个密钥就要来自服务器的数据,本地不做存储。 /// </example> public class SoftFileSaveBase : ISoftFileSaveBase { #region Constructor /// <summary> /// 实例化一个文件存储的基类 /// </summary> public SoftFileSaveBase() { HybirdLock = new SimpleHybirdLock(); } #endregion #region Private Member private SimpleHybirdLock HybirdLock; // 文件存储的同步锁 #endregion #region Protect Member /// <summary> /// 在日志保存时的标记当前调用类的信息 /// </summary> protected string LogHeaderText { get; set; } #endregion #region Save Load String /// <summary> /// 获取需要保存的数据,需要重写实现 /// </summary> /// <returns>需要存储的信息</returns> public virtual string ToSaveString() { return string.Empty; } /// <summary> /// 从字符串加载数据,需要重写实现 /// </summary> /// <param name="content">字符串数据</param> public virtual void LoadByString(string content) { } #endregion #region Save Load File /// <summary> /// 不使用解密方法从文件读取数据 /// </summary> public virtual void LoadByFile() { LoadByFile(m => m); } /// <summary> /// 使用用户自定义的解密方法从文件读取数据 /// </summary> /// <param name="decrypt">用户自定义的解密方法</param> public void LoadByFile(Converter<string, string> decrypt) { if (FileSavePath != "") { if (File.Exists(FileSavePath)) { HybirdLock.Enter(); try { using (StreamReader sr = new StreamReader(FileSavePath, Encoding.Default)) { LoadByString(decrypt(sr.ReadToEnd())); } } catch (Exception ex) { ILogNet?.WriteException(LogHeaderText, StringResources.Language.FileLoadFailed, ex); } finally { HybirdLock.Leave(); } } } } /// <summary> /// 不使用加密方法保存数据到文件 /// </summary> public virtual void SaveToFile() { SaveToFile(m => m); } /// <summary> /// 使用用户自定义的加密方法保存数据到文件 /// </summary> /// <param name="encrypt">用户自定义的加密方法</param> public void SaveToFile(Converter<string, string> encrypt) { if (FileSavePath != "") { HybirdLock.Enter(); try { using (StreamWriter sw = new StreamWriter(FileSavePath, false, Encoding.Default)) { sw.Write(encrypt(ToSaveString())); sw.Flush(); } } catch (Exception ex) { ILogNet?.WriteException(LogHeaderText, StringResources.Language.FileSaveFailed, ex); } finally { HybirdLock.Leave(); } } } #endregion /// <summary> /// 文件存储的路径 /// </summary> public string FileSavePath { get; set; } /// <summary> /// 日志记录类 /// </summary> public LogNet.ILogNet ILogNet { get; set; } } }