DataRabbit 轻量的数据访问框架(06) -- IRelationAccesser

   (完全限定类名:DataRabbit.Relation.IRelationAccesser) 
   
   前面介绍的IOrmAccesser是对单表进行ORM访问,而ITableAccesser是对单表进行基于关系的访问,如果我们要进行联合查询这样的跨表搜索,则使用它们就无法达成目标。这时,你可以使用IRelationAccesser。与IOrmAccesser和ITableAccesser的针对性不同(它们针对数据库中的某个表),IRelationAccesser针对的是整个目标数据库。在DataRabbit中,所有的跨表操作推荐使用IRelationAccesser来完成(除非以后有更好的解决方案)。

   IRelationAccesser将数据访问分成两类:Query和Command。Query返回DataSet,Command没有返回值。另外,IRelationAccesser还支持执行带有参数的查询语句。
   我们可以从DataRabbit的入口点IDataAccesser中获取IRelationAccesser引用: 
   IRelationAccesser relationAccesser = dataAccesser.GetRelationAccesser(null);

   IRelationAccesser接口的完整定义如下,仅仅包含三个方法:
    public interface IRelationAccesser : ITransactionAccesser
    {
        
/// <summary>
        
/// DoCommand 执行数据命令
        
/// </summary>       
        void DoCommand(string command);

        
// <summary>
        /// DoQuery 执行查询数据
        
/// </summary>  
        DataSet DoQuery(string query);

        
/// <summary>
        
/// ExcuteRegularQuery 执行带有参数的查询语句,参数值由paraValues给出。
        
/// </summary>       
        /// <param name="regularQuery">带参数的查询语句</param>
        /// <param name="paraPrefix">查询语句中参数的前缀,该前缀可以用户自定义</param>    
        /// <param name="paraValues">键为参数名,不带参数前缀</param>    
          
        DataSet ExcuteRegularQuery(string regularQuery, string paraPrefix, IDictionary<stringobject> paraValues);       
    }    
   假设,我们要进行一个联合查询,可以这样做:
   string joinSelect = "SELECT ErrorDetail.*, TaskError.Location FROM ErrorDetail INNER JOIN TaskError ON ErrorDetail.ErrorID = TaskError.ID WHERE (TaskError.ID = '1')";
   DataSet ds 
= relationAccesser.DoQuery(joinSelect);
   如果想使用参数化的查询,可以调用ExcuteRegularQuery方法,我们现在通过调用ExcuteRegularQuery方法来实现上面的功能:
   string joinSelect = "SELECT ErrorDetail.*, TaskError.Location FROM ErrorDetail INNER JOIN TaskError ON ErrorDetail.ErrorID = TaskError.ID WHERE (TaskError.ID = @ID)";         
   
//准备参数
   IDictionary<stringobject> dic = new Dictionary<stringobject>();
   dic.Add(
"ID"1);//参数名不用带参数前缀
   
//查询
   DataSet ds2 = relationAccesser.ExcuteRegularQuery(joinSelect, "@", dic);
   特别要注意的是,ExcuteRegularQuery方法中的paraPrefix参数用于表示查询语句中所使用的参数前缀,这个前缀用户可以自己指定,DataRabbit在执行前会自动将其转换为数据库所要求的参数前缀。比如,如果后台数据库是Oracle,上述语句的参数前缀“@”会被自动转换成Oracle所要求的前缀“:”。


转到:DataRabbit 轻量的数据访问框架 -- 序 



   
上一篇:Java项目:个人博客系统(前后端分离+java+vue+Springboot+ssm+mysql+maven+redis)


下一篇:DataRabbit 轻量的数据访问框架(02) -- IOrmAccesser