Added base address to documentation/README.md (#238)

Author: ivaylokenov

documentation/README.md

@@ -7,6 +7,7 @@
 
  - Global configuration
   - [Using custom HttpConfiguration](#using-custom-httpconfiguration)
+  - [Base address](#base-address)
  - Route validations
   - [Building route request](#building-route-request)
   - [Testing routes](#testing-routes)
@@ -78,6 +79,20 @@ MyWebApi
 
 [To top](#table-of-contents)
 
+### Base address
+
+By default all unit tests are run with request host **"http://localhost"** and **Url.Link** will use it as base address. Another host can be configured easily after setting the HTTP configuration:
+
+```c#
+// sets all test requests to come from custom base address
+// ** this will also set the global remote server
+MyWebApi
+	.IsRegisteredWith(WebApiConfig.Register)
+	.WithBaseAddress("http://mytestedasp.net");
+```
+
+[To top](#table-of-contents)
+  
 ### Building route request
 
 You can test routes using the internal ASP.NET Web API
@@ -2630,6 +2645,8 @@ MyWebApi
 	.ContainingContentHeader(HttpContentHeader.ContentType);
 
 // configure global base address
+// ** this step is not necessary, if you already provided 
+// ** a base address through the configuration
 MyWebApi.Server().IsLocatedAt("http://mytestedasp.net");
 
 MyWebApi

src/MyTested.WebApi.Tests/BuildersTests/HttpConfigurationBuilderTests.cs

@@ -42,20 +42,20 @@ public void DefaultErrorDetailPolicyShouldBeAlways()
         public void WithBaseAddressShouldChangedDefaultAddress()
         {
             Assert.IsFalse(RemoteServer.GlobalIsConfigured);
-            Assert.AreEqual(MyWebApi.DefaultHost, MyWebApi.BaseAddress);
+            Assert.AreEqual(MyWebApi.DefaultHost, MyWebApi.BaseAddress.OriginalString);
 
             string address = "http://mytestedasp.net";
 
             MyWebApi
                 .IsUsingDefaultHttpConfiguration()
                 .WithBaseAddress(address);
 
-            Assert.AreEqual(address, MyWebApi.BaseAddress);
+            Assert.AreEqual(address, MyWebApi.BaseAddress.OriginalString);
             Assert.IsTrue(RemoteServer.GlobalIsConfigured);
 
             MyWebApi.IsUsing(TestObjectFactory.GetHttpConfigurationWithRoutes());
 
-            Assert.AreEqual(MyWebApi.DefaultHost, MyWebApi.BaseAddress);
+            Assert.AreEqual(MyWebApi.DefaultHost, MyWebApi.BaseAddress.OriginalString);
 
             RemoteServer.DisposeGlobal();
         }

src/MyTested.WebApi/Builders/HttpConfigurationBuilder.cs

@@ -4,6 +4,7 @@
 // Dual-licensed under the Apache License, Version 2.0, and the Microsoft Public License (Ms-PL).
 namespace MyTested.WebApi.Builders
 {
+    using System;
     using System.Web.Http;
     using Common.Servers;
     using Contracts;
@@ -53,7 +54,7 @@ public IHttpConfigurationBuilder WithErrorDetailPolicy(IncludeErrorDetailPolicy
         /// <returns>The same HTTP configuration builder.</returns>
         public IHttpConfigurationBuilder WithBaseAddress(string baseAddress)
         {
-            MyWebApi.BaseAddress = baseAddress;
+            MyWebApi.BaseAddress = new Uri(baseAddress, UriKind.Absolute);
 
             if (!RemoteServer.GlobalIsConfigured)
             {

src/MyTested.WebApi/Common/Extensions/HttpRequestMessageExtensions.cs

@@ -20,7 +20,7 @@ public static void TransformToAbsoluteRequestUri(this HttpRequestMessage request
         {
             if (request.RequestUri != null && !request.RequestUri.IsAbsoluteUri)
             {
-                request.RequestUri = new Uri(new Uri(MyWebApi.BaseAddress), request.RequestUri);
+                request.RequestUri = new Uri(MyWebApi.BaseAddress, request.RequestUri);
             }
         }
     }

src/MyTested.WebApi/MyWebApi.cs

@@ -34,7 +34,6 @@ public static class MyWebApi
 
         static MyWebApi()
         {
-            BaseAddress = DefaultHost;
             IsUsingDefaultHttpConfiguration();
         }
 
@@ -48,7 +47,7 @@ static MyWebApi()
         /// Gets the current base address used in the testing.
         /// </summary>
         /// <value>Instance of String.</value>
-        public static string BaseAddress { get; internal set; }
+        public static Uri BaseAddress { get; internal set; }
 
         /// <summary>
         /// Sets the default HttpConfiguration which will be used in all tests.
@@ -76,7 +75,7 @@ public static IHttpConfigurationBuilder IsUsingDefaultHttpConfiguration()
         public static IHttpConfigurationBuilder IsUsing(HttpConfiguration httpConfiguration)
         {
             Configuration = httpConfiguration;
-            BaseAddress = DefaultHost;
+            BaseAddress = new Uri(DefaultHost, UriKind.Absolute);
             return new HttpConfigurationBuilder(httpConfiguration);
         }