在构建OData服务时，处理实体间的关联操作（如商品与厂商的绑定、订单与客户的映射）是常见需求。OData协议允许客户端通过标准HTTP请求查询、建立或移除实体间的关联。本文将详细讲解如何在ASP.NET Web API中实现这些功能。

定义关联实体模型

首先定义一个厂商（Vendor）实体类，并使用字符串作为其主键，以展示OData对非整型主键的支持：

namespace ODataService.Models
{
    public class Vendor
    {
        [Key]
        public string VendorCode { get; set; }
        public string CompanyName { get; set; }
    }
}

接着在商品（Item）实体中添加外键与导航属性，建立一对多关系：

public class Item
{
    public int ItemId { get; set; }
    public string Title { get; set; }
    public decimal Cost { get; set; }
    public string Type { get; set; }

    [ForeignKey("Vendor")]
    public string VendorCode { get; set; }
    public virtual Vendor Vendor { get; set; }
}

在数据上下文中注册新的实体集，使Entity Framework能够识别该表：

public class AppDbContext : DbContext
{
    public AppDbContext() : base("name=AppDbContext")
    {
    }

    public DbSet<Item> Items { get; set; }
    public DbSet<Vendor> Vendors { get; set; }
}

最后，在WebApiConfig.cs中构建EDM模型时注册Vendor实体集：

ODataConventionModelBuilder modelBuilder = new ODataConventionModelBuilder();
modelBuilder.EntitySet<Item>("Items");
modelBuilder.EntitySet<Vendor>("Vendors");

处理导航属性的查询

客户端可以通过导航属性直接获取关联实体，例如请求 GET /Items(1)/Vendor 获取指定商品的厂商信息。为了支持此类请求，需要在控制器中添加对应的方法。按照OData路由约定，如果导航属性名为"Vendor"，则需定义名为"GetVendor"的方法，且必须使用"key"作为父实体的键参数，并标注 [FromODataUri] 以确保按OData规则解析URL中的键值：

// GET /Items(1)/Vendor
public Vendor GetVendor([FromODataUri] int key)
{
    var item = db.Items.SingleOrDefault(i => i.ItemId == key);
    if (item == null)
    {
        throw new HttpResponseException(HttpStatusCode.NotFound);
    }
    return item.Vendor;
}

建立实体关联（$links）

OData通过 $links 语法管理实体间的关系。例如，商品1与厂商的关联URL为 /Items(1)/$links/Vendor。客户端通过向该URL发送POST请求来创建关联，请求体中包含目标实体的URI，如 {"url":"http://localhost/odata/Vendors('V001')"}。

在控制器中实现创建关联的逻辑：

[AcceptVerbs("POST", "PUT")]
public async Task<IHttpActionResult> LinkVendor([FromODataUri] int key, string navigationProperty, [FromBody] Uri link)
{
    var targetItem = await db.Items.FindAsync(key);
    if (targetItem == null)
    {
        return NotFound();
    }

    if (navigationProperty != "Vendor")
    {
        return NotFound();
    }

    string vendorId = ExtractKeyFromUri<string>(link);
    var targetVendor = await db.Vendors.FindAsync(vendorId);
    if (targetVendor == null)
    {
        return NotFound();
    }

    targetItem.Vendor = targetVendor;
    await db.SaveChangesAsync();
    return StatusCode(HttpStatusCode.NoContent);
}

上述代码的难点在于从请求体传入的URI中提取目标实体的主键。可以通过模拟路由匹配来实现解析：

private TKey ExtractKeyFromUri<TKey>(Uri odataLink)
{
    TKey parsedKey = default(TKey);
    var currentRoute = Request.GetRouteData().Route;

    var mockRoute = new HttpRoute(currentRoute.RouteTemplate,
        new HttpRouteValueDictionary(currentRoute.Defaults),
        new HttpRouteValueDictionary(currentRoute.Constraints),
        new HttpRouteValueDictionary(currentRoute.DataTokens), currentRoute.Handler);

    var mockRequest = new HttpRequestMessage(HttpMethod.Get, odataLink);
    var mockRouteData = mockRoute.GetRouteData(Request.GetConfiguration().VirtualPathRoot, mockRequest);

    if (mockRouteData != null)
    {
        ODataPath odataPath = mockRequest.GetODataPath();
        var keySegment = odataPath.Segments.OfType<KeyValuePathSegment>().FirstOrDefault();
        if (keySegment != null)
        {
            parsedKey = (TKey)ODataUriUtils.ConvertFromUriLiteral(keySegment.Value, ODataVersion.V3);
        }
    }
    return parsedKey;
}

移除实体关联

解除关联同样操作 $links URL，只需发送DELETE请求。例如，DELETE /Items(1)/$links/Vendor 将清空该商品的厂商关联。对应的控制器实现如下：

public async Task<IHttpActionResult> UnlinkVendor([FromODataUri] int key, string navigationProperty)
{
    var item = await db.Items.FindAsync(key);
    if (item == null)
    {
        return NotFound();
    }

    if (navigationProperty != "Vendor")
    {
        return NotFound();
    }

    item.Vendor = null;
    await db.SaveChangesAsync();
    return StatusCode(HttpStatusCode.NoContent);
}

需要注意的是，如果导航属性是一个集合（即一对多或多对多关系），解除单个关联时URL中需包含目标实体的键，如 DELETE /Customers(1)/$links/Orders(2)，此时方法的签名应调整为包含 relatedKey 参数：

void UnlinkRelatedEntity([FromODataUri] int key, string relatedKey, string navigationProperty);