using System; using System.Collections.Generic; using System.Data; using System.Text; namespace Apewer.Source { /// 数据库客户端。 public interface IDbOrm { #region object /// 初始化指定类型,以创建表或增加字段。 /// 要初始化的类型。 /// 指定新的表名。 /// 错误信息。当成功时候返回空字符串。 public string Initialize(Type model, string table = null); /// 初始化指定类型,以创建表或增加字段。 /// 指定新的表名。 /// 错误信息。当成功时候返回空字符串。 public string Initialize(string table = null) where T : class, new(); /// 插入记录。 /// 要插入的记录实体。 /// 插入到指定表。当不指定时,由 record 类型决定。 /// 调整数据模型,补充缺少的属性。 /// 错误信息。当成功时候返回空字符串。 public string Insert(object record, string table = null, bool adjust = true); /// 使用指定语句查询,获取查询结果。 /// 目标记录的类型。 /// 要执行的 SQL 语句。 /// 为 SQL 命令提供参数。 /// /// /// /// public object[] Query(Type model, string sql, IEnumerable parameters = null); /// 使用指定语句查询,获取查询结果。 /// 要执行的 SQL 语句。 /// 为 SQL 命令提供参数。 /// /// /// /// public T[] Query(string sql, IEnumerable parameters = null) where T : class, new(); #endregion #region record /// 更新记录。 /// 要插入的记录实体。 /// 插入到指定表。当不指定时,由 record 类型决定。 /// 调整数据模型,补充缺少的属性。 /// 错误信息。当成功时候返回空字符串。 public string Update(IRecord record, string table = null, bool adjust = true); /// 获取指定类型的主键,按 Flag 属性筛选。 /// 要查询的类型。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// /// public string[] Keys(Type model, long flag = 0); /// 获取指定类型的主键,按 Flag 属性筛选。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// public string[] Keys(long flag = 0) where T : class, IRecord, new(); /// 获取具有指定 Key 的记录,并要求记录具有指定的 Flag 属性。 /// 目标记录的类型。 /// 目标记录的主键。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// /// public object Get(Type model, string key, long flag = 0); /// 获取具有指定 Key 的记录,并要求记录具有指定的 Flag 属性。 /// 目标记录的主键。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// public T Get(string key, long flag = 0) where T : class, IRecord, new(); /// 查询所有记录。 /// 目标记录的类型。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// /// public object[] List(Type model, long flag = 0); /// 查询所有记录。 /// 要求目标记录具有的 Flag 属性,当指定 0 时忽略此要求。 /// /// public T[] List(long flag = 0) where T : class, IRecord, new(); #endregion } }