README updated, httplive sync

Author: gencebay

README.md

@@ -11,9 +11,9 @@ Flying Proxy aims to:
 - Better performance
 - Maintainability
 
-### Sample Client (Web)
+## Sample Client (Web)
 
-#### Add ProxySettings section to the appsettings.json
+### Add ProxySettings section to the appsettings.json
 ```json
 "ProxySettings": {
     "RegionKeys": {
@@ -24,7 +24,7 @@ Flying Proxy aims to:
 }
 ```
 
-#### APIs Definitions
+### APIs Definitions
 ```csharp
 // This API expose methods from localhost:5000 and localhost:5001 as configured on ProxySettings
 [ApiRoute("api/[controller]", regionKey: "Main")]
@@ -49,6 +49,12 @@ public interface IGuidelineApi : IApiContract
     [HttpPostMarker]
     Task TaskActionPost(ComplexTypeModel model);
 
+    [HttpPostMarker(ContentType = ContentType.MultipartFormData)]
+    Task TaskActionBarMultipartFormData(Bar model);
+
+    [HttpPostMarker(ContentType = ContentType.Xml)]
+    Task TaskActionBarSimpleXml(BarSimple model);
+
     /// <summary>
     /// Template and parameter usage, key parameter will be part of the request Url 
     /// and extracting it as api/guideline/kv/<key>
@@ -61,7 +67,7 @@ public interface IGuidelineApi : IApiContract
 }
 ```
 
-#### Startup ConfigureServices
+### Startup ConfigureServices
 ```csharp
 public void ConfigureServices(IServiceCollection services)
 {
@@ -76,9 +82,9 @@ public void ConfigureServices(IServiceCollection services)
 }
 ```
 
-#### Proxy Usage (DI)
+### Proxy Usage (DI)
 ```csharp
-public class TestController : Controller
+public class HomeController : Controller
 {
     private readonly IGuidelineApi _api;
 
@@ -87,96 +93,42 @@ public class TestController : Controller
         _api = api;
     }
 
-    public async Task<IActionResult> GetPostsAsync()
+    public async Task<IEnumerable<SampleModel>> GetModels()
     {
-        var items = await _api.GetPostsAsync();
-        return Json(items);
+        var items = await _api.GetEnumerableModels();
+        return items;
     }
 }
 ```
 
-### Backend - Server Side
-#### API Contract Implementation
+## Sample Server
+### API Implementation
 ```csharp
 [Route("api/[controller]")]
 public class GuidelineController : Controller, IGuidelineApi
 {
-    private readonly ILoggerFactory _loggerFactory;
-
-    protected ILogger Logger { get; }
-
-    public GuidelineController(ILoggerFactory loggerFactory)
-    {
-        _loggerFactory = loggerFactory;
-        Logger = _loggerFactory.CreateLogger<GuidelineController>();
-    }
-
-    [HttpGet(nameof(GetPostsAsync))]
-    public async Task<IEnumerable<Post>> GetPostsAsync()
+    [HttpGet(nameof(GetEnumerableModels))]
+    public Task<IEnumerable<SampleModel>> GetEnumerableModels()
     {
-        var httpRequest = new HttpRequestMessage(HttpMethod.Get, new Uri("https://jsonplaceholder.typicode.com/posts"));
-        var response = await Factory.Client.SendAsync(httpRequest);
-        var content = await response.Content.ReadAsStringAsync();
-        var items = JsonConvert.DeserializeObject<List<Post>>(content);
-        Logger.LogDebug($"{nameof(GetPostsAsync)}, PostsCount:{items.Count}");
+        ...
         return items;
     }
 
-    [HttpGet(nameof(GetWithReferenceType))]
-    public async Task GetWithReferenceType([FromQuery]SimpleModel model)
-    {
-        var serializedModel = JsonConvert.SerializeObject(model);
-        Logger.LogDebug($"{nameof(GetWithReferenceType)}, Model: {serializedModel}");
-        await Task.Delay(900);
-    }
-
-    [HttpGet(nameof(PrimitiveReturn))]
-    public int PrimitiveReturn(int i, string s, long l, DateTime dt)
-    {
-        Logger.LogDebug($"{nameof(PrimitiveReturn)}, i:{i}, s:{s}, l:{l}, dt:{dt}");
-        return i + 10;
-    }
-
-    [HttpPost(nameof(TaskActionPost))]
-    public async Task TaskActionPost([FromBody]SimpleModel model)
-    {
-        var serializedModel = JsonConvert.SerializeObject(model);
-        Logger.LogDebug($"{nameof(TaskActionPost)}, Model: {serializedModel}");
-        await Task.Delay(900);
-    }
-
-    [HttpGet(nameof(TaskOperation))]
-    public async Task TaskOperation()
+    [HttpPost(nameof(TaskComplexTypeModel))]
+    public async Task TaskComplexTypeModel([FromBody]ComplexTypeModel model)
     {
-        await Task.Delay(2000);
-        Logger.LogDebug($"{nameof(TaskOperation)}, long running process completed!");
+        ...
     }
 
-    [HttpGet(nameof(VoidOperation))]
-    public void VoidOperation()
+    [HttpPost(nameof(TaskActionBarMultipartFormData))]
+    public Task TaskActionBarMultipartFormData(Bar model)
     {
-        var str = "Hello World!";
-        Logger.LogDebug($"{nameof(VoidOperation)}, {str}");
+        ...
     }
 }
 ```
 
