Deployed 6f54e5a8 with MkDocs version: 1.0.4

about/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         

index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="user-guide/design-principle.md.md">Design Principle</a>
+    <a href="user-guide/design-principle/">Design Principle</a>
 </li>
 
                         
@@ -298,5 +298,5 @@
 
 <!--
 MkDocs version : 1.0.4
-Build Date UTC : 2019-02-02 11:35:20
+Build Date UTC : 2019-02-10 08:10:02
 -->

sitemap.xml

@@ -2,82 +2,82 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
-     <loc></loc>
-     
+     <loc>None</loc>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
     <url>
      <loc>None</loc>
-     <lastmod>2019-02-02</lastmod>
+     <lastmod>2019-02-10</lastmod>
      <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file

user-guide-cn/api-interface/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         

user-guide-cn/configuration/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         
@@ -211,17 +211,26 @@
         
         <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
     <ul class="nav bs-sidenav">
-        <li class="first-level active"><a href="#cap-options">Cap Options</a></li>
-        <li class="first-level "><a href="#rabbitmq-options">RabbitMQ Options</a></li>
-        <li class="first-level "><a href="#kafka-options">Kafka Options</a></li>
-        <li class="first-level "><a href="#entityframework-options">EntityFramework Options</a></li>
-        <li class="first-level "><a href="#sqlserver-options">SqlServer Options</a></li>
-        <li class="first-level "><a href="#mysql-options">MySql Options</a></li>
-        <li class="first-level "><a href="#postgresql-options">PostgreSql Options</a></li>
+        <li class="first-level active"><a href="#_1">配置</a></li>
+            <li class="second-level"><a href="#cap-options">Cap Options</a></li>
+                
+            <li class="second-level"><a href="#rabbitmq-options">RabbitMQ Options</a></li>
+                
+            <li class="second-level"><a href="#kafka-options">Kafka Options</a></li>
+                
+            <li class="second-level"><a href="#entityframework-options">EntityFramework Options</a></li>
+                
+            <li class="second-level"><a href="#sqlserver-options">SqlServer Options</a></li>
+                
+            <li class="second-level"><a href="#mysql-options">MySql Options</a></li>
+                
+            <li class="second-level"><a href="#postgresql-options">PostgreSql Options</a></li>
+                
     </ul>
 </div></div>
         <div class="col-md-9" role="main">
 
+<h2 id="_1">配置</h2>
 <p>CAP 使用 Microsoft.Extensions.DependencyInjection 进行配置的注入，你也可以依赖于 DI 从json文件中读取配置。</p>
 <h3 id="cap-options">Cap Options</h3>
 <p>你可以使用如下方式来配置 CAP 中的一些配置项，例如</p>

user-guide-cn/design-principle/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         
@@ -211,19 +211,25 @@
         
         <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
     <ul class="nav bs-sidenav">
-        <li class="first-level active"><a href="#_1">动机</a></li>
-        <li class="first-level "><a href="#_2">持久化</a></li>
-        <li class="first-level "><a href="#_3">通讯数据流</a></li>
-        <li class="first-level "><a href="#_4">一致性</a></li>
+        <li class="first-level active"><a href="#_1">设计原理</a></li>
+            <li class="second-level"><a href="#_2">动机</a></li>
+                
+            <li class="second-level"><a href="#_3">持久化</a></li>
+                
+            <li class="second-level"><a href="#_4">通讯数据流</a></li>
+                
+            <li class="second-level"><a href="#_5">一致性</a></li>
+                
     </ul>
 </div></div>
         <div class="col-md-9" role="main">
 
