c# - 为什么 Delta.Patch 不会将字节数组更新为空值？

Question

我的对象模型有一个用于存储图像的字节数组。当我尝试通过 Delta.Patch 将此字节数组更新为新值时，它工作得很好，但是当我尝试将它更新为 null 时，它失败了。

这是我正在查看的代码行

update.Patch(entity);

如果我查看 update 对象，我可以看到 update.ChangedProperties 包含我的图像属性，因此它知道应该更新它。我还可以看到 update._instance 包含图像字段具有空值的对象实例，我可以使用 Fiddler 查看更改后的值作为空值发送。

但是当我在调用 .Patch 后查看 entity 对象时，新值应该为 null，字节数组没有更新。 Delta 中的其他更新得到正确更新，但不是这个字节数组。

这可能是什么原因造成的？我对 OData 还是个新手，不确定我是否遗漏了一些明显的东西。

Answer 1

我查看了 OData(WebAPI version)的源代码并(可能)发现了核心问题。问题也适用于 ASP.NET Core 版本，因为它与 ASP.NET WebAPI 共享代码库。

问题

你调用Patch(TStructuralType original)调用 CopyChangedValues(TStructuralType original) 的方法方法。两者都是 Delta<T> class 的公共(public)成员

public void Patch(TStructuralType original)
{
    CopyChangedValues(original);
}

内部CopyChangedValues(TStructuralType original)方法是一段处理将值复制到原始实例的代码。代码遍历 PropertyAccessor<TStructuralType> 数组和调用 Copy(TStructuralType from, TStructuralType to)方法。

// For regular non-structural properties at current level.
PropertyAccessor<TStructuralType>[] propertiesToCopy =
                this._changedProperties.Select(s => _allProperties[s]).ToArray();
foreach (PropertyAccessor<TStructuralType> propertyToCopy in propertiesToCopy)
{
    propertyToCopy.Copy(_instance, original);
}

内部Copy(TStructuralType from, TStructuralType to)在 PropertyAccessor<TStructuralType> 中实现你会发现 call to abstract SetValue(TStructuralType instance, object value) .

public void Copy(TStructuralType from, TStructuralType to)
{
    if (from == null)
    {
        throw Error.ArgumentNull("from");
    }
    if (to == null)
    {
        throw Error.ArgumentNull("to");
    }
    SetValue(to, GetValue(from));
}

此方法由 FastPropertyAccessor<TStructuralType> 实现类。

public override void SetValue(TStructuralType instance, object value)
{
    if (instance == null)
    {
        throw Error.ArgumentNull("instance");
    }

    if (_isCollection)
    {
        DeserializationHelpers.SetCollectionProperty(instance, _property.Name, edmPropertyType: null,
            value: value, clearCollection: true);
    }
    else
    {
        _setter(instance, value);
    }
}

重要的代码行是if (_isCollection) .此 bool 标志在构造函数中设置并调用 IsCollection() TypeHelper 中的静态方法类。

public FastPropertyAccessor(PropertyInfo property)
    : base(property)
{
    _property = property;
    _isCollection = TypeHelper.IsCollection(property.PropertyType);

    if (!_isCollection)
    {
        _setter = PropertyHelper.MakeFastPropertySetter<TStructuralType>(property);
    }
    _getter = PropertyHelper.MakeFastPropertyGetter(property);
}

在IsCollection(Type clrType)我们遍历调用IsCollection(this Type type, out Type elementType) .

public static bool IsCollection(Type clrType)
{
    Type elementType;
    return TypeHelper.IsCollection(clrType, out elementType);
}

以下是 // see if this type should be ignored. 之后的重要行评论(这很奇怪，可能表明有人忘记完成他已经开始的事情)只有string ( char[] ) 被排除在外。其他数组(包括 byte[] )跳到以下代码，当这些类型正在实现 IEnumerable<T> 时，它会积极评估 byte[](和任何其他数组类型)。界面。

