Added ArrayContains to CosmosLinqExtensions to allow partial matching

[bcrobinson]

Pull Request Template

Description

The Array_Contains function CosmosDB Sql has a 3rd parameter which allows it to do a partial match on the given item. This is unable to be called with the built in Linq array.Contains(item) extension methods.

This adds this adds an explicit mapping to this function to allow it to be called in Linq like this:

documents.Where(document => document.ObjectArray.ArrayContains(new { Name = "abc" }, true))

Remarks

ArrayContains name instead of Contains

I namef the new CosmosLinqExtensions extension method ArrayContains instead of Contains as the other extensions methods matched thier Cosmos Sql counterparts and because this is for a direct invokation of this function.

Can change the name if you require.

ArrayContains Signature

bool ArrayContains(this IEnumerable obj, object itemToMatch, bool partialMatch)

The itemToMatch paramater is an object as it will need to take anonymous objects (and c# doesn't have a similar concept to typescript's Partial<T>). If was generic callers would be force to pass in an object of the same type, and the default serialiser creates object with every property that exists on the class. So the created query object with default values (e.g. Array_Contains(root["Items"], { "I" = 0, "s" = null }) )which would the cause Cosmos to try and match on all properties.

Because it's not generic the obj is then IEnumerable, so it would at a minimum only work on iterable values.

bool ArrayContains(this IEnumerable obj, object itemToMatch, bool partialMatch)

As if this was ArrayContains<T>(this IEnumerable<T> obj, T itemToMatch, bool partialMatch) then we'd need to always pass the same T type to this method. The downside is you loose some type checking (the anonymous object could have a property name typed wrong),

Modification to ArrayContainsVisitor

The ArrayContainsVisitor visitor already exists for the Contains Linq mappings, the I modified this to work with the different extension version for Array Contains.

Type of change

• New feature (non-breaking change which adds functionality)

Closing issues

closes #4991

To automatically close an issue: closes #IssueNumber

[bcrobinson]

@microsoft-github-policy-service agree company="Solarvista Software LTD"