RESTier

<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>RESTier</title> <meta name="description" content="Documentation - tutorials, guides - for RESTier. "> <meta http-equiv="X-UA-Compatible" content="IE=edge"> <script src="//code.jquery.com/jquery-1.11.2.min.js"></script> <script src="//code.jquery.com/jquery-migrate-1.2.1.min.js"></script>  <link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/css/bootstrap.min.css">  <script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.4/js/bootstrap.min.js"></script> <link rel="stylesheet" href="/RESTier/css/main.css"> <link rel="canonical" href="http://yourdomain.com/RESTier/"> <link rel="alternate" type="application/rss+xml" title="RESTier" href="http://yourdomain.com/RESTier/feed.xml" /> </head> <body data-spy="scroll" data-target="#nav-sidebar"> <header class="site-header"> <div class="container"> <a class="site-title" href="/RESTier/">RESTier</a> <nav class="site-nav"> <a href="#" class="menu-icon"> <svg viewBox="0 0 18 15"> <path fill="#424242" d="M18,1.484c0,0.82-0.665,1.484-1.484,1.484H1.484C0.665,2.969,0,2.304,0,1.484l0,0C0,0.665,0.665,0,1.484,0 h15.031C17.335,0,18,0.665,18,1.484L18,1.484z"/> <path fill="#424242" d="M18,7.516C18,8.335,17.335,9,16.516,9H1.484C0.665,9,0,8.335,0,7.516l0,0c0-0.82,0.665-1.484,1.484-1.484 h15.031C17.335,6.031,18,6.696,18,7.516L18,7.516z"/> <path fill="#424242" d="M18,13.516C18,14.335,17.335,15,16.516,15H1.484C0.665,15,0,14.335,0,13.516l0,0 c0-0.82,0.665-1.484,1.484-1.484h15.031C17.335,12.031,18,12.696,18,13.516L18,13.516z"/> </svg> </a> <div class="trigger"> </div> </nav> </div> </header> <div class="page-content"> <div class="container"> <style type="text/css"> .affix-top{ position:fixed; top:80px; left: 75%; } .affix{ position:fixed; top:-100px; left: 75%; } .post-title{ margin-bottom: 30px; border-bottom: 1px; border-bottom-color: #e8e8e8; border-bottom-style: solid; } .post-content{ margin-bottom: 60px; } .nav>li>a { position: relative; display: block; padding: 0px 5px; } ul.nav{ margin-left: 5px; } </style> <script type="text/javascript"> $(document).ready(function(){ // Nav bar $("#nav-sidebar>ul>li>div").hide(); $(window).scroll(function(){ $("#nav-sidebar>ul>li>div").hide(); $("#nav-sidebar>ul>li.active>div").show(); }); $("#nav-sidebar>ul>li").click(function(){ $("#nav-sidebar>ul>li").removeClass('active'); $(this).addClass('active'); $("#nav-sidebar>ul>li>div").hide(); $(this).children('div').show(); }); // Window width change $( window ).resize(function() { if ($(window).width() < 975) { $('#nav-sidebar').hide(); } else{ $('#nav-sidebar').show(); } }); });</script> <div class="home"> <div class="row"> <div id="nav-sidebar" class="col-md-3" data-spy="affix" data-offset-top="20000"> <ul class="nav nav-pills nav-stacked"> <li class="panel panel-default"> <a class="panel-heading"> 1. GETTING STARTED </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#01-01-Introduction">1.1 Introduction</a> </li> <li class="nav-item"> <a href="#01-02-Bootstrap">1.2 Bootstrap an OData service</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 2. FEATURES </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#02-01-Security">2.1 Security</a> </li> <li class="nav-item"> <a href="#02-02-entity-set-filters-new">2.2 Entity Set Filters</a> </li> <li class="nav-item"> <a href="#02-03-Submit-Logic">2.3 Submit Logic</a> </li> <li class="nav-item"> <a href="#02-04-ETAG">2.4 ETag Support</a> </li> <li class="nav-item"> <a href="#02-05-Model-building-0-5-0">2.5 Model Building</a> </li> <li class="nav-item"> <a href="#02-06-Composite-Key">2.6 Composite Key</a> </li> <li class="nav-item"> <a href="#02-07-Key-As-Segment">2.7 Key As Segment</a> </li> <li class="nav-item"> <a href="#02-08-Customize-Query">2.8 Customize Query</a> </li> <li class="nav-item"> <a href="#02-09-Customize-Submit">2.9 Customize Submit</a> </li> <li class="nav-item"> <a href="#02-10-Customize-Payload-Converter">2.10 Customize Payload Converter</a> </li> <li class="nav-item"> <a href="#02-11-Customize-Provider">2.11 Customize Serializer and Deserializer Provider</a> </li> <li class="nav-item"> <a href="#02-12-Derived-Type">2.12 Derived Type Support</a> </li> <li class="nav-item"> <a href="#02-13-Spatial-Type">2.13 Spatial Type Support</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 3. EXTENSIONS </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#03-01-Temporal">3.1 Use temporal types in RESTier Entity Framework</a> </li> <li class="nav-item"> <a href="#03-02-Controllers">3.2 Use Controllers in RESTier</a> </li> <li class="nav-item"> <a href="#03-03-Operation">3.3 Operations</a> </li> <li class="nav-item"> <a href="#03-04-InMemory">3.4 In-Memory Provider</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 4. DEEP IN RESTIER </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#04-01-Infrastructure">4.1 RESTier infrastructure</a> </li> <li class="nav-item"> <a href="#04-02-Api-Service">4.2 RESTier API Service</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 5. CLIENTS </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#05-01-Client">5.1 Clients</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 6. ANNOUNCEMENTS </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#06-01-Preview-Announcement">6.1 Release notes for RESTier 0.2.0-preview</a> </li> <li class="nav-item"> <a href="#06-02-RESTier-open-sourced">6.2 RESTier now open sourced on GitHub</a> </li> <li class="nav-item"> <a href="#06-03-0-3-0-beta-1">6.3 Release notes for RESTier 0.3.0-beta1</a> </li> <li class="nav-item"> <a href="#06-04-0-3-0-beta-2">6.4 Release notes for RESTier 0.3.0-beta2</a> </li> <li class="nav-item"> <a href="#06-05-0-4-0-rc">6.5 Release notes for RESTier 0.4.0-rc</a> </li> <li class="nav-item"> <a href="#06-06-0-4-0-rc2">6.6 Release notes for RESTier 0.4.0-rc2</a> </li> <li class="nav-item"> <a href="#06-07-0-5-0-beta">6.7 Release notes for RESTier 0.5.0-beta</a> </li> <li class="nav-item"> <a href="#06-08-0-6-0">6.8 Release notes for RESTier 0.6.0</a> </li> <li class="nav-item"> <a href="#06-09-1-0-0">6.9 Release notes for RESTier 1.0.0</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 7. TOOLING </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#07-01-Restier-Scaffolding">7.1 Restier Scaffolding</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 8. OTHERS </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#08-01-Sample-Services">8.1 Sample Services</a> </li> <li class="nav-item"> <a href="#08-02-Debug">8.2 How to Debug</a> </li> </ul> </div> </li> <li class="panel panel-default"> <a class="panel-heading"> 9. THANK YOU! </a> <div class="panel-body"> <ul class="nav nav-pills nav-stacked"> <li class="nav-item"> <a href="#09-01-Thank-You">9.1 Vendors</a> </li> </ul> </div> </li> </ul> </div> <div class="col-md-9"> <div class="alert alert-success" role="alert"> For a unified experience, please go to the <a href="https://github.com/odata/RESTier/issues" target="_blank">GitHub Issues</a> to ask question, report bugs, and ask for features. This document is for current release version 1.0 (First GA). For document of version 0.6.0, refer to <a href="http://odata.github.io/RESTier/v0.6" target="_blank">Version 0.6.0 document</a> </div> <h1 class="post-title" id="1-Getting-Started">1. GETTING STARTED</h1> <ul class="post-list"> <li> <h2 class="post-title" id="01-01-Introduction">1.1 Introduction</h2> <article class="post-content"> OData stands for the Open Data Protocol. It was initiated by Microsoft and is now an ISO and OASIS standard. OData enables the creation and consumption of RESTful APIs, which allow resources, defined in a data model and identified by using URLs, to be published and edited by Web clients using simple HTTP requests. RESTier is a RESTful API development framework for building standardized, OData V4 based RESTful services on .NET platform. It can be seen as a middle-ware on top of <a href="http://odata.github.io/WebApi/">Web API OData</a>. RESTier provides facilities to bootstrap an OData service like what WCF Data Services (which is sunset) does, beside this, it supports to add business logic in several simple steps, has flexibility and easy customization like what Web API OData do. It also supports to add additional publishers to support other protocols and additional providers to support other data sources. For more information about OData, please refer to the following resources: <a href="http://www.odata.org/">OData.org</a> <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata">OASIS Open Data Protocol (OData) Technical Committee</a> For more information about OData .Net Library, refer to <a href="http://odata.github.io/odata.net/">OData .Net Library document</a>. For more information about Web API OData Library, refer to <a href="http://odata.github.io/WebApi/">Web API OData Library document</a>. </article> </li> <li> <h2 class="post-title" id="01-02-Bootstrap">1.2 Bootstrap an OData service</h2> <article class="post-content"> After RESTier 0.4.0, creating an OData service has never been easier! This subsection shows how to create an OData V4 endpoint using RESTier in a few minutes. <a href="http://msftdbprodsamples.codeplex.com/downloads/get/354847">AdventureWorksLT</a> will be used as the sample database and <a href="http://msdn.microsoft.com/en-us/data/ef.aspx">Entity Framework</a> as the data proxy. <h3 id="create-a-project-and-a-web-app">Create a project and a web app</h3> 1.Open Visual Studio 2015 or Visual Studio 2013. If you use Visual Studio 2013, the screens will be slightly different from the screenshots, but the procedures are essentially the same. 2.From the File menu, click New > Project. 3.In the New Project dialog box, click C# > Web > ASP.NET Web Application. 4.Clear the Add Application Insights to Project check box. 5.Name the application HelloWorld. 6.Click OK. <img src="/RESTier/images/solution.PNG" alt="" /> 7.In the New ASP.NET Project dialog box, select the Empty template. 8.Select the Web API check box. 9.Clear the Host in the cloud check box. <img src="/RESTier/images/project.PNG" alt="" /> <h3 id="install-the-restier-packages">Install the RESTier packages</h3> 1.In the Solution Explorer window, right click the project HelloWorld and select Manage NuGet Packages…. 2.In the NuGet Package Manager window, select the Include prerelease checkbox. 3.Type Restier in the Search Box beside and press Enter. 4.Select Microsoft.Restier and click the Install button. <img src="/RESTier/images/nuget.PNG" alt="" /> 5.In the Preview dialog box, click the OK button. <img src="/RESTier/images/preview.PNG" alt="" /> 6.In the License Acceptance dialog box, click the I Accept button. <img src="/RESTier/images/license.PNG" alt="" /> <h3 id="generate-the-model-classes">Generate the model classes</h3> 1.Download <a href="http://msftdbprodsamples.codeplex.com/downloads/get/354847">AdventureWorksLT2012_Data.mdf</a> and <a href="https://msdn.microsoft.com/en-us/library/8b6y4c7s.aspx">import</a> it into the <code class="highlighter-rouge">(localdb)\MSSQLLocalDB</code> database. 2.In the Solution Explorer window, right click the Models folder under the project HelloWorld and select Add > New Item. 3.In the Add New Item - HelloWorld dialog box, click C# > Data > ADO.NET Entity Data Model. 4.Name the model AdventureWorksLT. 5.Click the Add button. <img src="/RESTier/images/model.PNG" alt="" /> 6.In the Entity Data Model Wizard window, select the item Code First from database. 7.Click the Next button. <img src="/RESTier/images/codefirst1.PNG" alt="" /> 8.Click the New Connection button. <img src="/RESTier/images/codefirst2.PNG" alt="" /> 9.In the Connection Properties dialog box, type (localdb)\MSSQLLocalDB for Server name. 10.Select AdventureWorksLT2012 for database name. <img src="/RESTier/images/codefirst3.PNG" alt="" /> 11.After returning to the Entity Data Model Wizard window, click the Next button. <img src="/RESTier/images/codefirst4.PNG" alt="" /> 12.Select the Tables check box and click the Finish button. <img src="/RESTier/images/codefirst5.PNG" alt="" /> <h3 id="configure-the-odata-endpoint">Configure the OData Endpoint</h3> In the Solution Explorer window, click HelloWorld > App_Start > WebApiConfig.cs. Replace the <code class="highlighter-rouge">WebApiConfig</code> class the following code. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace HelloWorld { public static class WebApiConfig { public async static void Register(HttpConfiguration config) { // enable query options for all properties config.Filter().Expand().Select().OrderBy().MaxTop(null).Count(); await config.MapRestierRoute<EntityFrameworkApi<AdventureWorksLT>>( "AdventureWorksLT", "api/AdventureWorksLT", new RestierBatchHandler(GlobalConfiguration.DefaultServer)); } } }</code></pre></figure> Note : DbApi was renamed to EntityFrameworkApi from version 0.5. The configuration “config.Filter().Expand().Select().OrderBy().MaxTop(null).Count();” is enabling filter/expand/select/orderby/count on all properties, starting 1.0 release, there are more smaller granularity control on the properties which can be used in query option, and all properties are disabled to be used by default. User can add configured in CLR class or during model build to configure which properties are allowed to be used in filter/expand/select/orderby/count. Refer to <a href="http://odata.github.io/WebApi/#13-01-modelbound-attribute">Model bound</a> document for more details. After these steps, you will have finished bootstrapping an OData service endpoint. You can then Run the project and an OData service is started. Then you can start by accessing the URL <code class="highlighter-rouge">http://localhost:<ISS Express port>/api/AdventureWorksLT</code> to view all available entity sets, and try with other basic OData CRUD operations. For instance, you may try querying any of the entity sets using the <code class="highlighter-rouge">$select</code>, <code class="highlighter-rouge">$filter</code>, <code class="highlighter-rouge">$orderby</code>, <code class="highlighter-rouge">$top</code>, <code class="highlighter-rouge">$skip</code> or <code class="highlighter-rouge">$apply</code> query string parameters. </article> </li> </ul> <h1 class="post-title" id="2-Features">2. FEATURES</h1> <ul class="post-list"> <li> <h2 class="post-title" id="02-01-Security">2.1 Security</h2> <article class="post-content"> Authentication and Authorization REStier is transparent to security now, any security configurations / methodology working for Web APi will work for RESTier. One item is special in RESTier, there is only one controller named RESTier controller, and user can implement other additional controllers which extends ODataController class, in order to have consistent authentication for all these controllers, user need to configure Authentication and Authorization filter at global level. Restier also provides capability to inspect each request, refer section <a href="http://odata.github.io/RESTier/v0.6/#02-08-Customize-Query">2.8</a> and <a href="http://odata.github.io/RESTier/v0.6/#02-09-Customize-Submit">2.9</a> for more details. For Web Api security, refer to <a href="http://www.asp.net/web-api/overview/security">Web Api Security document</a>. Note: Restier uses asynchronous call to the provider layer (entity framework), this means by default the principal used to logic the application will not passed to call to provider, if the application need to pass principal from application to provider layer, refer to this <a href="https://blogs.msdn.microsoft.com/tom/2008/04/22/making-an-asynchronous-call-using-the-impersonation-identity/">link</a> on the detail configuration. </article> </li> <li> <h2 class="post-title" id="02-02-entity-set-filters-new">2.2 Entity Set Filters</h2> <article class="post-content"> Entity set filter convention helps plug in a piece of filtering logic for entity set. It is done via adding an <code class="highlighter-rouge">OnFilter[entity type name](IQueryable<T> entityset)</code> method to the <code class="highlighter-rouge">Api</code> class. <div class="highlighter-rouge"><pre class="highlight"><code>1. The filter method name must be OnFilter[entity type name], ending with the target entity type name. 2. It must be a **protected** method on the `Api` class. 3. It should accept an IQueryable<T> parameter and return an IQueryable<T> result where T is the entity type. </code></pre> </div> Supposed that ~/AdventureWorksLT/Products can get all the Product entities, the below OnFilterProduct method will filter some Product entities by checking the ProductID. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace AdventureWorksLTSample.Models { public class AdventureWorksApi : EntityFrameworkApi<AdventureWorksContext> { protected IQueryable<Product> OnFilterProduct(IQueryable<Product> entitySet) { return entitySet.Where(s => s.ProductID % 3 == 0).AsQueryable(); } } }</code></pre></figure> Then replace the <code class="highlighter-rouge">EntityFrameworkApi<AdventureWorksLT></code> in WebApiConfig with <code class="highlighter-rouge">AdventureWorksApi</code>, Now some testings will show that: <div class="highlighter-rouge"><pre class="highlight"><code>1. ~/AdventureWorksLT/Products will only get the Product entities whose ProductID is 3,6,9,12,15,... 2. ~/AdventureWorksLT/Products([product id]) will only be able to get a Product entity whose ProductID mod 3 results a zero. </code></pre> </div> Note: 1. Starting from version 0.6, the conversion name is changed to OnFilter[entity type name], and before version 0.6, the name is OnFilter[entity set name] <ol> <li> Starting from version 0.6, the filter is applied to all places besides the top level entity set which includes navigation properties, collection of entity in $expand, collection in filter and so on. Refer to end to end test case <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.Tests/TrippinE2EOnFilterTestCases.cs">TrippinE2EOnFilterTestCases</a> for all the scenarios supported. </li> <li> More meaningful filter can be adopted like filter entity by the owner and the entity owner is current request user. </li> </ol> </article> </li> <li> <h2 class="post-title" id="02-03-Submit-Logic">2.3 Submit Logic</h2> <article class="post-content"> Submit logic convention allows users to authorize a submit operation or plug in user logic (such as logging) before and after a submit operation. Usually a submit operation can be inserting an entity, deleting an entity, updating an entity or executing an OData action. Customize submit logic with single class for all entity set is also supported, refer to <a href="http://odata.github.io/RESTier/v0.6/#02-09-Customize-Submit">section 2.9</a> for more detail. <h3 id="authorization">Authorization</h3> Users can control if one of the four submit operations is allowed on some entity set or action by putting some protected methods into the <code class="highlighter-rouge">Api</code> class. The method signatures must exactly match the following examples. The method name must conform to <code class="highlighter-rouge">Can<Insert|Update|Delete|Execute><EntitySetName|ActionName></code>. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : EntityFrameworkApi<TrippinModel> { ... // Can delete an entity from the entity set Trips? protected bool CanDeleteTrips() { return false; } // Can execute an action named ResetDataSource? protected bool CanExecuteResetDataSource() { return false; } } }</code></pre></figure> <h3 id="plug-in-user-logic">Plug in user logic</h3> Users can plug in user logic before and after executing one of the four submit operations by putting similar protected methods into the <code class="highlighter-rouge">Api</code> class. The method signatures must also exactly match the following examples. The method name must conform to <code class="highlighter-rouge">On<Insert|Updat|Delet|Execut><ed|ing><EntitySetName|ActionName></code> where <code class="highlighter-rouge">ing</code> for before submit and <code class="highlighter-rouge">ed</code> for after submit. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.Restier.Samples.Northwind.Models { public class NorthwindApi : EntityFrameworkApi<NorthwindContext> { ... // Gets called before updating an entity from the entity set Products. protected void OnUpdatingProducts(Product product) { WriteLog(DateTime.Now.ToString() + product.ProductID + " is being updated"); } // Gets called after inserting an entity to the entity set Products. protected void OnInsertedProducts(Product product) { WriteLog(DateTime.Now.ToString() + product.ProductID + " has been inserted"); } } }</code></pre></figure> </article> </li> <li> <h2 class="post-title" id="02-04-ETAG">2.4 ETag Support</h2> <article class="post-content"> RESTier supports ETag starting from version 0.6. In order to support etag, the entity clr class must have some properties which are marked with [ConcurrencyCheck] attribute, then the properties with this attribute will be used to calculate the etag for concurrency support purpose. The etag support is divided into two parts, First part is the “@odata.etag” annotation support, it is part of response body, and will be auto added for any entity type which has properties with ConcurrencyCheck attribute when the request is a single entity or a collection of entity (in collection case, each entity instance will have “@odata.etag” annotation). Second part is Etag header support, this is only support when operation is against a single entity. Here are the summary of the behavior. <table> <thead> <tr> <th>Operation</th> <th>Header</th> <th>Etag matched?</th> <th>Response</th> </tr> </thead> <tbody> <tr> <td>Get</td> <td>If-Match</td> <td>No</td> <td>412(Precondition failed)</td> </tr> <tr> <td> </td> <td> </td> <td>Yes</td> <td>Return the entity</td> </tr> <tr> <td> </td> <td>If-None-Match</td> <td>No</td> <td>Return the entity</td> </tr> <tr> <td> </td> <td> </td> <td>Yes</td> <td>304(Not modified)</td> </tr> <tr> <td>Update/Delete</td> <td>No header</td> <td> </td> <td>428 (Precondition required)</td> </tr> <tr> <td> </td> <td>If-Match</td> <td>No</td> <td>412(Precondition failed)</td> </tr> <tr> <td> </td> <td> </td> <td>Yes</td> <td>Proceed the operation</td> </tr> <tr> <td> </td> <td>If-None-Match</td> <td>No</td> <td>Proceed the operation</td> </tr> <tr> <td> </td> <td> </td> <td>Yes</td> <td>412(Precondition failed)</td> </tr> </tbody> </table> In order to support the get method return the etag header, this configuration is a must, <div class="highlighter-rouge"><pre class="highlight"><code>config.MessageHandlers.Add(new ETagMessageHandler()); </code></pre> </div> User can define his own message handler to set the etag header in the response. For both etag annotation and etag header, the algorithm to generate the etag can be replaced, user can create his own etag handler, then set in the config, and default is DefaultODataETagHandler. The code to set customize etag handler is as following, <div class="highlighter-rouge"><pre class="highlight"><code>IETagHandler eTagHandler = new CustomizedETagHandler(); config.SetETagHandler(eTagHandler); </code></pre> </div> For detail end to end examples, refer to end to end test case <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.Tests/TrippinE2EEtagTestCases.cs">TrippinE2EEtagTestCases</a>. With etag support, the entity can be operated in concurrency mode. </article> </li> <li> <h2 class="post-title" id="02-05-Model-building-0-5-0">2.5 Model Building</h2> <article class="post-content"> RESTier supports various ways to build EDM model. Users may first get an initial model from the EF provider. Then RESTier’s <code class="highlighter-rouge">RestierModelExtender</code> can further extend the model with additional entity sets, singletons and operations from the public properties and methods defined in the <code class="highlighter-rouge">Api</code> class. This subsection mainly talks about how to build an initial EDM model and then the convention RESTier adopts to extend an EDM model from an <code class="highlighter-rouge">Api</code> class. <h3 id="build-an-initial-edm-model">Build an initial EDM model</h3> The <code class="highlighter-rouge">RestierModelExtender</code> requires EDM types to be present in the initial model because it is only responsible for building entity sets, singletons and operations NOT types. So anyway users need to build an initial EDM model with adequate types added in advance. The typical way to do so is to write a custom model builder implementing <code class="highlighter-rouge">IModelBuilder</code> and register it to the <code class="highlighter-rouge">Api</code> class. Here is an example using the <a href="http://odata.github.io/WebApi/#02-04-convention-model-builder"><code class="highlighter-rouge">**ODataConventionModelBuilder**</code></a> in OData Web API to build an initial model only containing the <code class="highlighter-rouge">Person</code> type. Any model building methods supported by Web API OData can be used here, refer to <a href="http://odata.github.io/WebApi/#02-01-model-builder-abstract">Web API OData Model builder </a>document for more information. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.TrippinInMemory { public class TrippinApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { services.AddService<IModelBuilder, CustomizedModelBuilder>(); return ApiBase.ConfigureApi(apiType, services); } private class CustomizedModelBuilder : IModelBuilder { public Task<IEdmModel> GetModelAsync(InvocationContext context, CancellationToken cancellationToken) { var builder = new ODataConventionModelBuilder(); builder.EntityType<Person>(); return Task.FromResult(builder.GetEdmModel()); } } } }</code></pre></figure> If RESTier entity framework provider is used and user has no additional types other than those in the database schema, no custom model builder or even the <code class="highlighter-rouge">Api</code> class is required because the provider will take over to build the model instead. But what the provider does behind the scene is similar. With entity framework provider, the model by default is built with <a href="http://odata.github.io/WebApi/#02-04-convention-model-builder">ODataConventionModelBuilder</a>, refer to <a href="http://odata.github.io/WebApi/#02-04-convention-model-builder">document</a> on the conversions been used like how the builder identifies keys for entity type and so on. <h3 id="extend-a-model-from-api-class">Extend a model from Api class</h3> The <code class="highlighter-rouge">RestierModelExtender</code> will further extend the EDM model passed in using the public properties and methods defined in the <code class="highlighter-rouge">Api</code> class. Please note that all properties and methods declared in the parent classes are NOT considered. Entity set If a property declared in the <code class="highlighter-rouge">Api</code> class satisfies the following conditions, an entity set whose name is the property name will be added into the model. <ul> <li>Has Resource attribute</li> <li>Public</li> <li>Has getter</li> <li>Either static or instance</li> <li>There is no existing entity set with the same name</li> <li>Return type must be <code class="highlighter-rouge">IQueryable<T></code> where <code class="highlighter-rouge">T</code> is class type</li> </ul> Example: <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : EntityFrameworkApi<TrippinModel> { [Resource] public IQueryable<Person> PeopleWithFriends { get { return Context.People.Include("Friends"); } } ... } }</code></pre></figure> Singleton If a property declared in the <code class="highlighter-rouge">Api</code> class satisfies the following conditions, a singleton whose name is the property name will be added into the model. <ul> <li>Has Resource attribute</li> <li>Public</li> <li>Has getter</li> <li>Either static or instance</li> <li>There is no existing singleton with the same name</li> <li>Return type must be non-generic class type</li> </ul> Example: <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : EntityFrameworkApi<TrippinModel> { ... [Resource] public Person Me { get { return DbContext.People.Find(1); } } ... } }</code></pre></figure> Due to some limitations from Entity Framework and OData spec, CUD (insertion, update and deletion) on the singleton entity are NOT supported directly by RESTier. Users need to define their own route to achieve these operations. Navigation property binding Starting from version 0.5.0, the <code class="highlighter-rouge">RestierModelExtender</code> follows the rules below to add navigation property bindings after entity sets and singletons have been built. <ul> <li>Bindings will ONLY be added for those entity sets and singletons that have been built inside <code class="highlighter-rouge">RestierModelExtender</code>. Example: Entity sets built by the RESTier’s EF provider are assumed to have their navigation property bindings added already.</li> <li>The <code class="highlighter-rouge">RestierModelExtender</code> only searches navigation sources who have the same entity type as the source navigation property. Example: If the type of a navigation property is <code class="highlighter-rouge">Person</code> or <code class="highlighter-rouge">Collection(Person)</code>, only those entity sets and singletons of type <code class="highlighter-rouge">Person</code> are searched.</li> <li>Singleton navigation properties can be bound to either entity sets or singletons. Example: If <code class="highlighter-rouge">Person.BestFriend</code> is a singleton navigation property, bindings from <code class="highlighter-rouge">BestFriend</code> to an entity set <code class="highlighter-rouge">People</code> or to a singleton <code class="highlighter-rouge">Boss</code> are all allowed.</li> <li>Collection navigation properties can ONLY be bound to entity sets. Example: If <code class="highlighter-rouge">Person.Friends</code> is a collection navigation property. ONLY binding from <code class="highlighter-rouge">Friends</code> to an entity set <code class="highlighter-rouge">People</code> is allowed. Binding from <code class="highlighter-rouge">Friends</code> to a singleton <code class="highlighter-rouge">Boss</code> is NOT allowed.</li> <li>If there is any ambiguity among entity sets or singletons, no binding will be added. Example: For the singleton navigation property <code class="highlighter-rouge">Person.BestFriend</code>, no binding will be added if 1) there are at least two entity sets (or singletons) both of type <code class="highlighter-rouge">Person</code>; 2) there is at least one entity set and one singleton both of type <code class="highlighter-rouge">Person</code>. However for the collection navigation property <code class="highlighter-rouge">Person.Friends</code>, no binding will be added only if there are at least two entity sets both of type <code class="highlighter-rouge">Person</code>. One entity set and one singleton both of type <code class="highlighter-rouge">Person</code> will NOT lead to any ambiguity and one binding to the entity set will be added.</li> </ul> If any expected navigation property binding is not added by RESTier, users can always manually add it through custom model extension (mentioned below). Operation If a method declared in the <code class="highlighter-rouge">Api</code> class satisfies the following conditions, an operation whose name is the method name will be added into the model. <ul> <li>Public</li> <li>Either static or instance</li> <li>There is no existing operation with the same name</li> </ul> Example: <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : EntityFrameworkApi<TrippinModel> { ... // Action import [Operation(Namespace = "Microsoft.OData.Service.Sample.Trippin.Models", HasSideEffects = true)] public void CleanUpExpiredTrips() {} // Bound action [Operation(Namespace = "Microsoft.OData.Service.Sample.Trippin.Models", IsBound = true, HasSideEffects = true)] public Trip EndTrip(Trip bindingParameter) { ... } // Function import [Operation(Namespace = "Microsoft.OData.Service.Sample.Trippin.Models", EntitySet = "People")] public IEnumerable<Person> GetPeopleWithFriendsAtLeast(int n) { ... } // Bound function [Operation(Namespace = "Microsoft.OData.Service.Sample.Trippin.Models", IsBound = true, EntitySet = "People")] public Person GetPersonWithMostFriends(IEnumerable<Person> bindingParameter) { ... } ... } }</code></pre></figure> Note: <ol> <li> Operation attribute’s EntitySet property is needed if there are more than one entity set of the entity type that is type of result defined. Take an example if two EntitySet People and AllPersons are defined whose entity type is Person, and the function returns Person or List of Person, then the Operation attribute for function must have EntitySet defined, or EntitySet property is optional. </li> <li> Function and Action uses the same attribute, and if the method is an action, must specify property HasSideEffects with value of true whose default value is false. </li> <li> Starting from version 0.6, the operation namespace will be same as the entity type by default if it is not specified, if the namespace is specified in operation attribute, then that namespaces in attribute will be used. Also in order to support operation bound to type like complex type/primitive type besides the entity type, IsBound flag must be set to true for bound operation. </li> <li> Starting from version 0.6, operation will be auto routed to method defined in Api class, no additional controller is needed. Refer to <a href="http://odata.github.io/RESTier/v0.6/#03-03-Operation">section 3.3</a> for more information. </li> </ol> <h3 id="custom-model-extension">Custom model extension</h3> If users have the need to extend the model even after RESTier’s conventions have been applied, user can use IServiceCollection AddService to add a ModelBuilder after calling ApiBase.ConfigureApi(apiType, services). <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { services = ApiBase.ConfigureApi(apiType, services); // Add your custom model extender here. services.AddService<IModelBuilder, CustomizedModelBuilder>(); return services; } private class CustomizedModelBuilder : IModelBuilder { public IModelBuilder InnerModelBuilder { get; set; } public async Task<IEdmModel> GetModelAsync(InvocationContext context, CancellationToken cancellationToken) { IEdmModel model = null; // Call inner model builder to get a model to extend. if (this.InnerModelBuilder != null) { model = await this.InnerModelBuilder.GetModelAsync(context, cancellationToken); } // Do sth to extend the model such as add custom navigation property binding. return model; } } } }</code></pre></figure> After the above steps, the final process of building the model will be: <ul> <li>User’s model builder registered before ApiBase.ConfigureApi(apiType, services) is called first.</li> <li>RESTier’s model builder includes EF model builder and RestierModelExtender will be called.</li> <li>User’s model builder registered after ApiBase.ConfigureApi(apiType, services) is called. </li> </ul> If InnerModelBuilder method is not called first, then the calling sequence will be different. Actually this order not only applies to the <code class="highlighter-rouge">IModelBuilder</code> but also all other services. Refer to <a href="http://odata.github.io/RESTier/v0.6/#04-03-Api-Service">section 4.3</a> for more details of RESTier API Service. </article> </li> <li> <h2 class="post-title" id="02-06-Composite-Key">2.6 Composite Key</h2> <article class="post-content"> Composite key means one entity has more then one attributes for the key. It is automatically supported by RESTIer without any additional configurations. To request an entity with composite key, the URL will be like <code class="highlighter-rouge">~/EntitySet(keyName1=value1,keyName2=value2)</code> </article> </li> <li> <h2 class="post-title" id="02-07-Key-As-Segment">2.7 Key As Segment</h2> <article class="post-content"> RESTier supports key as segment with one single line configuration before calling MapRestierRoute method: <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">config.SetUrlKeyDelimiter(ODataUrlKeyDelimiter.Slash);</code></pre></figure> Then request an entity with key as segment, the URL will be like <code class="highlighter-rouge">~/EntitySet/KeyValue</code> Note : If entity type has composite key, then key as segment is not supported for this entity type. </article> </li> <li> <h2 class="post-title" id="02-08-Customize-Query">2.8 Customize Query</h2> <article class="post-content"> RESTier supports to customize the query setting and query process logic. 1. Customize Query Setting RESTier supports to customize kinds of query setting like AllowedLogicalOperators, AllowedQueryOptions, MaxExpansionDepth, MaxAnyAllExpressionDepth and so on. Refer to <a href="https://github.com/OData/WebApi/blob/master/OData/src/System.Web.OData/OData/Query/ODataValidationSettings.cs">class</a> for full list of settings. This is an example on how to customize MaxExpansionDepth from default value 2 to 3 which means allowing two level nested expand now, refer to this <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEndTests/Microsoft.Restier.WebApi.Test.Services.Trippin/Api/TrippinApi.cs">link</a> to see the end to end samples, First create a factory delegate which will create a new instance of ODataValidationSettings, then registering it into RESTier Dependency Injection framework as a service via overriding the ConfigureApi method in your Api class. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { // Add OData Query Settings and valiadtion settings Func<IServiceProvider, ODataValidationSettings> validationSettingFactory = (sp) => new ODataValidationSettings { MaxAnyAllExpressionDepth =3, MaxExpansionDepth = 3 }; return ApiBase.ConfigureApi(apiType, services) .AddSingleton<ODataValidationSettings>(validationSettingFactory); }</code></pre></figure> Then $expand with supported with max two nested $expand via only max one nested $expand is supported by default before we apply this customization. 2. Customize Query Logic RESTier supports built in convention based query customized logic (refer to <a href="http://odata.github.io/RESTier/v0.6/#02-02-entity-set-filters-new">section 2.2</a>), besides this, RESTier has two interfaces IQueryExpressionAuthorizer and IQueryExpressionProcessor for end user to further customize the query process logic. Customized Authorize Logic User can use interface IQueryExpressionAuthorizer to define any customize authorize logic to see whether user is authorized for the specified query, if this method returns false, then the related query will get error code 403 (forbidden). There are two steps to plug in customized process logic, First create a class CustomizedAuthorizer implement IQueryExpressionAuthorizer, and add any process logic needed. Second, registering it into RESTier Dependency Injection framework as a service via overriding the ConfigureApi method in your Api class. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { return ApiBase.ConfigureApi(apiType, services) .AddService<IQueryExpressionInspector, CustomizedInspector>(); }</code></pre></figure> In CustomizedAuthorizer, user can decide whether to call the RESTier logic, if user decide to call the RESTier logic, user can defined a property like “private IQueryExpressionAuthorizer InnerAuthorizer {get; set;}” in class CustomizedAuthorizer, then call InnerAuthorizer.Authorize() to call RESTier logic. Customized Process Logic User can create class implementing interface IQueryExpressionProcessor to customize the LINQ query expression build process like to replace part of expression, remove part of expression or append part of expression. Then registered the customized class as DI service.The steps to plugin is same as above. The logic <a href="http://odata.github.io/RESTier/#02-02-entity-set-filters-new">OnFilter[entity set name]</a> is been processed by RESTier default expression processor which add a where clause after entity set. The way to call default logic is same as above. </article> </li> <li> <h2 class="post-title" id="02-09-Customize-Submit">2.9 Customize Submit</h2> <article class="post-content"> RESTier supports built in convention based logic (refer to <a href="http://odata.github.io/RESTier/v0.6/#02-03-Submit-Logic">section 2.3</a>) for submit, besides this, RESTier has three interfaces IChangeSetItemAuthorizer, IChangeSetItemValidator and IChangeSetItemProcessor for end user to customize the logic. Customized Authorize Logic User can use interface IChangeSetItemAuthorizer to define any customize authorize logic to see whether user is authorized for the specified submit, if this method return false, then the related query will get error code 403 (forbidden). There are two steps to plug in customized process logic, First create a class CustomizedAuthorizer implement IChangeSetItemAuthorizer, and add any process logic needed. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class CustomizedAuthorizer : IChangeSetItemAuthorizer { // The inner Authorizer will call CanUpdate/Insert/Delete<EntitySet> method private IChangeSetItemAuthorizer InnerAuthorizer { get; set; } public Task<bool> AuthorizeAsync( SubmitContext context, ChangeSetItem item, CancellationToken cancellationToken) { // Add any customized logic here } }</code></pre></figure> Second, registering it into RESTier Dependency Injection framework as a service via overriding the ConfigureApi method in your Api class. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Api { public class TrippinApi : EntityFrameworkApi<TrippinModel> { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { return EntityFrameworkApi<TrippinModel>.ConfigureApi(apiType, services) .AddService<IChangeSetItemAuthorizer, CustomizedAuthorizer>(); } } }</code></pre></figure> In CustomizedAuthorizer, user can decide whether to call the RESTier logic, if user decide to call the RESTier logic, user can defined a property like “private IChangeSetItemAuthorizer InnerAuthorizer {get; set;}” in class CustomizedAuthorizer, then call InnerAuthorizer.AuthorizeAsync() to call RESTier logic which call Authorize part logic defined in <a href="http://odata.github.io/RESTier/v0.6/#02-03-Submit-Logic">section 2.3</a>. Customized Validation Logic User can use interface IChangeSetItemValidator to customize validation logic for submit, and if validate fails, add a error validation result to validation results, then the request will get 400(bad request) return code, here is a sample customize validation logic, <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class CustomizedValidator : IChangeSetItemValidator { // Add any customized validation into this method public Task ValidateChangeSetItemAsync( SubmitContext context, ChangeSetItem item, Collection<ChangeSetItemValidationResult> validationResults, CancellationToken cancellationToken) { DataModificationEntry dataModificationEntry = entry as DataModificationEntry; var entity = dataModificationEntry.Entity; // Customized validate logic and if there is error, add a validation result with error level. validationResults.Add(new ChangeSetValidationResult() { Id = dataModificationEntry.EntitySetName+ dataModificationEntry.EntityKey, Message = "Customized error message", Severity = EventLevel.Error, Target = entity }); } }</code></pre></figure> The steps to plugin the logic is same as above. Customized Process Logic User can use interface IChangeSetItemProcessor to customize logic before or after submit, OnProcessingChangeSetItemAsync logic is called before submit and OnProcessedChangeSetItemAsync logic is called after submit, RESTier default logic is defined in section 2.3 plugin user logic part. Default logic can be called via defined a property with type IChangeSetItemProcessor like “private IChangeSetItemProcessor InnerProcessor {get; set;}”, and user call InnerProcessor.OnProcessingChangeSetItemAsync or OnProcessedChangeSetItemAsync to call RESTier logic, if in CustomizedProcessor, there is no such property defined or InnerProcessor is not used, then RESTier logic will not be called. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.Trippin.Submit { public class CustomizedSubmitProcessor : IChangeSetItemProcessor { private IChangeSetItemProcessor InnerProcessor { get; set; } // Any customized logic needed before persist called can be added here. // InnerProcessor call related OnUpdating|Inseting|Deleting<EntitySet> methods public Task OnProcessingChangeSetItemAsync(SubmitContext context, ChangeSetItem item, CancellationToken cancellationToken) { return InnerProcessor.OnProcessingChangeSetItemAsync(context, item, cancellationToken); } // Any customized logic needed after persist called can be added here. // InnerProcessor call related OnUpdated|Inseted|Deleted<EntitySet> methods public Task OnProcessedChangeSetItemAsync(SubmitContext context, ChangeSetItem item, CancellationToken cancellationToken) { var dataModificationItem = item as DataModificationItem; if (dataModificationItem != null) { object myEntity = dataModificationItem.Entity; string entitySetName = dataModificationItem.EntitySetName; ChangeSetItemAction operation = dataModificationItem.ChangeSetItemAction; // In case of insert, the request URL has no key, and request body may not have key neither as the key may be generated by database var keyAttrbiutes = new Dictionary<string, object>(); var keyConvention = new Dictionary<string, object>(); var entityTypeName = myEntity.GetType().Name; PropertyInfo[] properties = myEntity.GetType().GetProperties(); foreach (PropertyInfo property in properties) { var attribute = Attribute.GetCustomAttribute(property, typeof(KeyAttribute)) as KeyAttribute; var propName = property.Name; // This is getting key with Key attribute defined if (attribute != null) // This property has a KeyAttribute { // Do something, to read from the property: object val = property.GetValue(myEntity); keyAttrbiutes.Add(propName, val); } // This is getting key based on convention else if(propName.ToLower().Equals("id") || propName.ToLower().Equals(entityTypeName.ToLower()+"id")) { object val = property.GetValue(myEntity); keyConvention.Add(propName, val); } } if (keyAttrbiutes.Count > 0) { // Use property with key attribute as keys } else if(keyConvention.Count > 0) { // Key is defined based on convention } } return InnerProcessor.OnProcessedChangeSetItemAsync(context, item, cancellationToken); } } }</code></pre></figure> The steps to plugin the logic is same as above. </article> </li> <li> <h2 class="post-title" id="02-10-Customize-Payload-Converter">2.10 Customize Payload Converter</h2> <article class="post-content"> RESTier supports to customize the payload to be read or written (a.k.a serialize and deserialize), user can extend the class RestierPayloadValueConverter to overwrite method ConvertToPayloadValue for payload writing and ConvertFromPayloadValue for payload reading. This is an example on how to customize a specified string value to add some prefix and write into response, refer to this <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEndTests/Microsoft.Restier.WebApi.Test.Services.Trippin/Models/CustomizedPayloadValueConverter.cs">link</a> to see the end to end samples, 1. Create a class to have the customized converter logic <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> public class CustomizedPayloadValueConverter : RestierPayloadValueConverter { public override object ConvertToPayloadValue(object value, IEdmTypeReference edmTypeReference) { if (edmTypeReference != null) { if (value is string) { var stringValue = (string) value; // Make a single string value "Russell" converted to have additional suffix if (stringValue == "Russell") { return stringValue + "Converter"; } } } return base.ConvertToPayloadValue(value, edmTypeReference); } }</code></pre></figure> 2. Register customized converter into RESTier Dependency Injection framework as a service via overriding the ConfigureApi method in your Api class. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { return ApiBase.ConfigureApi(apiType, services) .AddSingleton<ODataPayloadValueConverter, CustomizedPayloadValueConverter>(); }</code></pre></figure> Then when writting payload for response, any string which has value “Russell” will become “RussellConverter”. </article> </li> <li> <h2 class="post-title" id="02-11-Customize-Provider">2.11 Customize Serializer and Deserializer Provider</h2> <article class="post-content"> RESTier supports to customize serializer and deserializer provider for payload reading and writing, then in the provider, it can return customized serializer or deserializer for specified EdmType to customize the payload reading and writing. This is an example on how to customize ODataComplexTypeSerializer to customize how complex type payload is serialized for response. First create a class which extends ODataComplexTypeSerializer, and override method WriteObject. Second create a class which extends DefaultRestierSerializerProvider, and override method GetODataPayloadSerializer and GetEdmTypeSerializer which will return the customized serializer, and this is sample code, <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> public override ODataSerializer GetODataPayloadSerializer( IEdmModel model, Type type, HttpRequestMessage request) { ODataSerializer serializer = null; if (type == typeof (ComplexResult)) { serializer = customizerComplexSerialier; } else { serializer = base.GetODataPayloadSerializer(model, type, request); } return serializer; } public override ODataEdmTypeSerializer GetEdmTypeSerializer(IEdmTypeReference edmType) { if (edmType.IsEntity()) { return this.entityTypeSerializer; } if (edmType.IsComplex()) { return customizerComplexSerialier; } return base.GetEdmTypeSerializer(edmType); }</code></pre></figure> Third, register customized serializer provider as DI service in the Api ConfigureApi method <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp"> protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { return ApiBase.ConfigureApi(apiType, services) .AddSingleton<ODataSerializerProvider, CustomizedSerializerProvider>(); }</code></pre></figure> With these customized code, the complex result will be serialized in the customized way. </article> </li> <li> <h2 class="post-title" id="02-12-Derived-Type">2.12 Derived Type Support</h2> <article class="post-content"> RESTier supports derived type starting from version 0.6. Derived type support does not need any additional configuration, it is supported by default. Refer to method CURDDerivedEntity in class <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.Tests/TrippinE2ETestCases.cs">TrippinE2ETestCases</a> and method DerivedTypeQuery in class <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.Tests/TrippinE2EQueryTestCases.cs">TrippinE2EQueryTestCases</a> to see the end to end example. Note: In a typical IIS configuration, the dot in this URL will cause IIS to return error 404. You can resolve this by adding the following section to your Web.Config file: <div class="highlighter-rouge"><pre class="highlight"><code><system.webServer> <handlers> <clear/> <add name="ExtensionlessUrlHandler-Integrated-4.0" path="/*" verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" /> </handlers> </system.webServer> </code></pre> </div> </article> </li> <li> <h2 class="post-title" id="02-13-Spatial-Type">2.13 Spatial Type Support</h2> <article class="post-content"> RESTier supports spatial type starting from version 0.6 with some manual effort. There are two ways to support spatial type, refer to the end to end samples for more detail. <a href="https://github.com/OData/ODataSamples/tree/master/RESTier/SpatialSample">SpatialSample</a> will need few manual effort to build model, but there is one limitation that user can not have the spatial type property in query option. <a href="https://github.com/OData/ODataSamples/tree/master/RESTier/SpatialSample2">SpatialSample2</a> will require to use Edm model builder to build model, have full support of spatial type. </article> </li> </ul> <h1 class="post-title" id="3-Extensions">3. EXTENSIONS</h1> <ul class="post-list"> <li> <h2 class="post-title" id="03-01-Temporal">3.1 Use temporal types in RESTier Entity Framework</h2> <article class="post-content"> Restier.EF now supports various temporal types. Compared to the previous support, the current solution is more consistent and extensible. You can find the detailed type-mapping table among EF type, SQL type and EDM type from the comment in <a href="https://github.com/OData/RESTier/pull/279">Issue #279</a>. Now almost all the OData scenarios (CRUD) of these temporal types should be well supported by RESTier. This subsection shows how to use temporal types in Restier.EF. <h3 id="add-edmdatetimeoffset-property">Add Edm.DateTimeOffset property</h3> Suppose you have an entity class <code class="highlighter-rouge">Person</code>, all the following code define <code class="highlighter-rouge">Edm.DateTimeOffset</code> properties in the EDM model though the underlying SQL types are different (see the value of the <code class="highlighter-rouge">TypeName</code> property). You can see Column attribute is optional here. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class Person { public DateTime BirthDateTime1 { get; set; } [Column(TypeName = "DateTime")] public DateTime BirthDateTime2 { get; set; } [Column(TypeName = "DateTime2")] public DateTime BirthDateTime3 { get; set; } public DateTimeOffset BirthDateTime4 { get; set; } }</code></pre></figure> <h3 id="add-edmdate-property">Add Edm.Date property</h3> The following code define an <code class="highlighter-rouge">Edm.Date</code> property in the EDM model. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class Person { [Column(TypeName = "Date")] public DateTime BirthDate { get; set; } }</code></pre></figure> <h3 id="add-edmduration-property">Add Edm.Duration property</h3> The following code define an <code class="highlighter-rouge">Edm.Duration</code> property in the EDM model. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class Person { public TimeSpan WorkingHours { get; set; } }</code></pre></figure> <h3 id="add-edmtimeofday-property">Add Edm.TimeOfDay property</h3> The following code define an <code class="highlighter-rouge">Edm.TimeOfDay</code> property in the EDM model. Please note that you MUST NOT omit the <code class="highlighter-rouge">ColumnTypeAttribute</code> on a <code class="highlighter-rouge">TimeSpan</code> property otherwise it will be recognized as an <code class="highlighter-rouge">Edm.Duration</code> as described above. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class Person { [Column(TypeName = "Time")] public TimeSpan BirthTime { get; set; } }</code></pre></figure> As before, if you have the need to override <code class="highlighter-rouge">ODataPayloadValueConverter</code>, please now change to override <code class="highlighter-rouge">RestierPayloadValueConverter</code> instead in order not to break the payload value conversion specialized for these temporal types. </article> </li> <li> <h2 class="post-title" id="03-02-Controllers">3.2 Use Controllers in RESTier</h2> <article class="post-content"> RESTier aims to achieve more OData features with less user code. Currently in OData Web API users have to write a controller for each entity set or singleton and a lot of actions in that controller to support various property access. Mostly code among controllers is similar and redundant. Thus <code class="highlighter-rouge">RestierController</code> (previously <code class="highlighter-rouge">ODataDomainController</code>) was introduced to serve as the globally unique controller to handle most OData requests. While most is not everything, there are a few scenarios not covered by <code class="highlighter-rouge">RestierController</code> yet. As a result, traditional controllers (<code class="highlighter-rouge">ODataController</code> or <code class="highlighter-rouge">ApiController</code>) are still supported in RESTier’s routing convention with higher priority than <code class="highlighter-rouge">RestierController</code>. With such a flexible design, RESTier can satisfy various user requirements to implement an OData service. <h3 id="odata-features-supported-by-restiercontroller">OData features supported by RestierController</h3> Now users need not write any controller code any more to enjoy the following OData features provided by <code class="highlighter-rouge">RestierController</code>: <ul> <li>Query service document</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~</code></pre></figure> <ul> <li>Query metadata document</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/$metadata</code></pre></figure> <ul> <li>Query entity set</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People</code></pre></figure> <ul> <li>Query single entity</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People(1)</code></pre></figure> <ul> <li>Query any property path</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People(1)/FirstName (primitive property) GET ~/People(1)/FavoriteFeature (enum property) GET ~/People(1)/Friends (navigation property) GET ~/People(1)/Emails (collection property) GET ~/Events(1)/OccursAt (complex property) GET ~/Events(1)/OccursAt/Address</code></pre></figure> <ul> <li>Query entity/value count (by $count)</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People(1)/$count GET ~/People(1)/Friends/$count GET ~/People(1)/Emails/$count</code></pre></figure> <ul> <li>Query raw property value (by $value)</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People(1)/FirstName/$value GET ~/People(1)/FavoriteFeature/$value GET ~/Events(1)/OccursAt/Address/$value</code></pre></figure> <ul> <li>Create an entity</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">POST ~/People</code></pre></figure> <ul> <li>Fully update an entity</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">PUT ~/People(1)</code></pre></figure> <ul> <li>Partially update an entity</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">PATCH ~/People(1)</code></pre></figure> <ul> <li>Delete an entity</li> </ul> <figure class="highlight"><pre><code class="language-text" data-lang="text">DELETE ~/People(1)</code></pre></figure> <h3 id="a-little-secret-behind-query">A little secret behind query</h3> Users may wonder how RESTier handles all these queries in a generic way in only one controller. Actually <code class="highlighter-rouge">RestierController</code> will use an internal class <code class="highlighter-rouge">RestierQueryBuilder</code> to go through each <code class="highlighter-rouge">ODataPathSegment</code> and gradually compose a LINQ query. Here is an example. If user sends the following query: <figure class="highlight"><pre><code class="language-text" data-lang="text">GET ~/People(1)/Emails/$count</code></pre></figure> The final LINQ query generated will be like (suppose EF is being used): <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">DbContext.People.Where<Person>(p => p.PersonId == 1).SelectMany<string>(p => p.Emails).Count();</code></pre></figure> <h3 id="use-custom-controllers">Use custom controllers</h3> Users may not always want their requests to be processed by <code class="highlighter-rouge">RestierController</code>. RESTier of course provides several ways to override this. <ul> <li>Convention routing. If user defines a controller (MUST inherit from <code class="highlighter-rouge">ODataController</code>) with specific name for an entity set (like <code class="highlighter-rouge">PeopleController</code> for the entity set <code class="highlighter-rouge">People</code>), all requests to that entity set will be routed to the the user-defined controller instead of <code class="highlighter-rouge">RestierController</code>. Refer to <a href="http://odata.github.io/WebApi/#03-02-built-in-routing-conventions">convention routing document</a> for more details.</li> <li>Attribute routing. <code class="highlighter-rouge">ODataRouteAttribute</code> always has the highest priority in routing. Now users are recommended to use attribute routing to implement OData operation and singleton. Refer to <a href="http://odata.github.io/WebApi/#03-03-attrribute-routing">attribute routing document</a> for more details.</li> </ul> </article> </li> <li> <h2 class="post-title" id="03-03-Operation">3.3 Operations</h2> <article class="post-content"> Operation includes function (bounded), function import (unbounded), action (bounded), and action(unbounded). To supports operation, there are two major items, first being able to build model for operation, refer to <a href="http://odata.github.io/RESTier/v0.6/#02-05-Model-building-0-5-0">section 2.5</a> for more details. Second support to route operation requests to a controller action. Starting from release 0.6.0, RESTier can auto route an operation request to the method defined in API class which is defined for operation model building, user does NOT need to define its own controller with ODataRoute attribute for operation route. Refer to <a href="https://github.com/OData/RESTier/blob/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.Tests/UrlConventionsTests.cs">end to end test cases</a> for end to end operation support samples. Note: In a typical IIS configuration, the dot in this URL will cause IIS to return error 404. You can resolve this by adding the following section to your Web.Config file: <div class="highlighter-rouge"><pre class="highlight"><code><system.webServer> <handlers> <clear/> <add name="ExtensionlessUrlHandler-Integrated-4.0" path="/*" verb="*" type="System.Web.Handlers.TransferRequestHandler" preCondition="integratedMode,runtimeVersionv4.0" /> </handlers> </system.webServer> </code></pre> </div> </article> </li> <li> <h2 class="post-title" id="03-04-InMemory">3.4 In-Memory Provider</h2> <article class="post-content"> RESTier supports building an OData service with all-in-memory resources. However currently RESTier has not provided a dedicated in-memory provider module so users have to write some service code to bootstrap the initial model with EDM types themselves. There is a sample service with in-memory provider <a href="https://github.com/OData/RESTier/tree/master/test/ODataEndToEnd/Microsoft.OData.Service.Sample.TrippinInMemory">here</a>. This subsection mainly talks about how such a service is created. First please create an Empty ASP.NET Web API project following the instructions in <a href="http://odata.github.io/RESTier/v0.6/#01-02-Bootstrap">Section 1.2</a>. Stop BEFORE the Generate the model classes part. <h3 id="create-the-api-class">Create the Api class</h3> Create a simple data type <code class="highlighter-rouge">Person</code> with some properties and “fabricate” some fake data. Then add the first entity set <code class="highlighter-rouge">People</code> to the <code class="highlighter-rouge">Api</code> class: <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.TrippinInMemory { public class TrippinApi : ApiBase { private static readonly List<Person> people = new List<Person> { ... }; [Resource] public IQueryable<Person> People { get { return people.AsQueryable(); } } } }</code></pre></figure> <h3 id="create-an-initial-model">Create an initial model</h3> Since the RESTier convention will not produce any EDM type, an initial model with at least the <code class="highlighter-rouge">Person</code> type needs to be created by service. Here the <code class="highlighter-rouge">ODataConventionModelBuilder</code> from OData Web API is used for quick model building. Any model building methods supported by Web API OData can be used here, refer to <a href="http://odata.github.io/WebApi/#02-01-model-builder-abstract">Web API OData Model builder </a>document for more information. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.TrippinInMemory { public class TrippinApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { services.AddService<IModelBuilder>(new ModelBuilder()); return ApiBase.ConfigureApi(apiType, services); } private class ModelBuilder : IModelBuilder { public Task<IEdmModel> GetModelAsync(InvocationContext context, CancellationToken cancellationToken) { var builder = new ODataConventionModelBuilder(); builder.EntityType<Person>(); return Task.FromResult(builder.GetEdmModel()); } } } }</code></pre></figure> <h3 id="configure-the-odata-endpoint">Configure the OData endpoint</h3> Replace the <code class="highlighter-rouge">WebApiConfig</code> class with the following code. No need to create a custom controller if users don’t have attribute routing. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">namespace Microsoft.OData.Service.Sample.TrippinInMemory { public static class WebApiConfig { public static void Register(HttpConfiguration config) { config.MapRestierRoute<TrippinApi>( "TrippinApi", "api/Trippin", new RestierBatchHandler(GlobalConfiguration.DefaultServer)).Wait(); } } }</code></pre></figure> </article> </li> </ul> <h1 class="post-title" id="4-Deep-in-RESTier">4. DEEP IN RESTIER</h1> <ul class="post-list"> <li> <h2 class="post-title" id="04-01-Infrastructure">4.1 RESTier infrastructure</h2> <article class="post-content"> <img src="/RESTier/images/04-01-01-RESTier Architecture.svg" alt="" /> Restier provides a connection between various data sources and existing clients. The framework contains 4 components: Core, Module, Provider and Publisher: <ul> <li>The core component provides functionalities for building up domain specific metadata, and logic for data CRUD processing flow. It also includes some extensible interfaces which allows pluggable modules.</li> <li>The module component provides the common service elements such as authorization, logging, and conventions that allow users to set up a service more quickly.</li> <li>The provider component includes data source adapters which provide functionalities for building up metadata and conduct data exchange with external data sources.</li> <li>The publisher component provides functionalities for exposing the domain specific data via a new service interface, which could be understand by existing clients.</li> </ul> </article> </li> <li> <h2 class="post-title" id="04-02-Api-Service">4.2 RESTier API Service</h2> <article class="post-content"> Users can inject their custom API services into RESTier to extend various functionalities. There is a big progress since 0.4.0. Now the concept of hook handler has become API service in 0.5.0. We have removed the old interfaces <code class="highlighter-rouge">IHookHandler</code> and <code class="highlighter-rouge">IDelegateHookHandler</code> to adapt to the concept change. Thus the implementation of any custom API service (previously known as hook handler) should also be changed accordingly. All API services registered as one specific type (either a class or an interface) are organized in a consistently chained (or nested) way. Each API service in a chain can choose whether to call the next (or inner) API service. The last API service registered is always invoked first if current service always call inner method first. As a practical example in RESTier, there is an API service interface called <code class="highlighter-rouge">IModelBuilder</code> to build or extend an EDM model. By default, RESTier will register two model builders for <code class="highlighter-rouge">IModelBuilder</code>. The model builder from the data provider (e.g., <code class="highlighter-rouge">ModelProducer</code> in RESTier EF) is always registered first. The <code class="highlighter-rouge">RestierModelExtender</code> is always registered later. Any custom model builder will be registered sequentially between or before or after the two built-in model builders based on the way been registered. When the API service <code class="highlighter-rouge">IModelBuilder</code> is invoked, the outermost <code class="highlighter-rouge">ModelBuilder</code> is always invoked first. It first invokes the inner API service which could possibly be the model builder from the data provider or some custom model builder (if any). The custom model builder can choose to extend the model returned from an inner builder, or otherwise it can simply choose not to call the inner one and directly return a new model. The model builder from the data provider is typically innermost and thus has no inner builder to call. This subsection shows how to implement custom API services and inject them into RESTier between two built-in model builders. For before or after, refer to <a href="http://odata.github.io/RESTier/v0.6/#02-05-Model-building-0-5-0">section 2.5 Model Building</a> part. This is common for all other services which allows customization. <h3 id="implement-an-api-service">Implement an API service</h3> The following sample code is to implement a custom model builder. Please note that if you want to call the inner builder, you need to put a settable property of <code class="highlighter-rouge">IModelBuilder</code> into your builder class. The accessibility and the name of the property doesn’t matter here. Then try to call the inner builder in the service implementation. If you don’t want to call any inner builder, you can just omit the property and remove the related logic. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class MyModelBuilder : IModelBuilder { // This is only needed if you want to call inner (or next) model builder logic in the way of chain public IModelBuilder InnerBuilder { get; set; } public async Task<IEdmModel> GetModelAsync(InvocationContext context, CancellationToken cancellationToken) { IEdmModel model = null; if (this.InnerBuilder != null) { // Call the inner builder to build a model first. model = await this.InnerBuilder.GetModelAsync(context, cancellationToken); } if (model != null) { // Do something to extend the model. } return model; } }</code></pre></figure> <h3 id="register-an-api-service">Register an API service</h3> We need to register <code class="highlighter-rouge">MyModelBuilder</code> into the API to make it work. You can override the <code class="highlighter-rouge">ConfigureApi</code> method in your API class to do so. Here is the sample code. There are also overloads for the two methods that take an existing service instance or a service factory method. By the way, all those methods are fluent API so you can call them in a chained way. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class MyApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiBase, IServiceCollection services) { // Add core and convention's services services = services.AddCoreServices(apiType) .AddAttributeServices(apiType) .AddConventionBasedServices(apiType); // Add EF related services which has ModelProducer services.AddEfProviderServices<NorthwindContext>(); // Add customized services, after EF model builder and before WebApi operation model builder services.AddService<IModelBuilder, MyModelBuilder>(); // This is used to add the publisher's services which has RestierModelExtender GetPublisherServiceCallback(apiType)(services); return services; } }</code></pre></figure> In the service implementation, the parameter type <code class="highlighter-rouge">IServiceCollection</code> is actually a container builder from Microsoft Dependency Injection Framework (DI). You can do whatever applicable to a normal DI container here. It is notable that you can also take advantage of the powerful scope feature in DI here! RESTier will create a new scope for each individual request in <code class="highlighter-rouge">ApiContext</code> which enables you to register scoped services whose lifetime is per-request. Please visit <a href="https://docs.asp.net/en/latest/fundamentals/dependency-injection.html">https://docs.asp.net/en/latest/fundamentals/dependency-injection.html</a> to grasp some basic understanding about DI before proceeding. The following example is to register a scoped <code class="highlighter-rouge">MyDbContext</code> service so that you have a new <code class="highlighter-rouge">MyDbContext</code> instance for each request. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class MyDbContext : DbContext {...} public class MyApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { return ApiBase.ConfigureApi(apiType, services) .AddScoped<MyDbContext>(sp => sp.GetService<T>()); } }</code></pre></figure> You can also make a specific API service singleton, scoped or transient (though not common) by calling <code class="highlighter-rouge">MakeSingleton</code>, <code class="highlighter-rouge">MakeScoped</code> or <code class="highlighter-rouge">MakeTransient</code>. Here is a sample which is to make <code class="highlighter-rouge">IModelBuilder</code> scoped. <figure class="highlight"><pre><code class="language-csharp" data-lang="csharp">public class MyApi : ApiBase { protected static new IServiceCollection ConfigureApi(Type apiType, IServiceCollection services) { // Previous registered logic ... services.MakeScoped<IModelBuilder>(); return services; } }</code></pre></figure> <h3 id="get-an-api-service">Get an API service</h3> No matter in which way you register an API service of <code class="highlighter-rouge">T</code>, the only and unified way to get that service out is to use <code class="highlighter-rouge">(ApiContext).GetApiService<T></code> from RESTier or <code class="highlighter-rouge">IServiceProvider.GetService<T></code> from DI. </article> </li> </ul> <h1 class="post-title" id="5-Clients">5. CLIENTS</h1> <ul class="post-list"> <li> <h2 class="post-title" id="05-01-Client">5.1 Clients</h2> <article class="post-content"> RESTier helps to build OData service which is RESTful services, so any REST client or http client can be used to send requests and receive responses. OData team develops a .Net Client which can work with any OData services, refer to <a href="http://odata.github.io/odata.net/#04-01-basic-crud-operations">“Basic CRUD Operations with OData .Net Client”</a> for details. OData team also develops two client tools to facilitate OData Client application development, refer to <a href="http://blogs.msdn.com/b/odatateam/archive/2014/03/12/how-to-use-odata-client-code-generator-to-generate-client-side-proxy-class.aspx">“Using OData Client Code Generator to generate client-side proxy class”</a> and <a href="http://odata.github.io/odata.net/#OData-Client-Code-Generation-Tool">“Using OData Connected Service to generate client-side proxy class”</a> for details. </article> </li> </ul> <h1 class="post-title" id="6-Announcements">6. ANNOUNCEMENTS</h1> <ul class="post-list"> <li> <h2 class="post-title" id="06-01-Preview-Announcement">6.1 Release notes for RESTier 0.2.0-preview</h2> <article class="post-content"> Below are the features supported in the RESTier 0.2.0-preview, as well as the limitations of the current version. <h3 id="easily-build-an-odata-v4-service">Easily build an OData V4 service</h3> Features directly supported Just create one <code class="highlighter-rouge">ODataDomainController<></code> and all of the features below are automatically enabled: <ul> <li>Basic queries for metadata and top level entities.</li> <li>System query options <code class="highlighter-rouge">$select</code>, <code class="highlighter-rouge">$expand</code>, <code class="highlighter-rouge">$filter</code>, <code class="highlighter-rouge">$orderby</code>, <code class="highlighter-rouge">$top</code>, <code class="highlighter-rouge">$skip</code>, and <code class="highlighter-rouge">$format</code>.</li> <li>Ability to request related entities.</li> <li>Create, Update and Delete top-level entities.</li> <li>Batch requests.</li> </ul> Leverage attribute routing to fall back to <a href="http://www.asp.net/web-api/overview/odata-support-in-aspnet-web-api/odata-v4/create-an-odata-v4-endpoint">Web API OData</a> for features not directly supported by RESTier <ul> <li>Request entity references with <code class="highlighter-rouge">$ref</code>.</li> <li>Create, Update and Delete entities not on the top-level.</li> <li>Modify relationships between entities.</li> <li>etc.</li> </ul> Use <code class="highlighter-rouge">EdmModelExtender</code> to support features currently not directly supported by RESTier. <ul> <li>OData functions.</li> <li>OData actions</li> </ul> <h3 id="rich-domain-logic">Rich domain logic</h3> <ul> <li> Role-based security You can easily set restrictions for different entity sets. For example, you can provide users with READ permission on some entity sets, and INSPECT (only provides access to $metadata) on others. </li> <li> Imperative views Customized entity sets which are not in the data model can be easily added. Currently, these entity sets are read-only, and do not support CUD (Create, Update, Delete) operations. </li> <li> Entity set filters With entity set filters, you can easily set filters before entity data is retrieved. For example, if you want users to only see part of Customers based on their UserID, you can use entity set filters to pre-filter the results. </li> <li> Submit logic With submit logic, you can add custom business logic that fires during or after a specific operation is performed on an entity set (e.g., <code class="highlighter-rouge">OnInsertedProducts</code>). </li> </ul> <h3 id="limitations">Limitations</h3> <ul> <li>Only supports OData V4.</li> <li>Only supports Entity Framework as data providers.</li> </ul> These are the two primary limitations currently, and we are looking at mitigating them in future releases. In the meanwhile, we’d like to hear your feedback and suggestions on how to improve RESTier. </article> </li> <li> <h2 class="post-title" id="06-02-RESTier-open-sourced">6.2 RESTier now open sourced on GitHub</h2> <article class="post-content"> The source code of RESTier now is open-souced on <a href="http://github.com/OData/RESTier">GitHub</a>, together with the test code and the <a href="https://github.com/OData/RESTier/tree/master/test/Microsoft.Restier.Samples.Northwind.Tests">Northwind Samples</a>. We have heard a lot of feedback of RESTier and record them directly on <a href="http://github.com/OData/RESTier/issues">GitHub Issues</a>, with the source code open now, developers can explore and play with RESTier more easily. And code contributions, bug reports are warmly welcomed. </article> </li> <li> <h2 class="post-title" id="06-03-0-3-0-beta-1">6.3 Release notes for RESTier 0.3.0-beta1</h2> <article class="post-content"> Features supported in 0.3.0-beta1 <ul> <li>Complex type support <a href="https://github.com/OData/RESTier/issues/96">#96</a></li> </ul> Improvements since 0.2.0-pre <ul> <li>Northwind service uses script to generate database instead of .mdf/.ldf files <a href="https://github.com/OData/RESTier/issues/77">#77</a></li> <li>Add StyleCop and FxCop to build process to ensure code quality</li> <li>TripPin service supports singleton</li> <li>Visual Studio 2015 and MSSQLLocalDB</li> <li>Use xUnit 2.0 as the test framework for RESTier <a href="https://github.com/OData/RESTier/issues/104">#104</a></li> </ul> </article> </li> <li> <h2 class="post-title" id="06-04-0-3-0-beta-2">6.4 Release notes for RESTier 0.3.0-beta2</h2> <article class="post-content"> Features supported in 0.3.0-beta2 <ul> <li>Support concrete classes that implement IDbSet<> <a href="https://github.com/OData/RESTier/issues/159">#159</a> by <a href="https://github.com/mkemal">mkemal</a></li> <li>Support Edm.Date <a href="https://github.com/OData/RESTier/issues/138">#138</a>, <a href="http://odata.github.io/RESTier/#03-04-Date">Tutorial</a></li> </ul> Bug-fixes since 0.3.0-beta1 <ul> <li>Fix incorrect status code <a href="https://github.com/OData/RESTier/issues/115">#115</a></li> <li>Computed annotation should not be added for Identity property <a href="https://github.com/OData/RESTier/issues/116">#116</a></li> </ul> Improvements since 0.3.0-beta1 <ul> <li>Automatically start TripPin service when running E2E cases <a href="https://github.com/OData/RESTier/issues/146">#146</a></li> <li>No need to change machine configuration for running tests under Release mode</li> </ul> </article> </li> <li> <h2 class="post-title" id="06-05-0-4-0-rc">6.5 Release notes for RESTier 0.4.0-rc</h2> <article class="post-content"> Features supported in 0.4.0-rc <ul> <li>Unified hook handler mechanism for users to inject hooks, <a href="http://odata.github.io/RESTier/#04-04-Hook-Handler">Tutorial</a></li> <li>Built-in <code class="highlighter-rouge">RestierController</code> now handles most CRUD scenarios for users including entity set access, singleton access, entity access, property access with $count/$value, $count query option support. <a href="https://github.com/OData/RESTier/issues/136">#136</a>, <a href="https://github.com/OData/RESTier/issues/193">#193</a>, <a href="https://github.com/OData/RESTier/issues/234">#234</a>, <a href="http://odata.github.io/RESTier/#03-05-Controllers">Tutorial</a></li> <li>Support building entity set, singleton and operation from <code class="highlighter-rouge">Api</code> (previously <code class="highlighter-rouge">Domain</code>). Support navigation property binding. Now users can save much time writing code to build model. <a href="https://github.com/OData/RESTier/issues/207">#207</a>, <a href="http://odata.github.io/RESTier/#02-06-Model-building">Tutorial</a></li> <li>Support in-memory data source provider <a href="https://github.com/OData/RESTier/issues/189">#189</a></li> </ul> Bug-fixes since 0.3.0-beta2 <ul> <li>Fix IISExpress instance startup issue in E2E tests <a href="https://github.com/OData/RESTier/issues/145">#145</a>, <a href="https://github.com/OData/RESTier/issues/241">#241</a></li> <li>Should return 400 if there is any invalid query option <a href="https://github.com/OData/RESTier/issues/176">#176</a></li> <li>EF7 project bug fixes <a href="https://github.com/OData/RESTier/issues/253">#253</a>, <a href="https://github.com/OData/RESTier/issues/254">#254</a></li> </ul> Improvements since 0.3.0-beta2 <ul> <li>Thorough API cleanup, code refactor and concept reduction <a href="https://github.com/OData/RESTier/issues/164">#164</a></li> <li>The Conventions project was merged into the Core project. Conventions are now enabled by default. The <code class="highlighter-rouge">OnModelExtending</code> convention was removed due to inconsistency. <a href="https://github.com/OData/RESTier/issues/191">#191</a></li> <li>Add a sample service with an in-memory provider <a href="https://github.com/OData/RESTier/issues/189">#189</a></li> <li>Unified exception-handling process <a href="https://github.com/OData/RESTier/issues/24">#24</a>, <a href="https://github.com/OData/RESTier/issues/26">#26</a></li> <li>Simplified <code class="highlighter-rouge">MapRestierRoute</code> now takes an <code class="highlighter-rouge">Api</code> class instead of a controller class. No custom controller required in simple cases.</li> <li>Update project URL in RESTier NuGet packages.</li> </ul> </article> </li> <li> <h2 class="post-title" id="06-06-0-4-0-rc2">6.6 Release notes for RESTier 0.4.0-rc2</h2> <article class="post-content"> Bug-fixes since 0.4.0-rc <ul> <li>Support string as return type or argument of functions <a href="https://github.com/OData/RESTier/issues/258">#258</a></li> </ul> </article> </li> <li> <h2 class="post-title" id="06-07-0-5-0-beta">6.7 Release notes for RESTier 0.5.0-beta</h2> <article class="post-content"> New features since 0.4.0-rc2 <ul> <li>[<a href="https://github.com/OData/RESTier/issues/150">Issue #150</a>] [PR <a href="https://github.com/OData/RESTier/pull/286">#286</a>] Integrate Microsoft Dependency Injection Framework into RESTier. <a href="http://odata.github.io/RESTier/#04-04-Api-Service">Tutorial</a>.</li> <li>[<a href="https://github.com/OData/RESTier/issues/273">Issue #273</a>] [PR <a href="https://github.com/OData/RESTier/pull/278">#278</a>] Support temporal types in Restier.EF. <a href="http://odata.github.io/RESTier/#03-07-Temporal">Tutorial</a>.</li> <li>[<a href="https://github.com/OData/RESTier/issues/383">Issue #383</a>] [PR <a href="https://github.com/OData/RESTier/pull/402">#402</a>] Adopt Web OData Conversion Model builder as default EF provider model builder. <a href="http://odata.github.io/WebApi/#02-04-convention-model-builder">Tutorial</a>.</li> <li>[<a href="https://github.com/OData/RESTier/issues/360">Issue #360</a>] [PR <a href="https://github.com/OData/RESTier/pull/399">#399</a>] Support $apply in RESTier. <a href="http://docs.oasis-open.org/odata/odata-data-aggregation-ext/v4.0/odata-data-aggregation-ext-v4.0.html">Tutorial</a>.</li> <li> Bug-fixes since 0.4.0-rc2 </li> <li>[<a href="https://github.com/OData/RESTier/issues/123">Issue #123</a>] [PR <a href="https://github.com/OData/RESTier/pull/294">#294</a>] Fix a bug that prevents using <code class="highlighter-rouge">Edm.Int64</code> as entity key.</li> <li>[<a href="https://github.com/OData/RESTier/issues/269">Issue #269</a>] [PR <a href="https://github.com/OData/RESTier/pull/271">#271</a>] Fix a bug that <code class="highlighter-rouge">NullReferenceException</code> is thrown when POST/PATCH/PUT with null property values.</li> <li>[<a href="https://github.com/OData/RESTier/issues/287">Issue #287</a>] [PR <a href="https://github.com/OData/RESTier/pull/314">#314</a>] Fix a bug that $count does not work correctly when there is $expand.</li> <li>[<a href="https://github.com/OData/RESTier/issues/304">Issue #304</a>] [PR <a href="https://github.com/OData/RESTier/pull/306">#306</a>] Fix a bug that <code class="highlighter-rouge">GetModelAsync</code> is not thread-safe.</li> <li>[<a href="https://github.com/OData/RESTier/issues/304">Issue #304</a>] [PR <a href="https://github.com/OData/RESTier/pull/322">#322</a>] Fix a bug that if <code class="highlighter-rouge">GetModelAsync</code> takes too long to complete, any subsequent request will fail.</li> <li>[<a href="https://github.com/OData/RESTier/issues/308">Issue #308</a>] [PR <a href="https://github.com/OData/RESTier/pull/313">#313</a>] Fix a bug that <code class="highlighter-rouge">NullReferenceException</code> is thrown when <code class="highlighter-rouge">ColumnTypeAttribute</code> does not have a <code class="highlighter-rouge">TypeName</code> property specified.</li> <li>[<a href="https://github.com/OData/RESTier/issues/309">Issue #309</a>][<a href="https://github.com/OData/RESTier/issues/310">Issue #310</a>][<a href="https://github.com/OData/RESTier/issues/311">Issue #311</a>][<a href="https://github.com/OData/RESTier/issues/312">Issue #312</a>] [PR <a href="https://github.com/OData/RESTier/pull/313">#313</a>] Fix various bugs in the RESTier query pipeline.</li> </ul> API changes since 0.4.0-rc2 <ul> <li>The concept of hook handler now becomes API service after DI integration.</li> <li>The interface <code class="highlighter-rouge">IHookHandler</code> and <code class="highlighter-rouge">IDelegateHookHandler</code> are removed. The implementation of any custom API service (previously known as hook handler) should also change accordingly. But this should not be big change. Please see <a href="http://odata.github.io/RESTier/#04-04-Api-Service">Tutorial</a> for details.</li> <li><code class="highlighter-rouge">AddHookHandler</code> is now replaced with <code class="highlighter-rouge">AddService</code> from DI. Please see <a href="http://odata.github.io/RESTier/#04-04-Api-Service">Tutorial</a> for details.</li> <li><code class="highlighter-rouge">GetHookHandler</code> is now replaced with <code class="highlighter-rouge">GetApiService</code> and <code class="highlighter-rouge">GetService</code> from DI. Please see <a href="http://odata.github.io/RESTier/#04-04-Api-Service">Tutorial</a> for details.</li> <li>All the serializers and <code class="highlighter-rouge">DefaultRestierSerializerProvider</code> are now public. But we still need to address <a href="https://github.com/OData/RESTier/issues/301">#301</a> to allow users to override the serializers.</li> <li>The interface <code class="highlighter-rouge">IApi</code> is now removed. Use <code class="highlighter-rouge">ApiBase</code> instead. We never expect users to directly implement their API classes from <code class="highlighter-rouge">IApi</code> anyway. The <code class="highlighter-rouge">Context</code> property in <code class="highlighter-rouge">IApi</code> now becomes a public property in <code class="highlighter-rouge">ApiBase</code>.</li> <li>Previously the <code class="highlighter-rouge">ApiData</code> class is very confusing. Now we have given it a more meaningful name <code class="highlighter-rouge">DataSourceStubs</code> which accurately describes the usage. Along with this change, we also rename <code class="highlighter-rouge">ApiDataReference</code> to <code class="highlighter-rouge">DataSourceStubReference</code> accordingly.</li> <li><code class="highlighter-rouge">ApiBase.ApiConfiguration</code> is renamed to <code class="highlighter-rouge">ApiBase.Configuration</code> to keep consistent with <code class="highlighter-rouge">ApiBase.Context</code>.</li> <li>The static <code class="highlighter-rouge">Api</code> class is now separated into two classes <code class="highlighter-rouge">ApiBaseExtensions</code> and <code class="highlighter-rouge">ApiContextExtensions</code> to eliminate the ambiguity regarding the previous <code class="highlighter-rouge">Api</code> class.</li> </ul> </article> </li> <li> <h2 class="post-title" id="06-08-0-6-0">6.8 Release notes for RESTier 0.6.0</h2> <article class="post-content"> New features since 0.5.0-beta <ul> <li>[<a href="https://github.com/OData/RESTier/issues/117">Issue #117</a>] [PR <a href="https://github.com/OData/RESTier/pull/410">#410</a>] Entity Type inheritance support.</li> <li>[<a href="https://github.com/OData/RESTier/issues/378">Issue #378</a>] [PR <a href="https://github.com/OData/RESTier/pull/424">#424</a>] Support operation without additional controller.</li> <li>[<a href="https://github.com/OData/RESTier/issues/460">Issue #460</a>] [PR <a href="https://github.com/OData/RESTier/pull/461">#461</a>] Imprative view support with entity type which is not defined in EF.</li> <li>[<a href="https://github.com/OData/RESTier/issues/443">Issue #443</a>] [PR <a href="https://github.com/OData/RESTier/pull/448">#448</a>] Support method bound to non-entity type.</li> <li>[<a href="https://github.com/OData/RESTier/issues/414">Issue #414</a>] [PR <a href="https://github.com/OData/RESTier/pull/422">#422</a>] Support backslash and slash in key value.</li> <li>[<a href="https://github.com/OData/RESTier/issues/22">Issue #22</a>] [PR <a href="https://github.com/OData/RESTier/pull/458">#458</a>] Add ETag support in RESTier.</li> <li>[<a href="https://github.com/OData/RESTier/issues/479">Issue #479</a>] [PR <a href="https://github.com/OData/RESTier/pull/484">#484</a>] Add Immutable and Computed Annotation support. </li> </ul> Bug-fixes since 0.5.0-beta <ul> <li>[<a href="https://github.com/OData/RESTier/issues/432">Issue #432</a>] [PR <a href="https://github.com/OData/RESTier/pull/452">#452</a>] More meaningful exception message during model build.</li> <li>[<a href="https://github.com/OData/RESTier/issues/438">Issue #438</a>] [PR <a href="https://github.com/OData/RESTier/pull/448">#448</a>] Make namespace consistent for entity type / operation / container in model.</li> <li>[<a href="https://github.com/OData/RESTier/issues/413">Issue #413</a>] [PR <a href="https://github.com/OData/RESTier/pull/454">#454</a>] Auto pop entity type key from entity framework during model builder.</li> <li>[<a href="https://github.com/OData/RESTier/issues/426">Issue #426</a>] [PR <a href="https://github.com/OData/RESTier/pull/424">#424</a>] Support method return nullable enum.</li> <li>[<a href="https://github.com/OData/RESTier/issues/459">Issue #459</a>] [PR <a href="https://github.com/OData/RESTier/pull/458">#458</a>] Return 404 if single entity for bound operation does not exist.</li> <li>[<a href="https://github.com/OData/RESTier/issues/459">Issue #288</a>] [PR <a href="https://github.com/OData/RESTier/pull/465">#465</a>] Return 204 if single navigation property is null.</li> <li>[<a href="https://github.com/OData/RESTier/issues/459">Issue #328</a>] [PR <a href="https://github.com/OData/RESTier/pull/465">#465</a>] Return 404 when request property of non-exist entity or complex.</li> <li>[PR <a href="https://github.com/OData/RESTier/pull/455">#455</a>] Improve RESTier routing which only fail to entity set controller if there is an action for the request.</li> </ul> </article> </li> <li> <h2 class="post-title" id="06-09-1-0-0">6.9 Release notes for RESTier 1.0.0</h2> <article class="post-content"> This is the first GA release of RESTier, it is based on newest <a href="http://odata.github.io/odata.net/v7/">odata .net library 7.x</a> and newest <a href="http://odata.github.io/WebApi/">Web API OData library 6.x</a>. Now it is more flexibility for user to define the behavior, and lots more customization capability as both ODL and WAO have adopted Dependency Injection. All the service registered in DI container by ODL and WAO can be customized. Refer to ODL and WAO documents for more detail. Three breaking changes impacts any consumer who implements its own API are, <ol> <li> Must create a constructor which accept a IServiceProvider, the IServiceProvider will be set automatically when Api instance is retrieved from DI container. </li> <li> ConfigureApi method is static and has one additional parameter “Type apiType”, and in this method, it must call ApiBase or EntityFrameworkApi<T> ConfigureApi method to have Api registered as DI service.</T> </li> <li> Starting 1.0 release, there are more smaller granularity control on the properties which can be used in query option, and all properties are disabled to be used by default. User can add configured in CLR class or during model build to configure which properties are allowed to be used in filter/expand/select/orderby/count. Refer to <a href="http://odata.github.io/WebApi/#13-01-modelbound-attribute">Model bound</a> document for more details. User can also use configuration “config.Filter().Expand().Select().OrderBy().MaxTop(null).Count();” to enable filter/expand/select/orderby/count on all properties. </li> </ol> New features since 0.6.0 <ul> <li>Add resource attribute for the properties in Api class <ul> <li>Now for the properties in API class, it must have Resource attribute to be built as entity set or singleton.</li> </ul> </li> <li>Make URI resolver as DI service. <ul> <li>URL resolver will need to be registered as DI service which was set via config before.</li> </ul> </li> <li>Move ApiBase as DI service and remove ApiContext. <ul> <li>ApiBase is DI service now and one instance is created for each request. Remove ApiContext to make logic clear.</li> </ul> </li> <li>Make ApiConfiguration as internal service. <ul> <li>ApiConfiguration is moved as internal service now, if additional static configuration is needed for Api class, a DI singleton service is recommeded.</li> </ul> </li> <li>Use WepApi OData formatting attribute and remove RESTier formatting attribute.</li> <li>Add support of untyped property</li> </ul> Bug-fixes since 0.6.0 <ul> <li>[<a href="https://github.com/OData/RESTier/issues/491">Issue #491</a>] [PR <a href="https://github.com/OData/RESTier/pull/495">#495</a>] Support property with type of byte array as concurrency check properties.</li> <li>[<a href="https://github.com/OData/RESTier/issues/488">Issue #488</a>] [PR <a href="https://github.com/OData/RESTier/pull/498">#498</a>] Support DataTime whose kind is local.</li> <li>[<a href="https://github.com/OData/RESTier/issues/505">Issue #505</a>] [PR <a href="https://github.com/OData/RESTier/pull/507">#507</a>] PATCH semantics against complex types is incorrect.</li> </ul> </article> </li> </ul> <h1 class="post-title" id="7-Tooling">7. TOOLING</h1> <ul class="post-list"> <li> <h2 class="post-title" id="07-01-Restier-Scaffolding">7.1 Restier Scaffolding</h2> <article class="post-content"> <h3 id="introduction">Introduction</h3> This tool is used to modify the config class to simplifies the process of building the OData service with EF by Restier(>=0.4.0-rc) in visual studio. The scaffolding item will appear in the scaffolding list by right click on any folder in project and select “Add” -> “New Scaffolded Item” <h3 id="install-visual-studio-extension-of-scaffolding">Install Visual Studio Extension of Scaffolding</h3> The installer of Restier scaffolding can be downloaded from Visual Studio Gallery: <a href="https://visualstudiogallery.msdn.microsoft.com/6b18599d-34d5-4123-a586-cdf411728d23/">Restier Scaffolding</a>. Double click vsix to install, the extension supports the VS2013 and VS2015, now. <h3 id="using-scaffolding-tool">Using Scaffolding Tool</h3> <a href="http://odata.github.io/RESTier/#01-04-Bootstrap">Here</a> is the process of building an OData V4 endpoint using RESTier. With scaffolding tool, you only need to “Create a project and a web app”, then “Generate the model classes”. The project will looks like: <img src="/RESTier/images/ScaffoldingBefore.PNG" alt="" /> <ol> <li>Right click the APP_Start folder->Add->New Scaffolded items</li> <li>Select “Microsoft OData Restier Config” under Common\Web API node</li> <li>Select the “Data context class” needed and “WebApi config class” which will be modified to add the code as following: <img src="/RESTier/images/Scaffolding.PNG" alt="" /></li> <li>Click “Change”. Scaffolding tool will add the code in “WebApiConfig.cs”. And add Restier assembly as reference</li> <li>Reopen the “WebApiConfig.cs” to view the code added: <img src="/RESTier/images/ScaffoldingAfter.PNG" alt="" /></li> <li>Rebuld the project and start: <img src="/RESTier/images/ScaffoldingResult.PNG" alt="" /></li> </ol> Notice: The alpha version of tool may contain an issue: during the step 5 and 6, visual studio may need to be restarted. </article> </li> </ul> <h1 class="post-title" id="8-Others">8. OTHERS</h1> <ul class="post-list"> <li> <h2 class="post-title" id="08-01-Sample-Services">8.1 Sample Services</h2> <article class="post-content"> Refer to <a href="https://github.com/OData/ODataSamples/tree/master/RESTier">sample service github</a> for end to end sample service. The source code also contains end to end service for end to end test purpose. All the sample services can be run with visual studio 2015. </article> </li> <li> <h2 class="post-title" id="08-02-Debug">8.2 How to Debug</h2> <article class="post-content"> If you want to debug OData Lib, WebAPI, Restier source, open <code class="highlighter-rouge">DEBUG</code> -> <code class="highlighter-rouge">Options and Settings</code> in VS, configure below things in <code class="highlighter-rouge">General</code> tab: <ol> <li>Uncheck <code class="highlighter-rouge">Enable Just My Code (Managed only)</code>.</li> <li>Uncheck <code class="highlighter-rouge">Enable .NET Framework source stepping</code>.</li> <li>UnCheck <code class="highlighter-rouge">Require source files to exactly match the original version</code>.</li> <li>Check <code class="highlighter-rouge">Enable source server support</code>.</li> </ol> Setup your symbol source in <code class="highlighter-rouge">Symbols</code> tab: <ol> <li>Check <code class="highlighter-rouge">Microsoft Symbol Servers</code>.</li> <li>Add location: http://srv.symbolsource.org/pdb/Public (For preview/public releases in nuget.org).</li> <li>Add location: http://srv.symbolsource.org/pdb/MyGet (For nightly build, and preview releases in myget.org).</li> <li>Set the cache symbols directory in your, the path should be as short as it can be.</li> </ol> Turn on the CLR first change exception to do a quick debug, open <code class="highlighter-rouge">DEBUG</code> -> <code class="highlighter-rouge">Exceptions</code> in VS, check the <code class="highlighter-rouge">Common Language Runtime Exceptions</code>. RESTier also exposes a configuration which will return the whole exception stack trace if there is any exception thrown on the server side for the request, it is disabled by default, it can be enabled via call “config.SetUseVerboseErrors(true);” during routes register. </article> </li> </ul> <h1 class="post-title" id="9-Thank-You!">9. THANK YOU!</h1> <ul class="post-list"> <li> <h2 class="post-title" id="09-01-Thank-You">9.1 Vendors</h2> <article class="post-content"> We’re using NDepend to analyze and increase code quality. <a href="http://www.ndepend.com"><img src="/RESTier/images/ndependlogo.png" alt="NDepend" /></a> </article> </li> </ul> </div> <div class="col-md-3"> </div> </div> </div> </div> </div> <footer class="site-footer"> <div class="container"> <script> (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){ (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o), m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m) })(window,document,'script','//www.google-analytics.com/analytics.js','ga'); ga('create', 'UA-55977038-3', 'auto'); ga('send', 'pageview'); </script> <h2 class="footer-heading">RESTier</h2> <div class="footer-col-wrapper"> <div class="footer-col footer-col-1"> <ul class="contact-list"> <li>RESTier</li> <li><a href="mailto:odatafeedback@microsoft.com">odatafeedback@microsoft.com</a></li> </ul> </div> <div class="footer-col footer-col-2"> <ul class="social-media-list"> <li> <a href="https://github.com/odata"> <svg viewBox="0 0 16 16"> <path fill="#828282" d="M7.999,0.431c-4.285,0-7.76,3.474-7.76,7.761 c0,3.428,2.223,6.337,5.307,7.363c0.388,0.071,0.53-0.168,0.53-0.374c0-0.184-0.007-0.672-0.01-1.32 c-2.159,0.469-2.614-1.04-2.614-1.04c-0.353-0.896-0.862-1.135-0.862-1.135c-0.705-0.481,0.053-0.472,0.053-0.472 c0.779,0.055,1.189,0.8,1.189,0.8c0.692,1.186,1.816,0.843,2.258,0.645c0.071-0.502,0.271-0.843,0.493-1.037 C4.86,11.425,3.049,10.76,3.049,7.786c0-0.847,0.302-1.54,0.799-2.082C3.768,5.507,3.501,4.718,3.924,3.65 c0,0,0.652-0.209,2.134,0.796C6.677,4.273,7.34,4.187,8,4.184c0.659,0.003,1.323,0.089,1.943,0.261 c1.482-1.004,2.132-0.796,2.132-0.796c0.423,1.068,0.157,1.857,0.077,2.054c0.497,0.542,0.798,1.235,0.798,2.082 c0,2.981-1.814,3.637-3.543,3.829c0.279,0.24,0.527,0.713,0.527,1.437c0,1.037-0.01,1.874-0.01,2.129 c0,0.208,0.14,0.449,0.534,0.373c3.081-1.028,5.302-3.935,5.302-7.362C15.76,3.906,12.285,0.431,7.999,0.431z"/> </svg> odata </a> </li> </ul> </div> <div class="footer-col footer-col-3"> Documentation - tutorials, guides - for RESTier. The materials available on this site are licensed as set forth <a href="https://github.com/OData/odata.github.io/blob/master/License.txt">here</a>. </div> </div> </div> </footer> </body> </html>

CINXE.COM

RESTier