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#连接蓝牙设备的实现示例”的攻略,包含两条示例: 一、连接蓝牙设备的前置知识 连接蓝牙设备需要以下前置知识: 确定蓝牙设备的名称或 MAC 地址。 确认蓝牙设备支持的服务及特征值。这些信息通常可以找到蓝牙设备的对应文档中或通过蓝牙调试工具获得。 确保本机已经安装了支持蓝牙通信的驱动程序和 .NET Framework 版本 >= 3.5…

    C# 2023年5月15日
    00
  • C#如何给word文档添加水印

    给word文档添加水印可以通过C#代码实现,具体步骤如下: 步骤一:引用Microsoft.Office.Interop.Word库 水印的添加需要使用到Word操作库,因此需要先引用Microsoft.Office.Interop.Word库。在Visual Studio中,可以在解决方案资源管理器中右击项目,选择“添加引用”,在COM中找到“Micros…

    C# 2023年6月6日
    00
  • C#获取视频某一帧的缩略图的方法

    C#获取视频某一帧的缩略图的方法 在C#中,我们可以使用FFmpeg库和GDI+库来获取视频某一帧的缩略图。本文将提供详细的“C#获取视频某一帧的缩略图的方法”的完整攻略,包括如何使用FFmpeg库和GDI+库获取视频某一帧的缩略图,以及两个示例代码。 使用FFmpeg库获取视频某一帧的缩略图 在使用FFmpeg库获取视频某一帧的缩略图时,我们可以使用以下步…

    C# 2023年5月15日
    00
  • 如何使用C#在PDF文件添加图片印章

    下面我将为您详细讲解如何使用C#在PDF文件中添加图片印章的完整攻略。 1. 选择PDF编辑库 在使用C#编写程序之前,您需要先选择一款适用于您需求的PDF编辑库。以下是几款常用的PDF编辑库: iTextSharp PDFsharp Spire.PDF 在这里,我们以iTextSharp为例,讲解如何使用C#在PDF文件中添加图片印章。 2. 安装iTex…

    C# 2023年6月6日
    00
  • c# 实现网页加载后将页面截取为长图片

    下面是C#实现网页加载后将页面截取为长图片的完整攻略。 1. 确定工具和库 要实现该功能,我们需要使用两个库,OpenQA.Selenium和Selenium.Support,前者是用于C#的Web自动化测试库,后者是一个Selenium的附加库。 另外,我们还需要下载Chrome浏览器驱动程序,它将允许我们使用我们自己的浏览器进行测试,并且提供截图等更多便…

    C# 2023年6月1日
    00
  • C#使用throw和throw ex抛出异常的区别介绍

    下面是详细讲解“C#使用throw和throw ex抛出异常的区别介绍”的攻略。 什么是异常? 在编程过程中,可能会出现各种错误情况,例如文件不存在、网络连接超时等,这些错误情况被称为异常。在C#中,可以使用异常处理机制来有效地处理异常,以保证程序的正常运行。 C#中的异常处理机制 C#中的异常处理机制主要涉及以下关键字: try:尝试执行一段代码,并且在代…

    C# 2023年5月15日
    00
  • ASP.NET Core中实现全局异常拦截的完整步骤

    ASP.NET Core中实现全局异常拦截攻略 在本攻略中,我们将深入讲解如何在ASP.NET Core中实现全局异常拦截,并提供两个示例说明。 什么是全局异常拦截? 全局异常拦截是指在ASP.NET Core应用程序中,捕获应用程序中的所有异常,并提供自定义处理程序来处理这些异常。这样可以提高应用程序的可靠性和稳定性。 如何实现全局异常拦截? 以下是在AS…

    C# 2023年5月17日
    00
  • C#实现根据字节数截取字符串并加上省略号的方法

    当我们需要在页面上展示一篇文章标题或者一段文字时,经常会遇到字数过多的情况。这时候我们可以使用 C# 实现的截取字符串的方法来实现并在尾部加上省略号,提高用户体验。 下面是实现的完整攻略: 1.确定要截取的字节数 首先需要确定截取的字节数。这里需要注意的是一个汉字在 utf-8 编码下占用三个字节,而在 gb2312/GBK 编码下占用两个字节。因此我们需要…

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