- Extension ID
- What's new?
- Description
- In what situation should you install this extension?
- Support
- Function Point, Quality and Sizing support
- AIP Core compatibility
- Prerequisites
- What source code is needed by our analyzer?
- Dependencies with other extensions
- Download and installation instructions
- What results can you expect?
- Limitations
Extension ID
com.castsoftware.dotnet.odata
What's new?
See OData Client for .NET - 1.0 - Release Notes.
Description
This extension provides support for OData client libraries when used inside .NET source code.
In what situation should you install this extension?
If your .NET application source code uses the odata client libraries to consume OData services, you should install this extension.
Support
Libraries supported
| Library Name | Library Version(s) | OData Version(s) |
|---|---|---|
| Microsoft.OData.Client | Upto 7.17 | v4 |
| Microsoft.Data.Services.Client | Upto 5.8 | v1-v3 |
| Simple.OData.Client | Upto 6.0 | v1-v4 |
APIs supported
| Click a category to expand |
|---|
Function Point, Quality and Sizing support
Function Points | Quality and Sizing |
|---|---|
 | |
AIP Core release | Supported |
|---|---|
| 8.3.x |  |
Prerequisites
| An installation of any compatible release of AIP Core (see table above) |
What source code is needed by our analyzer?
For applications using Microsoft libraries, the OData extension requires the client proxy file, service reference file (.xml, .edmx etc.) generated by the code generation tool to function correctly.
Dependencies with other extensions
Some CAST extensions require the presence of other CAST extensions in order to function correctly. The OData extension requires the following CAST extensions to be installed:
- Universal Linker
- com.castsoftware.internal.platform (Internal Extension)
- Any dependent extensions are automatically downloaded and installed. You do not need to do anything.
- The .NET Analyzer is not a dependency, but this extension will be automatically installed when .NET source code is delivered for analysis.
Download and installation instructions
For .NET applications using OData client libraries, the extension will be automatically installed by CAST Console. This is in place since October 2023.
For upgrade, if the Extension Strategy is not set to Auto update, you can manually install the extension using the Application - Extensions interface.
What results can you expect?
Objects
The following objects are displayed in CAST Enlighten:
Icon | Description |
|---|---|
| OData Client HttpRequest Get Service |
| OData Client HttpRequest Post Service |
| OData Client HttpRequest Put Service |
| OData Client HttpRequest Patch Service |
| OData Client HttpRequest Delete Service |
Links
| Link Type | Source and Destination |
|---|---|
| callLink | Link from C# method making API call to service object (eg. OData Client HttpRequest Get Service) |
Examples
Insert Operation
using System;
using System.Diagnostics;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using System.Data.Services.Client;
using WpfApplication1.ServiceReference1;
namespace WpfApplication1
{
public partial class Window1 : Window
{
public Window1()
{
InitializeComponent();
}
private void Window1_Loaded(object sender, RoutedEventArgs e)
{
try
{
var svcUri = "http://localhost:52027/WcfDataService1.svc";
var context = new castEntities(new Uri(svcUri));
WpfApplication1.ServiceReference1.Table newProduct = WpfApplication1.ServiceReference1.Table.CreateTable(4);
newProduct.Name = "Rian";
context.AddObject("Tables", newProduct);
context.SaveChanges();
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
}
private void buttonClose_Click(object sender, RoutedEventArgs e)
{
this.Close();
}
}
}
Select Operation
using System;
using System.Collections.Generic;
using System.Threading.Tasks;
using WebApplication2.Models;
namespace odata_client_new
{
class Program
{
static void Main(string[] args)
{
ListProduct().Wait();
}
static async Task ListProduct()
{
var serviceRoot = "http://localhost:64700/odata";
var context = new Default.Container(new Uri(serviceRoot));
IEnumerable<Product> products = await context.Products.ExecuteAsync();
foreach (var product in products)
{
Console.WriteLine("{0} --- {1}", product.ID, product.Name);
}
}
}
}
Update Operation
using System;
using System.Diagnostics;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Data;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Imaging;
using System.Windows.Navigation;
using System.Windows.Shapes;
using System.Data.Services.Client;
using WpfApplication1.ServiceReference1;
namespace WpfApplication1
{
public partial class Window1 : Window
{
public Window1()
{
InitializeComponent();
}
private void Window1_Loaded(object sender, RoutedEventArgs e)
{
try
{
Uri svcUri = new Uri("http://localhost:52027/WcfDataService1.svc");
context = new castEntities(svcUri);
var data_to_change = (from table in context.Tables
where table.Name == "Sam"
select table).Single();
data_to_change.Name = "Wiley";
context.UpdateObject(data_to_change);
context.SaveChanges();
}
catch (Exception ex)
{
MessageBox.Show(ex.ToString());
}
}
private void buttonClose_Click(object sender, RoutedEventArgs e)
{
this.Close();
}
}
}
Delete Operation
using System;
using System.Linq;
using System.Collections.Generic;
using System.Threading.Tasks;
using WebApplication2.Models;
namespace odata_client_new
{
class Program
{
static void Main(string[] args)
{
DeleteCustomer().Wait();
}
static async Task DeleteCustomer()
{
var serviceRoot = "http://localhost:64700/odata";
var context = new Default.Container(new Uri(serviceRoot));
var customer = await context.Customers.ByKey(new Dictionary<string, object>() { { "ID", 002 } }).GetValue();
Console.WriteLine(customer.Name);
context.DeleteObject(customer);
context.SaveChanges();
}
}
}
Universal Linker is responsible for linking service object (eg. OData Client HttpRequest Get Service) to any matching operation objects. (Operation objects are generated by the analysis of server code. Refer dotnetweb documentation.)
Limitations
- For applications using Microsoft.OData.Client, only client code generated by OData Connected Service is supported.
- For applications using Microsoft.OData.Client, methods like 'ByKey' which are defined in the auto-generated class 'ExtensionMethods' are not supported.
- Actions and Functions are supported only for Simple.OData.Client.
For applications using Microsoft.Data.Services.Client, objects are not created for some code.