-<h3 id="_1">动机</h3>
+<h2 id="_1">设计原理</h2>
+<h3 id="_2">动机</h3>
 <p>随着微服务架构的流行，越来越多的人在尝试使用微服务来架构他们的系统，而在这其中我们会遇到例如分布式事务的问题，为了解决这些问题，我没有发现简单并且易于使用的解决方案，所以我决定来打造这样一个库来解决这个问题。</p>
 <p>最初 CAP 是为了解决分布式系统中的事务问题，她采用的是 异步确保 这种弱一致性事务机制实现了分布式事务的最终一致性，更多这方面的信息可以查看第6节。</p>
 <p>现在 CAP 除了解决分布式事务的问题外，她另外一个重要的功能就是作为 EventBus 来使用，她具有 EventBus 的所有功能，并且提供了更加简化的方式来处理EventBus中的发布/订阅。</p>
-<h3 id="_2">持久化</h3>
+<h3 id="_3">持久化</h3>
 <p>CAP 依靠本地数据库实现消息的持久化，CAP 使用这种方式来应对一切环境或者网络异常导致消息丢失的情况，消息的可靠性是分布式事务的基石，所以在任何情况下消息都不能丢失。</p>
 <p>对于消息的持久化分为两种：</p>
 <p><strong>① 消息进入消息队列之前的持久化</strong></p>
@@ -233,7 +239,7 @@
 <p>消息进入到消息队列之后，CAP会启动消息队列的持久化功能，我们需要说明一下在 RabbitMQ 和 Kafka 中CAP的消息是如何持久化的。</p>
 <p>针对于 RabbitMQ 中的消息持久化，CAP 使用的是具有消息持久化功能的消费者队列，但是这里面可能有例外情况，参加 2.2.1 章节。</p>
 <p>由于 Kafka 天生设计的就是使用文件进行的消息持久化，在所以在消息进入到Kafka之后，Kafka会保证消息能够正确被持久化而不丢失。</p>
-<h3 id="_3">通讯数据流</h3>
+<h3 id="_4">通讯数据流</h3>
 <p>CAP 中消息的流转过程大致如下：</p>
 <p><strong>2.2版本以前</strong> </p>
 <p><img alt="" src="http://images2017.cnblogs.com/blog/250417/201708/250417-20170803174645928-1813351415.png" /></p>
@@ -242,7 +248,7 @@
 </blockquote>
 <p><strong>2.2版本以后</strong></p>
 <p>在2.2以后的版本中，我们调整了一些消息的流转流程，我们移除了数据库中的 Queue 表使用内存队列来代替，详情见:<a href="https://github.com/dotnetcore/CAP/issues/96">Improve the implementation mechanism of queue mode</a></p>
-<h3 id="_4">一致性</h3>
+<h3 id="_5">一致性</h3>
 <p>CAP 采用最终一致性作为的一致性方案，此方案是遵循 CAP 理论，以下是CAP理论的描述。</p>
 <p>C（一致性）一致性是指数据的原子性，在经典的数据库中通过事务来保障，事务完成时，无论成功或回滚，数据都会处于一致的状态，在分布式环境下，一致性是指多个节点数据是否一致；</p>
 <p>A（可用性）服务一直保持可用的状态，当用户发出一个请求，服务能在一定的时间内返回结果；</p>

user-guide-cn/distributed-transactions/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         

user-guide-cn/faq/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         

user-guide-cn/getting-started/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         

user-guide-cn/implementation-mechanisms/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../../user-guide/design-principle.md.md">Design Principle</a>
+    <a href="../../user-guide/design-principle/">Design Principle</a>
 </li>
 
                         
@@ -276,7 +276,7 @@
 </tr>
 <tr>
 <td align="left">Added</td>
-<td align="left">　创建时间</td>
+<td align="left">创建时间</td>
 <td align="left">DateTime</td>
 </tr>
 <tr>

user-guide/configuration/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../design-principle.md.md">Design Principle</a>
+    <a href="../design-principle/">Design Principle</a>
 </li>
 
                         
@@ -194,7 +194,7 @@
                         </a>
                     </li>
                     <li >
-                        <a rel="prev" href="../implementation-mechanisms/">
+                        <a rel="prev" href="../design-principle/">
                             Next <i class="fas fa-arrow-right"></i>
                         </a>
                     </li>
@@ -211,17 +211,26 @@
         
         <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
     <ul class="nav bs-sidenav">
