rename next policy method and update readme

Author: Ihar Yakimush

Commmunity.AspNetCore.ExceptionHandling.Integration/Startup.cs

@@ -31,7 +31,7 @@ public void ConfigureServices(IServiceCollection services)
 
             services.AddExceptionHandlingPolicies(options =>
             {
-                options.For<DuplicateNameException>().Retry().NextChain();
+                options.For<DuplicateNameException>().Retry().NextPolicy();
 
                 options.For<DuplicateWaitObjectException>().Retry();
 
@@ -41,7 +41,7 @@ public void ConfigureServices(IServiceCollection services)
                     .Response(e => 400)
                     .Headers((h, e) => h["X-qwe"] = e.Message)
                     .WithBody((req,sw, exception) => sw.WriteAsync(exception.ToString()))
-                    .NextChain();
+                    .NextPolicy();
 
                 options.For<Exception>()
                     .Log(lo => { lo.Formatter = (o, e) => "qwe"; })

Commmunity.AspNetCore.ExceptionHandling/PolicyBuilderExtensions.cs

@@ -90,7 +90,7 @@ public static IExceptionPolicyBuilder Rethrow<TException>(
         /// <returns>
         /// Policy builder
         /// </returns>
-        public static IExceptionPolicyBuilder NextChain<TException>(
+        public static IExceptionPolicyBuilder NextPolicy<TException>(
             this IExceptionMapping<TException> builder, int index = -1)
             where TException : Exception
         {

Commmunity.AspNetCore.sln

@@ -11,11 +11,13 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution
 	ProjectSection(SolutionItems) = preProject
 		build.ps1 = build.ps1
 		README.md = README.md
+		Transitions.png = Transitions.png
+		Transitions.vsdx = Transitions.vsdx
 	EndProjectSection
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Commmunity.AspNetCore.ExceptionHandling.Mvc", "Commmunity.AspNetCore.ExceptionHandling.Mvc\Commmunity.AspNetCore.ExceptionHandling.Mvc.csproj", "{0D080E5A-9500-43AC-88CD-069947CFA5EF}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Commmunity.AspNetCore.ExceptionHandling.Mvc", "Commmunity.AspNetCore.ExceptionHandling.Mvc\Commmunity.AspNetCore.ExceptionHandling.Mvc.csproj", "{0D080E5A-9500-43AC-88CD-069947CFA5EF}"
 EndProject
-Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson", "Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson\Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson.csproj", "{B3BAD0B5-15BC-46EE-A224-9DAF10376B81}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson", "Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson\Commmunity.AspNetCore.ExceptionHandling.NewtonsoftJson.csproj", "{B3BAD0B5-15BC-46EE-A224-9DAF10376B81}"
 EndProject
 Global
 	GlobalSection(SolutionConfigurationPlatforms) = preSolution

README.md

@@ -1,7 +1,7 @@
 # AspNetCore-ExceptionHandling
 Middleware to configure exception handling policies. Configure chain of handlers per exception type. OOTB handlers: log, retry, set responce headers and body
 
-### Sample
+### Code Sample
 ```
 public void ConfigureServices(IServiceCollection services)
 {
@@ -39,3 +39,18 @@ public void Configure(IApplicationBuilder app, IHostingEnvironment env)
     app.UseMvc();
 }
 ```
+### Policy handlers transitions
+When exception catched in middleware it try to apply handlers from first registered policy siutable for given exception. Policy contains a chain of handlers. Each handler perform some action and apply transition. To prevent re throw of exception handlers chain MUST ends with "Handled" transition.
+Following handlers currently supported:
+
+| Handler  | Action | Transition |
+| ---------| ------------- | ------------- |
+| Rethrow  | Apply ReThrow transition  | ReThrow |
+| NextPolicy  | Try to execute next policy siutable for given exception  | NextPolicy |
+| Handled  | Mark exception as handled to prevent it from bein re thrown  | Handled |
+| Retry  | Execute aspnetcore pipeline again if retry count not exceed limit  | Retry (if retry limit not exceeded) or NextHandler |
+| Log  | Log exception  | NextHandler |
+| DisableFurtherLog  | Prevent exception from being logged again in current middleware (for current request only)  | NextHandler |
+| Response  | Modify response (set status code, headers and body) depending on further response builder configuration | NextHandler |
+
+![alt text](/Transitions.png)