OData WebAPI实践-OData与EDM

本文属于 OData 系列

引言

在 OData 中,EDM(Entity Data Model) 代表“实体数据模型”,它是一种用于表示 Web API 中的结构化数据的格式。EDM 定义了可以由 OData 服务公开的数据类型、实体和关系。 EDM 也提供了一些规则来描述数据模型中的实体之间的关系,例如继承、关联和复合类型。EDM 是 OData 协议的核心组成部分之一,它允许客户端和服务器之间以一致的方式交换和操作数据。

EDM 与实体对象模型

我刚接触 EDM 时恰好是与 EF Core 一起使用,就非常不理解这个现象:明明已经在 EF Core 中已经定义了模型,为啥还需要单独配置一个 EDM?

其实,EDM 和实体框架(EF)Core 中的实体对象虽然都用于数据建模,但却是不同的概念:在 EF Core 中,实体对象表示数据库中的表或视图,而 EDM 定义了 OData 服务中的数据结构,包括实体、属性、导航属性等。可以理解实体对象是为数据库服务,而 EDM 是用于数据开放服务的

虽然 EDM 和 EF Core 中的实体对象都具有一些相似之处,例如它们都有属性和关系,甚至你也可以直接返回实体模型用提供给 OData 让其动态自动生成 EDM 模型(Non-ODM 模式),但是依然建议使用 EDM 模型,主要是有几个方面:

  1. 实体框架中的实体类可能包含与 OData 服务定义不同的属性。例如,实体框架中的实体类可能包含用于持久化和跟踪状态的属性,而这些属性可能并不需要在 OData 服务中公开。
  2. 实体框架中的实体类可能使用与 OData 服务定义不同的命名约定。例如,实体框架中的实体类可能使用 PascalCase(首字母大写)命名约定,而在 OData 服务中的 EDM 可以使用 camelCase(首字母小写)命名约定。
  3. 实体框架中的实体类可能包含与 OData 服务定义不同的数据结构。例如,联合主键的实现用于 OData 查询较为麻烦,可以配置 EDM 使得 OData 对外服务不使用联合主键。

EDM 配置

在配置 OData 时,我们需要在代码中提供 EDM 对象。

.AddRouteComponents(AuthorizeHelper.PREFIX, EdmHelper.GetEdmModels());

GetEdmModels 函数返回一个 IEdmModel 对象。

      public static IEdmModel GetEdmModels()
        {
            ODataConventionModelBuilder builder = new ODataConventionModelBuilder();

            var device = builder.EntitySet<DeviceInfo>("DeviceInfos").EntityType.HasKey(p => p.DeviceId);
			device.Action("Upload");
            builder.EnableLowerCamelCase();
            return builder.GetEdmModel();
        }

以上代码中对 DeviceInfo 类型定义了一个实体对象,其具有 DeviceId 作为主键,拥有一个名为 Upload 的 Action。并且对所有的 EDM 对象启用了 LowerCamelCase 支持。上面的感觉是挺简单的是吧,注意我们使用到了 ODataConventionModelBuilder 对象,这个对象帮助我们自动实现了很多配置内容。如果我们使用其他的方式就不那么简单了。实际上配置 EDM 总共有三种方式。

我一般只使用 Convention 的配置方法,因此这里引用官方网站的例子,详情请见 Introduction to the model builders - OData | Microsoft Learn

Explicit

如果模型通过 new EdmModel() 构建,那么构建的是无类型模型,相当于你不依赖现有的 CLR 类型凭空构建了一个模型。

public IEdmModel GetEdmModel()
{
    EdmModel model = new EdmModel();
    
	EdmEntityType customer = new EdmEntityType("WebApiDocNS", "Customer");
	customer.AddKeys(customer.AddStructuralProperty("CustomerId", EdmPrimitiveTypeKind.Int32));
	customer.AddStructuralProperty("Location", new EdmComplexTypeReference(address, isNullable: true));
	model.AddElement(customer);
	
	EdmEntityType order = new EdmEntityType("WebApiDocNS", "Order");
	order.AddKeys(order.AddStructuralProperty("OrderId", EdmPrimitiveTypeKind.Int32));
	order.AddStructuralProperty("Token", EdmPrimitiveTypeKind.Guid);
	model.AddElement(order);

    return model;
}

Non-convention

如果模型是依赖 new ODataModelBuilder() 构建,那么构建模型时可以依据现有的 CLR 对象进行构建,不过依然需要配置每一个属性、操作等。

public static IEdmModel GetEdmModel()
{
    var builder = new ODataModelBuilder();
    var customer = builder.EntityType<Customer>();
customer.HasKey(c => c.CustomerId);
customer.ComplexProperty(c => c.Location);
customer.HasMany(c => c.Orders);

	var order = builder.EntityType<Order>();
order.HasKey(o => o.OrderId);
order.Property(o => o.Token);
    return builder.GetEdmModel();
}

相当于前一种方法已经有了很大改进,我们可以依赖现有的结构,而不再需要手动去命名了。

Convention

更进一步,我们可以使用惯例 ( Convention )方式,模型依赖 new ODataConventionModelBuilder () 构建,这个是代码最少的,整个模型的配置按照 OData RESTful 惯例实现。

      public static IEdmModel GetEdmModels()
        {
            ODataConventionModelBuilder builder = new ODataConventionModelBuilder();

            var device = builder.EntitySet<DeviceInfo>("DeviceInfos").EntityType;
            return builder.GetEdmModel();
        }