-        <li class="first-level active"><a href="#cap-options">Cap Options</a></li>
-        <li class="first-level "><a href="#rabbitmq-options">RabbitMQ Options</a></li>
-        <li class="first-level "><a href="#kafka-options">Kafka Options</a></li>
-        <li class="first-level "><a href="#entityframework-options">EntityFramework Options</a></li>
-        <li class="first-level "><a href="#sqlserver-options">SqlServer Options</a></li>
-        <li class="first-level "><a href="#mysql-options">MySql Options</a></li>
-        <li class="first-level "><a href="#postgresql-options">PostgreSql Options</a></li>
+        <li class="first-level active"><a href="#configuration">Configuration</a></li>
+            <li class="second-level"><a href="#cap-options">Cap Options</a></li>
+                
+            <li class="second-level"><a href="#rabbitmq-options">RabbitMQ Options</a></li>
+                
+            <li class="second-level"><a href="#kafka-options">Kafka Options</a></li>
+                
+            <li class="second-level"><a href="#entityframework-options">EntityFramework Options</a></li>
+                
+            <li class="second-level"><a href="#sqlserver-options">SqlServer Options</a></li>
+                
+            <li class="second-level"><a href="#mysql-options">MySql Options</a></li>
+                
+            <li class="second-level"><a href="#postgresql-options">PostgreSql Options</a></li>
+                
     </ul>
 </div></div>
         <div class="col-md-9" role="main">
 
+<h2 id="configuration">Configuration</h2>
 <p>CAP uses Microsoft.Extensions.DependencyInjection for configuration injection. </p>
 <h3 id="cap-options">Cap Options</h3>
 <p>You can use the following methods to configure some configuration items in the CAP, for example:</p>

user-guide/design-principle/index.html

@@ -8,7 +8,7 @@
     <link rel="shortcut icon" href="../../img/favicon.ico">
 
     
-    <title>Design principle - CAP</title>
+    <title>Design Principle - CAP</title>
     
 
     <link rel="stylesheet" href="//use.fontawesome.com/releases/v5.5.0/css/all.css" integrity="sha384-B4dIYHKNBt8Bc12p+WXckhzcICo0wtJAoU8YZTY5qE0Id1GSseTk6S+L3BlXeVIU" crossorigin="anonymous">
@@ -73,7 +73,7 @@
                 
                 
                 
-                    <li class="dropdown">
+                    <li class="dropdown active">
                         <a href="#" class="dropdown-toggle" data-toggle="dropdown"><img src="https://www.countryflags.io/us/flat/16.png">User Guide <b class="caret"></b></a>
                         <ul class="dropdown-menu">
                         
@@ -96,8 +96,8 @@
 
                         
                             
-<li >
-    <a href="../design-principle.md.md">Design Principle</a>
+<li class="active">
+    <a href="./">Design Principle</a>
 </li>
 
                         
@@ -188,6 +188,16 @@
                             <i class="fas fa-search"></i> Search
                         </a>
                     </li>
+                    <li >
+                        <a rel="next" href="../configuration/">
+                            <i class="fas fa-arrow-left"></i> Previous
+                        </a>
+                    </li>
+                    <li >
+                        <a rel="prev" href="../implementation-mechanisms/">
+                            Next <i class="fas fa-arrow-right"></i>
+                        </a>
+                    </li>
                     <li>
                         <a href="https://github.com/dotnetcore/CAP/edit/master/docs/user-guide/design-principle.md"><i class="fab fa-github"></i> Edit on GitHub</a>
                     </li>
@@ -201,14 +211,20 @@
         
         <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
     <ul class="nav bs-sidenav">
