Clean up examples and add .http files to non-OpenAPI examples. Resolves #1146. Supplants #1147

Author: commonsensesoftware

asp.slnx

@@ -49,6 +49,7 @@
   <Folder Name="/examples/">
     <File Path="examples/.editorconfig" />
     <File Path="examples/Directory.Build.props" />
+    <File Path="examples/Directory.Packages.props" />
   </Folder>
   <Folder Name="/examples/AspNet/">
     <File Path="examples/AspNet/Directory.Build.props" />
@@ -69,7 +70,6 @@
   </Folder>
   <Folder Name="/examples/AspNetCore/" />
   <Folder Name="/examples/AspNetCore/OData/">
-    <File Path="examples/AspNetCore/OData/Directory.Build.props" />
     <Project Path="examples/AspNetCore/OData/ODataAdvancedExample/ODataAdvancedExample.csproj" />
     <Project Path="examples/AspNetCore/OData/ODataBasicExample/ODataBasicExample.csproj" />
     <Project Path="examples/AspNetCore/OData/ODataConventionsExample/ODataConventionsExample.csproj" />

examples/AspNet/Directory.Build.props

@@ -2,21 +2,6 @@
 <Project xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
 
  <Import Project="$([MSBuild]::GetPathOfFileAbove('$(MSBuildThisFile)','$(MSBuildThisFileDirectory)../'))" />
- 
- <PropertyGroup>
-  <OutputType>Exe</OutputType>
- </PropertyGroup>
- 
- <ItemGroup>
-  <PackageReference Include="Microsoft.AspNet.WebApi.OwinSelfHost" Version="5.3.*" />
- </ItemGroup>
-
- <ItemGroup>
-  <AssemblyAttribute Include="Microsoft.Owin.OwinStartupAttribute">
-   <_Parameter1>ApiVersioning.Examples.Startup</_Parameter1>
-   <_Parameter1_TypeName>System.Type</_Parameter1_TypeName>
-  </AssemblyAttribute>
- </ItemGroup>
 
  <ItemGroup>
   <Compile Include="$(MSBuildThisFileDirectory)Startup.Newtonsoft.cs" DependentUpon="Startup.cs" />

examples/AspNet/OData/AdvancedODataWebApiExample/AdvancedODataWebApiExample.csproj

@@ -2,12 +2,17 @@
 
  <PropertyGroup>
   <TargetFramework>net48</TargetFramework>
+  <OutputType>Exe</OutputType>
  </PropertyGroup>
 
  <ItemGroup>
   <Reference Include="System.ComponentModel.DataAnnotations" />
  </ItemGroup>
 
+ <ItemGroup>
+  <PackageReference Include="Microsoft.AspNet.WebApi.OwinSelfHost" />
+ </ItemGroup>
+
  <ItemGroup>
   <ProjectReference Include="..\..\..\..\src\AspNet\OData\src\Asp.Versioning.WebApi.OData\Asp.Versioning.WebApi.OData.csproj" />
  </ItemGroup>

examples/AspNet/OData/AdvancedODataWebApiExample/Configuration/OrderModelConfiguration.cs

