Deployed bb2bdb9e with MkDocs version: 1.0.4

66f229cc · Savorboard · 6b7b146e · 66f229cc · 66f229cc · 66f229cc
Commit 66f229cc authored Feb 21, 2019 by Savorboard
23 changed files
--- a/404.html
+++ b/404.html
@@ -583,6 +583,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/about/contact-us/index.html
+++ b/about/contact-us/index.html
@@ -638,6 +638,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>
@@ -744,6 +756,20 @@
          </a>
        
        
+          <a href="../license/" title="License" class="md-flex md-footer-nav__link md-footer-nav__link--next" rel="next">
+            <div class="md-flex__cell md-flex__cell--stretch md-footer-nav__title">
+              <span class="md-flex__ellipsis">
+                <span class="md-footer-nav__direction">
+                  Next
+                </span>
+                License
+              </span>
+            </div>
+            <div class="md-flex__cell md-flex__cell--shrink">
+              <i class="md-icon md-icon--arrow-forward md-footer-nav__button"></i>
+            </div>
+          </a>
+        
      </nav>
    </div>
  

--- a/about/contributing/index.html
+++ b/about/contributing/index.html
@@ -602,6 +602,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/about/license/index.html
+++ b/about/license/index.html
--- a/about/release-notes/index.html
+++ b/about/release-notes/index.html
--- a/index.html
+++ b/index.html
@@ -641,6 +641,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/search/search_index.json
+++ b/search/search_index.json
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,92 +2,97 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
    <url>
     <loc>https://cap.dotnet-china.com/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/getting-started/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/api-interface/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/configuration/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/design/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/implementation/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/transaction/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide/faq/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/getting-started/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/api-interface/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/configuration/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/design-principle/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/implementation-mechanisms/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/distributed-transactions/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/user-guide-cn/faq/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/about/release-notes/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/about/contributing/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
    <url>
     <loc>https://cap.dotnet-china.com/about/contact-us/</loc>
-     <lastmod>2019-02-12</lastmod>
+     <lastmod>2019-02-21</lastmod>
+     <changefreq>daily</changefreq>
+    </url>
+    <url>
+     <loc>https://cap.dotnet-china.com/about/license/</loc>
+     <lastmod>2019-02-21</lastmod>
     <changefreq>daily</changefreq>
    </url>
 </urlset>
\ No newline at end of file
--- a/sitemap.xml.gz
+++ b/sitemap.xml.gz
--- a/user-guide-cn/api-interface/index.html
+++ b/user-guide-cn/api-interface/index.html
@@ -667,6 +667,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/configuration/index.html
+++ b/user-guide-cn/configuration/index.html
@@ -682,6 +682,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/design-principle/index.html
+++ b/user-guide-cn/design-principle/index.html
@@ -661,6 +661,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/distributed-transactions/index.html
+++ b/user-guide-cn/distributed-transactions/index.html
@@ -627,6 +627,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/faq/index.html
+++ b/user-guide-cn/faq/index.html
@@ -596,6 +596,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/getting-started/index.html
+++ b/user-guide-cn/getting-started/index.html
@@ -641,6 +641,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide-cn/implementation-mechanisms/index.html
+++ b/user-guide-cn/implementation-mechanisms/index.html
@@ -655,6 +655,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/api-interface/index.html
+++ b/user-guide/api-interface/index.html
@@ -704,6 +704,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/configuration/index.html
+++ b/user-guide/configuration/index.html
@@ -679,6 +679,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/design/index.html
+++ b/user-guide/design/index.html
@@ -652,6 +652,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/faq/index.html
+++ b/user-guide/faq/index.html
@@ -602,6 +602,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/getting-started/index.html
+++ b/user-guide/getting-started/index.html
@@ -374,10 +374,30 @@
    <ul class="md-nav__list" data-md-scrollfix>
      
        <li class="md-nav__item">
-  <a href="#usage-scenarios" title="Usage Scenarios" class="md-nav__link">
-    Usage Scenarios
+  <a href="#usage" title="Usage" class="md-nav__link">
+    Usage
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#1-distributed-transaction-alternative-solution-in-micro-service-base-on-eventually-consistency" title="1. Distributed transaction alternative solution in micro-service base on eventually consistency" class="md-nav__link">
+    1. Distributed transaction alternative solution in micro-service base on eventually consistency
  </a>
  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#2-eventbus-with-outbox-pattern" title="2. EventBus with Outbox pattern" class="md-nav__link">
+    2. EventBus with Outbox pattern
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
      
        <li class="md-nav__item">
@@ -403,7 +423,7 @@
 </li>
        
          <li class="md-nav__item">
-  <a href="#usage" title="Usage" class="md-nav__link">
+  <a href="#usage_1" title="Usage" class="md-nav__link">
    Usage
  </a>
  
@@ -685,6 +705,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>
@@ -711,10 +743,30 @@
    <ul class="md-nav__list" data-md-scrollfix>
      
        <li class="md-nav__item">
-  <a href="#usage-scenarios" title="Usage Scenarios" class="md-nav__link">
-    Usage Scenarios
+  <a href="#usage" title="Usage" class="md-nav__link">
+    Usage
+  </a>
+  
+    <nav class="md-nav">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#1-distributed-transaction-alternative-solution-in-micro-service-base-on-eventually-consistency" title="1. Distributed transaction alternative solution in micro-service base on eventually consistency" class="md-nav__link">
+    1. Distributed transaction alternative solution in micro-service base on eventually consistency
  </a>
  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#2-eventbus-with-outbox-pattern" title="2. EventBus with Outbox pattern" class="md-nav__link">