-        <li class="first-level active"><a href="#motivation">Motivation</a></li>
-        <li class="first-level "><a href="#persistence">Persistence</a></li>
-        <li class="first-level "><a href="#communication-data-streams">Communication Data Streams</a></li>
-        <li class="first-level "><a href="#consistency">Consistency</a></li>
+        <li class="first-level active"><a href="#design-principle">Design Principle</a></li>
+            <li class="second-level"><a href="#motivation">Motivation</a></li>
+                
+            <li class="second-level"><a href="#persistence">Persistence</a></li>
+                
+            <li class="second-level"><a href="#communication-data-streams">Communication Data Streams</a></li>
+                
+            <li class="second-level"><a href="#consistency">Consistency</a></li>
+                
     </ul>
 </div></div>
         <div class="col-md-9" role="main">
 
+<h2 id="design-principle">Design Principle</h2>
 <h3 id="motivation">Motivation</h3>
 <p>With the popularity of microservices architecture, more and more people are trying to use microservices to architect their systems. In this we encounter problems such as distributed transactions. To solve these problems, I did not find simplicity and Easy to use solution, so I decided to create such a library to solve this problem.</p>
 <p>The original CAP was to solve the transaction problems in the distributed system. She used asynchronous to ensure that this weak consistency transaction mechanism achieved the eventual consistency of the distributed transaction. For more information, see section 6.</p>

user-guide/distributed-transactions/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../design-principle.md.md">Design Principle</a>
+    <a href="../design-principle/">Design Principle</a>
 </li>
 
                         

user-guide/faq/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../design-principle.md.md">Design Principle</a>
+    <a href="../design-principle/">Design Principle</a>
 </li>
 
                         

user-guide/getting-started/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../design-principle.md.md">Design Principle</a>
+    <a href="../design-principle/">Design Principle</a>
 </li>
 
                         
@@ -212,51 +212,63 @@
         <div class="col-md-3"><div class="bs-sidebar hidden-print affix well" role="complementary">
     <ul class="nav bs-sidenav">
         <li class="first-level active"><a href="#introduction">Introduction</a></li>
-        <li class="first-level "><a href="#usage-scenarios">Usage Scenarios</a></li>
-        <li class="first-level "><a href="#quick-start">Quick Start</a></li>
+            <li class="second-level"><a href="#usage-scenarios">Usage Scenarios</a></li>
+                
+            <li class="second-level"><a href="#quick-start">Quick Start</a></li>
+                
+                <li class="third-level"><a href="#nuget-package">NuGet Package</a></li>
+                <li class="third-level"><a href="#startup-configuration">Startup Configuration</a></li>
+                <li class="third-level"><a href="#usage">Usage</a></li>
     </ul>
 </div></div>
         <div class="col-md-9" role="main">
 
-<h3 id="introduction">Introduction</h3>
+<h1 id="introduction">Introduction</h1>
 <p>CAP is a library based on .Net standard, which is a solution to deal with distributed transactions, also has the function of EventBus, it is lightweight, easy to use, and efficiently.</p>
-<h3 id="usage-scenarios">Usage Scenarios</h3>
+<h2 id="usage-scenarios">Usage Scenarios</h2>
 <p>The usage scenarios of CAP mainly include the following two:</p>
