{"id":3766,"date":"2020-03-06T11:08:29","date_gmt":"2020-03-06T18:08:29","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/odata\/?p=3766"},"modified":"2020-03-09T00:27:21","modified_gmt":"2020-03-09T07:27:21","slug":"odata-connected-service-0-4-0-release","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/odata\/odata-connected-service-0-4-0-release\/","title":{"rendered":"OData Connected Service 0.4.0 Release"},"content":{"rendered":"

OData Connected Service 0.4.0 has been released and is now available on the Visual Studio Marketplace<\/a>.<\/span><\/p>\n

T<\/span>he new version adds the following features:<\/span><\/p>\n

    \n
  1. Support for Visual Studio 2019 (in addition to Visual Studio 2017)<\/li>\n
  2. Option to generate types as internal so that they are not accessible outside the assembly<\/li>\n
  3. Bug fixes<\/li>\n<\/ol>\n

    In this article, I would like to take you through some key new features and get you up to speed with using the OData Connected Service.<\/p>\n

    OData Connected Service in Visual Studio 2019<\/span><\/span><\/h2>\n

    We start by illustrating how you can use the extension in Visual Studio 2019. Open Visual Studio 2019 and create a new C# <\/span>.Net<\/span>\u00a0Core Console project.<\/span> Let\u2019s call the project “<\/span>SampleClient”<\/span>, and the solution “<\/span>OCSTest”<\/span>.<\/span>\u00a0<\/span>Once the project is open, click the Extensions menu, then\u00a0<\/span>Manage Extensions. In the Manage Extensions window, search for \u201cOData Connected Service\u201d<\/span>. Select the extension and install it.<\/span>\u00a0You may need to close Visual Studio to allow the extension to install, then restart it after installation\u00a0<\/span>completes.<\/span><\/p>\n

    \"Image<\/p>\n

    Alternatively, you can just download the VSIX from the marketplace<\/a> and double click to install.<\/p>\n

    Once the extension has been installed. Right-click your project in the solution explorer, then in the context menu select Add<\/strong> > Connected Service<\/strong>. This will open the Connected Services<\/strong> window where you can select which services to add to your project. Select OData Connected Service<\/strong>.<\/p>\n

    \"Image\"Image<\/p>\n

    Next, a configuration wizard will open where you can configure how code will be generated for your service.<\/p>\n

    On the first page, we\u2019ll add the metadata URL of the service we want to access. For this example, we will use the sample Trip Pin Service. Set the service name to \u201cTripPin Service\u201d and the Address to \u00a0https:\/\/services.odata.org\/TripPinRESTierService\/$metadata<\/p>\n

    Then click Finish<\/strong>.<\/p>\n

    \"Image<\/p>\n

    After the process completes, the OData docs website will be launched. Go back to Visual Studio and you will see a connected service added to your project and a Reference.cs<\/strong> file that \u00a0contains all the code generated from the OData code generator.<\/p>\n

    \"Image<\/p>\n

    Let’s proceed to use the generate classes to interact with the service. Replace the code in Program.cs<\/strong> with the following:<\/p>\n

    using System; \r\nusing System.Threading.Tasks;\r\nusing Microsoft.OData.Service.Sample.TrippinInMemory.Models;\r\n\r\nclass Program\r\n{\r\n    static string serviceUri = \"https:\/\/services.odata.org\/TripPinRESTierService\/\";\r\n    static Container context = new Container(new Uri(serviceUri));\r\n    static void Main()\r\n    {\r\n        \/\/ from C# 7.1 You can use async Main instead\r\n        ShowPeople().Wait();\r\n    }\r\n\r\n    static async Task ShowPeople()\r\n    {\r\n        var people = await context.People.ExecuteAsync();\r\n        foreach (var person in people)\r\n        {\r\n            Console.WriteLine(person.FirstName);\r\n        }\r\n    }\r\n}<\/pre>\n
    The above program fetches people data from the Trip Pin service and then displays their names. If you run the program, it should display a list of names.<\/p>\n
    \"Image<\/p>\n
    To learn more about using the generated client to interact with an OData service, visit this guide<\/a>.<\/p>\n
    Generating types as internal<\/h2>\n
    This feature allows you to mark generated types as internal instead of public, so that they are not accessible outside your assembly. This helps avoid conflicts if you’re referencing different projects that use the same classes generated by OData Connected Service from the same service endpoint.<\/p>\n
    To illustrate this,\u00a0 add a library project to our OCSTest solution. Right-click the solution and click Add<\/strong> > New Project<\/strong>. Create a C# .Net Standard Class Library project and call it SampleLib. This library will expose a simple method that makes use of the same Trip Pin service we used earlier.<\/p>\n
    Follow the same steps as in the previous section to add an OData Connected Service to this project using the same Trip Pin service metadata endpoint.<\/p>\n
    Next,\u00a0 add a public class to our library project that will contain the method we want to expose to consumers of the library. Name the file LibService.cs <\/strong>\u00a0and add the following code to the file:<\/p>\n
    using System;\r\nusing System.Threading.Tasks;\r\nusing Microsoft.OData.Service.Sample.TrippinInMemory.Models;\r\n\r\nnamespace SampleLib\r\n{\r\n    public static class LibService\r\n    {\r\n        private static string serviceUri = \"https:\/\/services.odata.org\/TripPinRESTierService\/\";\r\n        private static Container context = new Container(new Uri(serviceUri));\r\n\r\n        public static async Task<string> GetMostPopularPerson()\r\n        {\r\n            var person = await context.GetPersonWithMostFriends().GetValueAsync();\r\n            return $\"{person.FirstName} {person.LastName}\";\r\n        }\r\n    }\r\n}<\/pre>\n
    The GetMostPopularPerson()<\/code> method simply fetches the person with the most friends from the service and returns that person\u2019s full name.<\/p>\n
    Let\u2019s add a reference to SampleLib in our initial console applicaton so that we can use it. Right click the SampleClient project > Add<\/strong> > Reference<\/strong> > Projects<\/strong> > Solution<\/strong> > SampleLib<\/strong> then press OK<\/strong>.<\/p>\n
    \"Image<\/p>\n
    At this point, we can call the method from our SampleLib library in the Main method of the SampleClient console app, by adding the following line at the end of the Main method. The Main method should now look like:<\/p>\n
    static void Main()\r\n{\r\n    \/\/ from C# 7.1 You can use async Main instead\r\n    ShowPeople().Wait();\r\n    Console.WriteLine(\"Most popular: {0}\", SampleLib.LibService.GetMostPopularPerson().Result);\r\n}<\/pre>\n
    If you try to run this application, you will get compiler warnings on the Container class, because both the console app and library define classes with the same names in the same namespace. The console app has access to all the proxy classes of the library because they are public. But this is not what we want, we only want to expose the LibService.GetMostPopularPerson()<\/code> method from the service, the proxy classes should not be accessible outside the library.<\/p>\n
    To correct this issue, go to the SampleLib project in the solution explorer, under the Connected Services node, you will see a folder for the connected service you added, which is TripPin Service<\/strong>\u00a0in our example. Right click the folder and select Update Connected Service<\/strong>.<\/p>\n
    \"Image<\/p>\n
    This will open up the OData Connected Wizard and allow you to update the configuration. On the Endpoint page click Next<\/strong> to navigate to the Settings page, then click the AdvancedSettings<\/strong> link to reveal more options. Check the Mark generated types as internal<\/strong> checkbox and click Finish<\/strong>.<\/p>\n
    \"Image<\/p>\n
    When asked whether to replace the existing Reference.cs file, click Yes. After the code generation is complete, you can open the generated Reference.cs file and confirm that all top-level classes and enums have an internal<\/code>\u00a0access modifier.<\/p>\n
    \"Image<\/p>\n
    Finally, build and run the SampleClient project, you will not see the warnings again. The program will display the name of the person with most friends at the end.<\/p>\n
    \"Image<\/p>\n
    Minor updates and bug fixes<\/h2>\n
    The ByKey<\/code> method now accepts an IDictionary<\/code> as a parameter as opposed to the concrete Dictionary class that it allowed before. This allows you to pass your own implementation of IDictionary<\/code> instead of the standard Dictionary when you need to.<\/p>\n
    In addition, references to EdmxReader<\/code> have been replaced with Microsoft.OData.Edm.Csdl.CsdlReader<\/a>. This fixes some of the compilation errors that occurred in the generated code in the previous version.<\/p>\n
     <\/p>\n
    There are more features and fixes coming to OData Connected Service soon, so stay tuned for upcoming releases.<\/p>\n","protected":false},"excerpt":{"rendered":"
    OData Connected Service 0.4.0 has been released and is now available on the Visual Studio Marketplace. The new version adds the following features: Support for Visual Studio 2019 (in addition to Visual Studio 2017) Option to generate types as internal so that they are not accessible outside the assembly Bug fixes In this article, I […]<\/p>\n","protected":false},"author":20326,"featured_media":3253,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[118,1],"tags":[],"class_list":["post-3766","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-clientcodegen","category-odata"],"acf":[],"blog_post_summary":"
    OData Connected Service 0.4.0 has been released and is now available on the Visual Studio Marketplace. The new version adds the following features: Support for Visual Studio 2019 (in addition to Visual Studio 2017) Option to generate types as internal so that they are not accessible outside the assembly Bug fixes In this article, I […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts\/3766","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/users\/20326"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/comments?post=3766"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/posts\/3766\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/media\/3253"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/media?parent=3766"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/categories?post=3766"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/odata\/wp-json\/wp\/v2\/tags?post=3766"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}