public static bool IsCollection(Type clrType, out Type elementType)
{
    if (clrType == null)
    {
        throw Error.ArgumentNull("clrType");
    }

    elementType = clrType;

    // see if this type should be ignored.
    if (clrType == typeof(string))
    {
        return false;
    }

    Type collectionInterface
        = clrType.GetInterfaces()
            .Union(new[] { clrType })
            .FirstOrDefault(
                t => TypeHelper.IsGenericType(t)
                        && t.GetGenericTypeDefinition() == typeof(IEnumerable<>));

    if (collectionInterface != null)
    {
        elementType = collectionInterface.GetGenericArguments().Single();
        return true;
    }

    return false;
}

如果我们跳回到SetValue(TEntityType entity, object value)方法实现我们最终调用 DeserializationHelpers.SetCollectionProperty(entity, _property.Name, edmPropertyType: null, value: value, clearCollection: true);在 DeserializationHelpers 类。

if (_isCollection)
{
    DeserializationHelpers.SetCollectionProperty(instance, _property.Name, edmPropertyType: null,
        value: value, clearCollection: true);
}

很明显，这个方法的实现是非常防御性的，并且避免在集合值为 null 的情况下抛出异常。 .该方法的第一行是 if (value != null)并且没有 else要执行的代码块之后的 block 或代码。我们可以从字面上说，对于每个实现 IEnumerable<T> 的类型，都会忽略空值。 , 因此未设置。

internal static void SetCollectionProperty(object resource, string propertyName,
    IEdmCollectionTypeReference edmPropertyType, object value, bool clearCollection)
{
    if (value != null)
    {
        IEnumerable collection = value as IEnumerable;
        Contract.Assert(collection != null,
            "SetCollectionProperty is always passed the result of ODataFeedDeserializer or ODataCollectionDeserializer");

        Type resourceType = resource.GetType();
        Type propertyType = GetPropertyType(resource, propertyName);

        Type elementType;
        if (!TypeHelper.IsCollection(propertyType, out elementType))
        {
            string message = Error.Format(SRResources.PropertyIsNotCollection, propertyType.FullName, propertyName, resourceType.FullName);
            throw new SerializationException(message);
        }

        IEnumerable newCollection;
        if (CanSetProperty(resource, propertyName) &&
            CollectionDeserializationHelpers.TryCreateInstance(propertyType, edmPropertyType, elementType, out newCollection))
        {
            // settable collections
            collection.AddToCollection(newCollection, elementType, resourceType, propertyName, propertyType);
            if (propertyType.IsArray)
            {
                newCollection = CollectionDeserializationHelpers.ToArray(newCollection, elementType);
            }

            SetProperty(resource, propertyName, newCollection);
        }
        else
        {
            // get-only collections.
            newCollection = GetProperty(resource, propertyName) as IEnumerable;
            if (newCollection == null)
            {
                string message = Error.Format(SRResources.CannotAddToNullCollection, propertyName, resourceType.FullName);
                throw new SerializationException(message);
            }

            if (clearCollection)
            {
                newCollection.Clear(propertyName, resourceType);
            }

            collection.AddToCollection(newCollection, elementType, resourceType, propertyName, propertyType);
        }
    }
}

---

解决方案一

第一个可能的解决方案是创建自定义模型 Binder 和句柄 null byte[] 的值返回空字节数组并添加 NullByteArrayModelBinder模型绑定(bind)器的类。

免责声明:没有测试，但应该可以。

public class NullByteArrayModelBinder : DefaultModelBinder {
    public override object BindModel(ControllerContext controllerContext, ModelBindingContext bindingContext) {
        if(bindingContext.ModelType == typeof(byte[])) {
            return base.BindModel(controllerContext, bindingContext) ?? new byte[0];
        }

        return base.BindModel(controllerContext, bindingContext);
    }
}

这种方法有一个缺点。 OData 的消费者还需要处理空数组 array.Length > 0无处不在 array != null现在进行检查。

---

方案二

第二个选项是自定义序列化和反序列化。

序列化:从空array至 null => array.Length > 0 ? array : null;

反序列化:来自 null清空 array => array ?? new byte[0];

希望对您有所帮助!