-<ul>
-<li>1.The scheme of eventual consistency in distributed transactions</li>
-</ul>
-<p>In the process of building an SOA or MicroService system, we usually need to use the event to integrate each services. In the process, the simple use of message queue does not guarantee the reliability. CAP is adopted the local message table program integrated with the current database to solve the exception may occur in the process of the distributed system calling each other. It can ensure that the event messages are not lost in any case.</p>
-<p>Distributed transactions are an inevitable requirement in a distributed system, and the current solution for distributed transactions is nothing more than just a few. Before understanding the CAP's distributed transaction scenarios, you can read the following [Articles] (http://www.infoq.com/en/articles/solution-of-distributed-system-transaction-consistency).</p>
-<p>The CAP does not use the two-phase commit (2PC) transaction mechanism, but uses the classical message implementation of the local message table + MQ, which is also called asynchronous guarantee.</p>
-<ul>
-<li>2.Highly usable EventBus</li>
-</ul>
-<p>You can also use the CAP as an EventBus. The CAP provides a simpler way to implement event publishing and subscriptions. You do not need to inherit or implement any interface during the process of subscription and sending.</p>
-<p>CAP implements the publish and subscribe method of EventBus, which has all the features of EventBus. This means that you can use CAPs just like EventBus. In addition, CAP's EventBus is highly available. What does this mean?</p>
-<p>The CAP uses the local message table to persist the messages in the EventBus. This ensures that the messages sent by the EventBus are reliable. When the message queue fails or fails, the messages are not lost.</p>
-<h3 id="quick-start">Quick Start</h3>
-<ul>
-<li><strong>Reference NuGet Package</strong></li>
-</ul>
+<div class="bs-callout bs-callout-primary">
+  <h4>1. The scheme of eventual consistency in distributed transactions</h4><br>
+In the process of building an SOA or MicroService system, we usually need to use the event to integrate each services. In the process, the simple use of message queue does not guarantee the reliability. CAP is adopted the local message table program integrated with the current database to solve the exception may occur in the process of the distributed system calling each other. It can ensure that the event messages are not lost in any case.
+<br><br>
+Distributed transactions are an inevitable requirement in a distributed system, and the current solution for distributed transactions is nothing more than just a few. Before understanding the CAP's distributed transaction scenarios, you can read the following [Articles] (http://www.infoq.com/en/articles/solution-of-distributed-system-transaction-consistency).
+<br><br>
+The CAP does not use the two-phase commit (2PC) transaction mechanism, but uses the classical message implementation of the local message table + MQ, which is also called asynchronous guarantee.
+</div>
+
+<div class="bs-callout bs-callout-primary">
+  <h4>2. Highly usable EventBus</h4><br>
+
+You can also use the CAP as an EventBus. The CAP provides a simpler way to implement event publishing and subscriptions. You do not need to inherit or implement any interface during the process of subscription and sending.
+<br><br>
+CAP implements the publish and subscribe method of EventBus, which has all the features of EventBus. This means that you can use CAPs just like EventBus. In addition, CAP's EventBus is highly available. What does this mean?
+<br><br>
+The CAP uses the local message table to persist the messages in the EventBus. This ensures that the messages sent by the EventBus are reliable. When the message queue fails or fails, the messages are not lost.
+</div>
+
+<h2 id="quick-start">Quick Start</h2>
+<h3 id="nuget-package">NuGet Package</h3>
 <p>Use the following command to reference the CAP NuGet package:</p>
 <pre><code>PM&gt; Install-Package DotNetCore.CAP
 </code></pre>
 
 <p>According to the different types of message queues used, different extension packages are introduced:</p>
 <pre><code>PM&gt; Install-Package DotNetCore.CAP.RabbitMQ
+
 PM&gt; Install-Package DotNetCore.CAP.Kafka
 </code></pre>
 
 <p>According to the different types of databases used, different extension packages are introduced:</p>
 <pre><code>PM&gt; Install-Package DotNetCore.CAP.SqlServer
+
 PM&gt; Install-Package DotNetCore.CAP.MySql
+
 PM&gt; Install-Package DotNetCore.CAP.PostgreSql
+
 PM&gt; Install-Package DotNetCore.CAP.MongoDB
 </code></pre>
 
-<ul>
-<li><strong>Startup Configuration</strong></li>
-</ul>
+<h3 id="startup-configuration">Startup Configuration</h3>
 <p>In an ASP.NET Core program, you can configure the services used by the CAP in the <code>Startup.cs</code> file <code>ConfigureServices()</code>:</p>
 <pre><code class="cs">public void ConfigureServices(IServiceCollection services)
 {
@@ -268,7 +280,8 @@ PM&gt; Install-Package DotNetCore.CAP.MongoDB
     services.AddCap(x =&gt;
     {
         // If you are using EF, you need to add the configuration：
-        x.UseEntityFramework&lt;AppDbContext&gt;(); //Options, Notice: You don't need to config x.UseSqlServer(&quot;&quot;&quot;) again! CAP can autodiscovery.
+        //Options, Notice: You don't need to config x.UseSqlServer(&quot;&quot;&quot;) again! CAP can autodiscovery.
+        x.UseEntityFramework&lt;AppDbContext&gt;(); 
 
         // If you are using Ado.Net, you need to add the configuration：
         x.UseSqlServer(&quot;Your ConnectionStrings&quot;);
@@ -285,6 +298,98 @@ PM&gt; Install-Package DotNetCore.CAP.MongoDB
         x.UseKafka(&quot;localhost&quot;);
     });
 }