+    2. EventBus with Outbox pattern
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
      
        <li class="md-nav__item">
@@ -740,7 +792,7 @@
 </li>
        
          <li class="md-nav__item">
-  <a href="#usage" title="Usage" class="md-nav__link">
+  <a href="#usage_1" title="Usage" class="md-nav__link">
    Usage
  </a>
  
@@ -791,27 +843,24 @@
                
                
                <h1 id="getting-stared">Getting Stared<a class="headerlink" href="#getting-stared" title="Permanent link">&para;</a></h1>
-<h2 id="usage-scenarios">Usage Scenarios<a class="headerlink" href="#usage-scenarios" title="Permanent link">&para;</a></h2>
-<p>The usage scenarios of CAP mainly include the following two:</p>
-<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.
+<h2 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h2>
+<h4 id="1-distributed-transaction-alternative-solution-in-micro-service-base-on-eventually-consistency">1. Distributed transaction alternative solution in micro-service base on eventually consistency<a class="headerlink" href="#1-distributed-transaction-alternative-solution-in-micro-service-base-on-eventually-consistency" title="Permanent link">&para;</a></h4>
+<p>A distributed transaction is a very complex process with a lot of moving parts that can fail. Also, if these parts run on different machines or even in different data centers, the process of committing a transaction could become very long and unreliable.</p>
+<p>This could seriously affect the user experience and overall system bandwidth. So one of the best ways to solve the problem of distributed transactions is to avoid them completely.</p>
+<p>Usually, a microservice is designed in such way as to be independent and useful on its own. It should be able to solve some atomic business task.</p>
+<p>If we could split our system in such microservices, there’s a good chance we wouldn’t need to implement transactions between them at all. </p>
+<p>By far, one of the most feasible models of handling consistency across microservices is eventual consistency. This model doesn’t enforce distributed ACID transactions across microservices. Instead, it proposes to use some mechanisms of ensuring that the system would be eventually consistent at some point in the future.</p>
+<p>CAP ia an alternative solution without transactions, it comply the eventually consistency and implement base on message queue. </p>
+<h4 id="2-eventbus-with-outbox-pattern">2. EventBus with Outbox pattern<a class="headerlink" href="#2-eventbus-with-outbox-pattern" title="Permanent link">&para;</a></h4>
+<p>CAP is an event bus that implements the Outbox pattern, Outbox is an infrastructure feature which simulates the reliability of distributed transactions without requiring use of the Distributed Transaction Coordinator(DTC).</p>
+<p>The outbox feature can be used instead of the DTC to mimic the same level of consistency without using distributed transactions.</p>
+<div class="admonition tip">
+<p class="admonition-title">CAP implements the Outbox Pattern described in the <a href="https://docs.microsoft.com/en-us/dotnet/standard/microservices-architecture/multi-container-microservice-net-applications/subscribe-events#designing-atomicity-and-resiliency-when-publishing-to-the-event-bus">eShop ebook</a></p>
+<p><img src="https://docs.microsoft.com/en-us/dotnet/standard/microservices-architecture/multi-container-microservice-net-applications/media/image24.png"></p>
+<blockquote>
+<p>Atomicity when publishing events to the event bus with a worker microservice</p>
+</blockquote>
 </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<a class="headerlink" href="#quick-start" title="Permanent link">&para;</a></h2>
 <h3 id="nuget-package">NuGet Package<a class="headerlink" href="#nuget-package" title="Permanent link">&para;</a></h3>
 <p>Use the following command to reference the CAP NuGet package:</p>
@@ -823,8 +872,8 @@ The CAP uses the local message table to persist the messages in the EventBus. Th
 <table class="codehilitetable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span>1
 2
 3</pre></div></td><td class="code"><div class="codehilite"><pre><span></span>PM&gt; Install-Package DotNetCore.CAP.RabbitMQ
-
 PM&gt; Install-Package DotNetCore.CAP.Kafka
+PM&gt; Install-Package DotNetCore.CAP.AzureServiceBus
 </pre></div>
 </td></tr></table>

@@ -832,15 +881,9 @@ PM&gt; Install-Package DotNetCore.CAP.Kafka
 <table class="codehilitetable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span>1
 2
 3
-4
-5
-6
-7</pre></div></td><td class="code"><div class="codehilite"><pre><span></span>PM&gt; Install-Package DotNetCore.CAP.SqlServer
-
+4</pre></div></td><td class="code"><div class="codehilite"><pre><span></span>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
 </pre></div>
 </td></tr></table>
@@ -905,7 +948,7 @@ PM&gt; Install-Package DotNetCore.CAP.MongoDB
 </pre></div>
 </td></tr></table>

-<h3 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">&para;</a></h3>
+<h3 id="usage_1">Usage<a class="headerlink" href="#usage_1" title="Permanent link">&para;</a></h3>
 <h4 id="publish">Publish<a class="headerlink" href="#publish" title="Permanent link">&para;</a></h4>
 <p>Inject <code class="codehilite">ICapPublisher</code> in your Controller, then use the <code class="codehilite">ICapPublisher</code> to send message</p>
 <table class="codehilitetable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span> 1

--- a/user-guide/implementation/index.html
+++ b/user-guide/implementation/index.html
@@ -659,6 +659,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>

--- a/user-guide/transaction/index.html
+++ b/user-guide/transaction/index.html
@@ -631,6 +631,18 @@
  </li>

        
+          
+          
+          
+
+
+  <li class="md-nav__item">
+    <a href="../../about/license/" title="License" class="md-nav__link">
+      License
+    </a>
+  </li>
+
+        
      </ul>
    </nav>
  </li>