Convention 涉及的内容很多,有机会以后会详细解释惯例生成 EDM 这种模式。

常用 EDM 配置

EDM 配置项目繁多,我们常用的有:

  • 配置实体(主键)
var device = builder.EntitySet<DeviceInfo>("DeviceInfos").EntityType;
  • 配置(集合) Action
//对于实体上的Action
device.Action("Upload");
//对于集合上的Action
device.Collection.Action("Upload");
  • 配置(集合) Function
//对于实体上的Function
device.Function("Data").Returns<string>();
//对于集合上的Function
device.Collection.Function("Data").Returns<string>();

对 Function 以及 Action 的详细介绍,请期待后续文章。

访问 EDM 模型

OData 服务提供了 $metadata 终结点,可以从服务的根 URL 后添加 $metadata 来访问。例如以下是一个可以直接访问的 EDM 模型,以 XML 形式提供:

http://services.odata.org/TripPinRESTierService/$metadata

此外,也可以使用某些工具(如 Microsoft 的 OData Connected Service)来自动生成客户端代码,并从服务中获取元数据。这些工具通常会从服务的根 URL 下载 $metadata 文件,并将其解析为客户端代码。

原文链接:https://www.cnblogs.com/podolski/archive/2023/05/11/17390887.html

本站文章如无特殊说明,均为本站原创,如若转载,请注明出处:OData WebAPI实践-OData与EDM - Python技术站

(0)
上一篇 2023年5月11日
下一篇 2023年5月11日

相关文章

  • C#中使用迭代器处理等待任务

    下面是关于C#中使用迭代器处理等待任务的完整攻略: 1. 使用迭代器和async/await处理任务 在C#中,我们使用async/await来异步处理任务。但是如果需要按顺序执行多个异步任务,常规的做法是使用多个await关键字。例如: async Task DoSomethingAsync() { var result1 = await GetResul…

    C# 2023年5月15日
    00
  • C#内置泛型委托之Func委托

    下面让我详细讲解一下“C#内置泛型委托之Func委托”的完整攻略。 Func委托是什么? 在C#中,Func委托是一种预定义的泛型委托,它可以表示一个包含任意数量输入参数和返回值类型的委托。 Func委托是从System.Func<TResult>类派生的,这个类有若干个泛型参数,最后一个泛型参数表示返回值类型,而前面的泛型参数表示输入参数的类型…

    C# 2023年5月15日
    00
  • C#多线程的ResetAbort()方法

    下面是关于C#多线程中ResetAbort()方法的详细讲解: ResetAbort()方法简介 ResetAbort()是多线程中的一个方法,它用于取消挂起的线程并重置线程的中止状态。当我们使用Abort()方法中止一个线程时,如果无法中止该线程,则该线程将被挂起,并且它的中止状态将被设置为一个标志,表示该线程已经被中止。此时,我们可以使用ResetAbo…

    C# 2023年5月15日
    00
  • C#多线程之线程锁

    关于C#多线程中的线程锁,我会分以下几个方面进行全面的讲解: 什么是线程锁? C#中线程锁的使用方法 实例1:使用线程锁的经典示例——银行取钱 实例2:使用线程锁处理多线程并发访问共享资源的问题——购票系统 1. 什么是线程锁? 线程锁是一种多线程管理技术,用来控制多个线程之间的访问顺序,避免出现对共享资源的并发访问冲突,从而保证程序在多线程环境下的正确性和…

    C# 2023年5月15日
    00
  • C#中委托用法

    C#中委托是一种能够存储方法的一种类型。委托可以用来实现回调函数,事件处理程序和多路广播事件等。下面是C#中委托用法的完整攻略。 1.定义委托类型 在定义委托时,需要指定返回类型和参数列表,如下所示: delegate void MyDelegate(int x, int y); 表示MyDelegate是一种委托类型,接受两个int类型的参数,无返回值。 …

    C# 2023年6月1日
    00
  • C#多线程用法详解

    C#多线程用法详解 C#支持多线程编程,可以充分利用多核CPU的性能,提高程序的性能和响应速度。本文将详细讲解C#多线程的用法。 线程的创建 C#创建线程有两种方式,一种是使用Thread类,另一种是使用ThreadPool类。 使用Thread类创建线程 使用Thread类创建线程可以获得更多的控制权,可以更灵活地控制线程的行为。 Thread threa…

    C# 2023年5月15日
    00
  • 使用源链接对ASP.NET Core源代码进行调试

    使用源链接对ASP.NET Core源代码进行调试 在ASP.NET Core应用程序中,源代码调试是一项非常重要的任务,它可以帮助您跟踪应用程序的运行情况并诊断问题。在本攻略中,我们将详细讲解如何使用源链接对ASP.NET Core源代码进行调试,并提供两个示例说明。 步骤一:启用源链接 要使用源链接对ASP.NET Core源代码进行调试,您需要在应用程…

    C# 2023年5月17日
    00
  • C#实现去除Strings中空格的方法

    下面是详细讲解“C#实现去除Strings中空格的方法”的攻略。 1. 使用Replace方法 String类的Replace方法可以用来替换字符串中的某个字符(串)。我们可以利用这个方法将空格(包括全角和半角空格)全部替换为空字符串。示例代码如下: string originalStr = "hello world!"; string …

    C# 2023年6月8日
    00
合作推广
合作推广
分享本页
返回顶部