@@ -13,7 +13,7 @@ private EntityTypeConfiguration<Order> ConfigureCurrent( ODataModelBuilder build
     {
         var order = builder.EntitySet<Order>( "Orders" ).EntityType;
 
-        order.HasKey( p => p.Id );
+        order.HasKey( p => p.Id ).Select();
 
         return order;
     }

examples/AspNet/OData/AdvancedODataWebApiExample/Configuration/PersonModelConfiguration.cs

@@ -20,7 +20,7 @@ private EntityTypeConfiguration<Person> ConfigureCurrent( ODataModelBuilder buil
     {
         var person = builder.EntitySet<Person>( "People" ).EntityType;
 
-        person.HasKey( p => p.Id );
+        person.HasKey( p => p.Id ).Select();
 
         return person;
     }

examples/AspNet/OData/AdvancedODataWebApiExample/Examples.http

@@ -0,0 +1,74 @@
+# For more info on HTTP files go to https://aka.ms/vs/httpfile
+
+@baseUrl = http://localhost:9006
+
+### VERSION 1.0
+
+### People - Get All (OData)
+# Note: assumes the version when AssumeDefaultVersionWhenUnspecified = true,
+# which is meant for existing, unversioned apis
+GET {{baseUrl}}/api/people
+
+### People - Get All (OData)
+GET {{baseUrl}}/api/people?api-version=1.0
+
+### People - Get All with $select (OData)
+GET {{baseUrl}}/api/people?api-version=1.0&$select=firstName,lastName
+
+### People - Get by Key (OData)
+GET {{baseUrl}}/api/people/1?api-version=1.0
+
+### Orders - Get All (Standard)
+# Note: assumes the version when AssumeDefaultVersionWhenUnspecified = true,
+# which is meant for existing, unversioned apis
+GET {{baseUrl}}/api/orders
+
+### Orders - Get All (Standard)
+GET {{baseUrl}}/api/orders?api-version=1.0
+
+### Orders - Get by Key (Standard)
+GET {{baseUrl}}/api/orders/1?api-version=1.0
+
+### VERSION 2.0
+
+### People - Get All (OData)
+GET {{baseUrl}}/api/people?api-version=2.0
+
+### People - Get All with $select (OData)
+GET {{baseUrl}}/api/people?api-version=2.0&$select=firstName,lastName,email
+
+### People - Get by Key (OData)
+GET {{baseUrl}}/api/people/1?api-version=2.0
+
+### People - Partial Update (OData)
+PATCH {{baseUrl}}/api/people/1?api-version=2.0
+content-type: application/json
+prefer: return=representation
+
+{"firstName":"John","lastName":"Doe"}
+
+### Orders - Get All (OData)
+GET {{baseUrl}}/api/orders?api-version=2.0
+
+### Orders - Get All with $select (OData)
+GET {{baseUrl}}/api/orders?api-version=2.0&$select=id,customer
+
+### Orders - Get by Key (OData)
+GET {{baseUrl}}/api/orders/1?api-version=2.0
+
+### VERSION 3.0
+
+### People - Get All (OData)
+GET {{baseUrl}}/api/people?api-version=3.0
+
+### People - Get All with $select (OData)
+GET {{baseUrl}}/api/people?api-version=3.0&$select=firstName,lastName,email
+
+### People - Get by Key (OData)
+GET {{baseUrl}}/api/people/1?api-version=3.0
+
+### Orders - Get All (Standard)
+GET {{baseUrl}}/api/orders?api-version=3.0
+
+### Orders - Get by Key (Standard)
+GET {{baseUrl}}/api/orders/1?api-version=3.0

examples/AspNet/OData/AdvancedODataWebApiExample/README.md

@@ -0,0 +1,5 @@
+# ASP.NET Web API with OData Advanced Example
+
+This example project illustrates advanced scenarios that mixes and matches between standard ASP.NET Web API controllers
+and OData controllers. Services can transition to or from OData across API versions. Launch the project and try the
+[example requests](Examples.http) to view an API in action.

examples/AspNet/OData/BasicODataWebApiExample/BasicODataWebApiExample.csproj

@@ -2,12 +2,17 @@
 
  <PropertyGroup>
   <TargetFramework>net48</TargetFramework>
+  <OutputType>Exe</OutputType>
  </PropertyGroup>
 
  <ItemGroup>
   <Reference Include="System.ComponentModel.DataAnnotations" />
  </ItemGroup>
 
+ <ItemGroup>
+  <PackageReference Include="Microsoft.AspNet.WebApi.OwinSelfHost" />
+ </ItemGroup>
+
  <ItemGroup>
   <ProjectReference Include="..\..\..\..\src\AspNet\OData\src\Asp.Versioning.WebApi.OData\Asp.Versioning.WebApi.OData.csproj" />
  </ItemGroup>

examples/AspNet/OData/BasicODataWebApiExample/Configuration/OrderModelConfiguration.cs

@@ -13,7 +13,7 @@ private EntityTypeConfiguration<Order> ConfigureCurrent( ODataModelBuilder build
     {
         var order = builder.EntitySet<Order>( "Orders" ).EntityType;
 
-        order.HasKey( p => p.Id );
+        order.HasKey( p => p.Id ).Select();
 
         return order;
     }

examples/AspNet/OData/BasicODataWebApiExample/Configuration/PersonModelConfiguration.cs

@@ -20,7 +20,7 @@ private EntityTypeConfiguration<Person> ConfigureCurrent( ODataModelBuilder buil
     {
         var person = builder.EntitySet<Person>( "People" ).EntityType;
 
-        person.HasKey( p => p.Id );
+        person.HasKey( p => p.Id ).Select();
 
         return person;
     }