+</code></pre>
+
+<h3 id="usage">Usage</h3>
+<h4 id="publish">Publish</h4>
+<p>Inject <code>ICapPublisher</code> in your Controller, then use the <code>ICapPublisher</code> to send message</p>
+<pre><code class="c#">public class PublishController : Controller
+{
+    private readonly ICapPublisher _capBus;
+
+    public PublishController(ICapPublisher capPublisher)
+    {
+        _capBus = capPublisher;
+    }
+
+    [Route(&quot;~/adonet/transaction&quot;)]
+    public IActionResult AdonetWithTransaction()
+    {
+        using (var connection = new MySqlConnection(ConnectionString))
+        {
+            using (var transaction = connection.BeginTransaction(_capBus, autoCommit: true))
+            {
+                //your business logic code
+
+                _capBus.Publish(&quot;xxx.services.show.time&quot;, DateTime.Now);
+            }
+        }
+
+        return Ok();
+    }
+
+    [Route(&quot;~/ef/transaction&quot;)]
+    public IActionResult EntityFrameworkWithTransaction([FromServices]AppDbContext dbContext)
+    {
+        using (var trans = dbContext.Database.BeginTransaction(_capBus, autoCommit: true))
+        {
+            //your business logic code
+
+            _capBus.Publish(&quot;xxx.services.show.time&quot;, DateTime.Now);
+        }
+
+        return Ok();
+    }
+}
+
+</code></pre>
+
+<h4 id="subscribe">Subscribe</h4>
+<p><strong>In Controller Action</strong></p>
+<p>Add the Attribute <code>[CapSubscribe()]</code> on Action to subscribe message:</p>
+<pre><code class="c#">public class PublishController : Controller
+{
+    [CapSubscribe(&quot;xxx.services.show.time&quot;)]
+    public void CheckReceivedMessage(DateTime datetime)
+    {
+        Console.WriteLine(datetime);
+    }
+}
+
+</code></pre>
+
+<p><strong>In Business Logic Service</strong></p>
+<p>If your subscribe method is not in the Controller, the service class you need to Inheritance <code>ICapSubscribe</code>:</p>
+<pre><code class="c#">
+namespace BusinessCode.Service
+{
+    public interface ISubscriberService
+    {
+        public void CheckReceivedMessage(DateTime datetime);
+    }
+
+    public class SubscriberService: ISubscriberService, ICapSubscribe
+    {
+        [CapSubscribe(&quot;xxx.services.show.time&quot;)]
+        public void CheckReceivedMessage(DateTime datetime)
+        {
+        }
+    }
+}
+
+</code></pre>
+
+<p>Then inject your  <code>ISubscriberService</code>  class in <code>Startup.cs</code></p>
+<pre><code class="c#">public void ConfigureServices(IServiceCollection services)
+{
+    //Note: The injection of services needs before of `services.AddCap()`
+    services.AddTransient&lt;ISubscriberService,SubscriberService&gt;();
+
+    services.AddCap(x=&gt;
+    {
+        //...
+    });
+}
 </code></pre></div>
         
         

user-guide/implementation-mechanisms/index.html

@@ -97,7 +97,7 @@
                         
                             
 <li >
-    <a href="../design-principle.md.md">Design Principle</a>
+    <a href="../design-principle/">Design Principle</a>
 </li>
 
                         
@@ -189,7 +189,7 @@
                         </a>
                     </li>
                     <li >
-                        <a rel="next" href="../configuration/">
+                        <a rel="next" href="../design-principle/">
                             <i class="fas fa-arrow-left"></i> Previous
                         </a>
                     </li>