-#### Multipart form data:
-Proxy sends all POST methods as JSON but if the method parameter model contains IFormFile type property it converts the content-type to multipart/form-data. In this case, use any model to POST multipart/form-data to API without [FromBody] attribute on action parameter. For example:
-
-```csharp
-// Interface
-[HttpPostMarker]
-Task<AlbumViewModel> SaveAlbumSubmitAsync(AlbumViewModelSubmit model)    
-```
-
-```csharp
-// API Controller
-[HttpPost(nameof(SaveAlbumSubmitAsync))]
-public async Task<AlbumViewModel> SaveAlbumSubmitAsync(AlbumViewModelSubmit model)  
-```
-
-#### Unit Testing
+### Unit Testing
 Use [HttpLive](https://github.com/gencebay/httplive)
 
 	httplive -p 5003,5004 -d test/NetCoreStack.Proxy.Tests/httplive.db

test/NetCoreStack.Proxy.Mvc.Hosting/Controllers/GuidelineController.cs

@@ -70,8 +70,8 @@ public Task<CollectionResult<SampleModel>> GetCollectionStreamTask()
             return null;
         }
 
-        [HttpPost(nameof(TaskActionPost))]
-        public async Task TaskActionPost([FromBody]ComplexTypeModel model)
+        [HttpPost(nameof(TaskComplexTypeModel))]
+        public async Task TaskComplexTypeModel([FromBody]ComplexTypeModel model)
         {
             await Task.CompletedTask;
             _logger.LogWarning(JsonConvert.SerializeObject(model));

test/NetCoreStack.Proxy.Test.Contracts/IGuidelineApi.cs

@@ -27,7 +27,7 @@ public interface IGuidelineApi : IApiContract
         /// <param name="model"></param>
         /// <returns></returns>
         [HttpPostMarker]
-        Task TaskActionPost(ComplexTypeModel model);
+        Task TaskComplexTypeModel(ComplexTypeModel model);
 
         [HttpPostMarker(ContentType = ContentType.MultipartFormData)]
         Task TaskActionBarMultipartFormData(Bar model);

test/NetCoreStack.Proxy.Tests/ProxyCreationTests.cs

@@ -98,7 +98,7 @@ public async Task GetWithComplexReferenceTypeTest()
         public async Task TaskCallHttpPostWithReferenceTypeParameterTest()
         {
             var guidelineApi = Resolver.GetService<IGuidelineApi>();
-            await guidelineApi.TaskActionPost(TypesModelHelper.GetComplexTypeModel());
+            await guidelineApi.TaskComplexTypeModel(TypesModelHelper.GetComplexTypeModel());
         }
 
         [Fact]