SmartSql使用教程 ---- 使用动态代理实现CURD

绝地灬酷狼 2021-09-19 11:12 250阅读 0赞

# 一、引言 #

接着上一篇的教程，本章我们继续讲SmartSql。今天的主题是动态仓储。

老规矩，先上一个项目结构

![572600-20190516172217749-1116607104.png][]

从第二章开始。我们将原来的单一项目做了一个分离。方便之后的更新。

在这个结构中。原本上一章的DataAccess没有了。取而代之的是Repository。这个就是动态仓储的项目。接下来我们从这个Repository项目开始说。这也是动态仓储的核心。

# 二、Repository项目 #

## 1. Nuget依赖 ##

SmartSql有一个独立的动态仓储库，即：SmartSql.DyRepository。如果你想使用动态仓储，引用它就行啦。

## 2. 第一个仓储接口 ##

引用完库，接下来就是创建我们的第一个仓储接口—IArticleRepository。废话不到，先上代码再一一解释。

![ContractedBlock.gif][] IArticleRepository

如果你对编程感兴趣或者想往编程方向发展，可以关注微信公众号**【筑梦编程】**，大家一起交流讨论！小编也会每天定时更新既有趣又有用的编程知识！

### 2.1 默认接口 IRepository ###

看完代码是不是发现和上一章的DataAccess有很大的区别，那些CURD的方法都没有了。

这是SmartSql内置的一些默认接口，它包括以下这些接口，这些接口基本可以满足大部分普通业务场景了。

![复制代码][copycode.gif]

1 int Insert(TEntity entity);
     2 
     3 int Update(TEntity entity);
     4 
     5 [Statement(Id = "Update")]
     6 int DyUpdate(object dyObj);
     7 
     8 int Delete(object reqParams);
     9 
    10 [Statement(Id = "Delete")]
    11 int DeleteById([Param("Id")] TPrimary id);
    12 
    13 TEntity GetEntity(object reqParams);
    14 
    15 [Statement(Id = "GetEntity")]
    16 TEntity GetById([Param("Id")] TPrimary id);
    17 
    18 [Statement(Execute = ExecuteBehavior.ExecuteScalar)]
    19 int GetRecord(object reqParams);
    20 
    21 IList<TEntity> QueryByPage(object reqParams);
    22 
    23 IList<TEntity> Query(object reqParams);
    24 
    25 [Statement(Execute = ExecuteBehavior.ExecuteScalar)]
    26 bool IsExist(object reqParams);

![复制代码][copycode.gif]

### 2.2 SqlMap特性 ###

这个特性是用于指定Scope的配置。这个对应于Map中的Scope属性。这里我定义了“CustomScope”。那对应的Map中也将与之对应。如下图：

![572600-20190516174321829-1746129369.png][]

### 2.3 Statement特性 ###

这个特性略微有点复杂，其中包含了6个属性，接下来我们一个个看。

2.3.1 Scope

这个特性和SqlMap的Scope作用是一样的。区别在于Statement的级别更高。

2.3.2 Id

指定此函数所使用的Statement。依据是Id。例：

// 接口定义
    [Statement(Id = "TestId")]
    int CustomStatementId();

<Statement Id="TestId">
        db script...
    </Statement>

2.3.3 Execute

Execute是一个ExecuteBehavior枚举，用于指定此函数执行Sql脚本的方式。

<table>  ExecuteBehavior  
 <tbody> 
  <tr> 
   <td>Auto</td> 
   <td>ORM自动识别</td> 
  </tr> 
  <tr> 
   <td>Execute</td> 
   <td>返回影响行数，主要用于执行写操作。</td> 
  </tr> 
  <tr> 
   <td>ExecuteScalar</td> 
   <td>返回第一行第一列的数据，主要用于返回自增主键和获取结果数</td> 
  </tr> 
  <tr> 
   <td>Query</td> 
   <td>返回List</td> 
  </tr> 
  <tr> 
   <td>QuerySingle</td> 
   <td>返回第一行数据</td> 
  </tr> 
  <tr> 
   <td>GetDataTable</td> 
   <td>返回DataTable</td> 
  </tr> 
  <tr> 
   <td>GetDataSet</td> 
   <td>返回DataSet</td> 
  </tr> 
 </tbody> 
</table>

2.3.4 Sql

特殊场景下，可以直接使用此属性定义Sql脚本，而不用配置SqlMap。如IArticleRepository的OnlineArticle定义。

2.3.5 CommandType

这个属性是ADO.NET的CommandType枚举。作用也完全相同

2.3.6 SourceChoice

指定数据源，可以指定Write或Read。

## 3. Startup ##

在上一章节中，我们在Startup中注册了SmartSql，现在我们要继续注册动态仓储。代码也很简单，只要在AddSmart方法完成后继续调用AddRepositoryFromAssembly即可。如下：

![复制代码][copycode.gif]

services.AddSmartSql(builder =>
    {
        builder.UseAlias("SmartSqlSampleChapterTwo");       // 定义实例别名，在多库场景下适用。
        //.UseXmlConfig(ResourceType.File,"MyConfig.xml");
    }).AddRepositoryFromAssembly(options =>
    {
        // SmartSql实例的别名
        options.SmartSqlAlias = "SmartSqlSampleChapterTwo";
        // 仓储接口所在的程序集全称
        options.AssemblyString = "SmartSqlSampleChapterTwo.Repository";
        // 筛选器，根据接口的Type筛选需要的仓储
        options.Filter = type => type.FullName.Contains("Sample");
        // Scope模板，默认是"I{Scope}Repository"
        options.ScopeTemplate = "I{Scope}Repository";
    });

![复制代码][copycode.gif]

这个方法中会抛出一个AssemblyAutoRegisterOptions，方便用户注册指定的仓储。

## 4. Controller的变化 ##

在Sample中，我们直接让Controller引用了Repository，实际场景中。我们可以在任何需要仓储的地方引用仓储。代码如下：

![ContractedBlock.gif][] ArticleController

可以注意到的是，除了把DataAccess变成了Repository。其他的代码几乎没有改动。最后我还添加了仓储自定义的接口的调用。

## 5. 结语 ##

今天，我们了解了动态仓储的使用。它是一个非常方便的特性，可以非常显著的提升我们写代码的效率，减少一定的代码量，避免了很多“体力活”。让我们专注于业务！

[572600-20190516172217749-1116607104.png]: /images/20210812/36c87c532348448881ae654a203f2777.png
[ContractedBlock.gif]: /images/20210812/c50943315d5a45a29ef1155a9c0d47f6.png
[copycode.gif]: /images/20210812/ba166f56ed58417bb2e0664ebf2250df.png
[572600-20190516174321829-1746129369.png]: /images/20210812/cac8dad6fac84d5fa7057d9800ecb815.png