Edit

Share via


OData lib 8.x changelog

OData lib is loosely used to refer to the following group of OData libraries available on the Nuget gallery:

You can install or update any of the NuGet packages for OData lib using the Package Manager Console.

  • Support type cast in group in #3041
  • Update message writer and reader to ignore Message info from DI #3058
  • Add support for "Any" and Predicates method call expressions in #3061
  • Isolate scoped settings in default OData services in #3071
  • Port E2E tests to 8.0 in #3042, #3046, #3048
  • Add ODataPathInfo tests by @gathogojr in #3053
  • Fix error that occurs when you check whether a string or integer literal is in an enum collection in #3039
  • Fix argument null exception during projection when expanded navigation property is null in #3038
  • Add Microsoft.Extensions.Http dependency in #3035
  • Replace IsType using IsOf to align with the OData standard in #3025
  • Remove obsolete ReadUntypedAsString and address string comparison warnings in #3024
  • Support enum as integer value (enclosed and not enclosed with single quotes) in $filter in #3018
  • Port E2E tests in #3017, #3028
  • Support enums as keys in OData client in #3013
  • Provide async APIs for CsdlWriter and SchemaWriter in #3006
  • Remove references to ATOM in #2972
  • Made ODataUtf8JsonWriter the default JSON writer implementation to enhance serialization performance. Benchmarks and feedback from some OData users have shown that ODataUtf8JsonWriter offers better performance and memory efficiency compared to the current default JsonWriter.
  • Changed the ODataLibraryCompatibility enum into a flags enum, where each bit represents a different compatibility setting that can enable some legacy serialization behavior.
  • Refactored ODataError, ODataErrorDetail and ODataInnerError classes.
    • The ODataErrorDetail’s ErrorCode property updated to Code
    • The initialization of ODataInnerError changed to ODataInnerError(new Dictionary<string, ODataValue>())
  • The ODataResource.Properties property type was changed to IEnumerable<ODataPropertyInfo> to facilitate metadata reading or writing, even in scenarios where the property lacks a value.
  • When writing the Scale attribute in XML CSDL, use variable in lowercase instead of Variable. An enum flag, UseLegacyVariableCasing, was added to support the legacy behavior.
  • Added UsesDefault property to IEdmVocabularyAnnotation to support creating vocabulary annotations without explicit values but with default values. These default values are not written to the CSDL but can be read.
  • Renamed IBaseEntityType.Context to DataServiceContext to avoid naming conflicts that cause compilation or runtime errors when Context is used as a property name in customer schemas.

Starting version 8, OData lib will only target .NET 8 or later.

  • IJsonReaderAsync interface has been merged into IJsonReader interface.
    • Any implementation of IJsonReader needs to implement methods previously defined in IJsonReaderAsync interfaces.
    • The Value property in IJsonReader interface is replaced by GetValue method.
  • IJsonReaderFactoryAsync interface has been dropped.
  • IJsonStreamWriter, IJsonWriterAsync and IJsonStreamWriterAsync interfaces have been merged into IJsonWriter interface.
    • Any implementation of IJsonWriter needs to implement methods previously defined in IJsonStreamWriter, IJsonWriterAsync and IJsonStreamWriterAsync interfaces.
  • IStreamBasedJsonWriterFactory and IJsonWriterFactoryAsync interfaces has been dropped.
  • DefaultStreamBasedJsonWriterFactory class has been renamed to ODataUtf8JsonWriterFactory.
  • CreateJsonWriter(TextReader, bool) defined in IJsonWriterFactory has changed to CreateJsonWriter(Stream, bool, Encoding). The method now accepts a Stream rather than a TextReader.
  • List<ODataUrlValidationMessage> Messages property defined in ODataUrlValidationContext class has changed to IReadOnlyList<ODataUrlValidationMessage> Messages.
    • AddMessage(ODataUrlValidationMessage) overload introduced in ODataUrlValidationContext.
  • INavigationSourceSegment interface introduced. The purpose of this new interface is to reduce casting when determining the navigation source associated with the segment. EntitySetSegment, SingletonSegment and NavigationPropertySegment implement this new interface.
  • Deprecated support for JSONP callback. Feature to be removed in ODL 9.
    • JsonPCallback property defined in ODataMessageWriterSettings class marked as obsolete.
    • StartPaddingFunctionScope method defined in IJsonWriter interface marked as obsolete.
    • EndPaddingFunctionScope method defined in IJsonWriter interface marked as obsolete.
    • WritePaddingFunctionName method defined in IJsonWriter interface marked as obsolete.
    • StartPaddingFunctionScopeAsync method defined in IJsonWriter interface marked as obsolete.
    • EndPaddingFunctionScopeAsync method defined in IJsonWriter interface marked as obsolete.
    • WritePaddingFunctionNameAsync method defined in IJsonWriter interface marked as obsolete.
  • ODataSimplifiedOptions class was dropped. This class would be injected into the DI container and the settings used to control behaviour when parsing URLs, and when writing and reading payloads. In ODL 8, ODataMessageReaderSettings, ODataMessageWriterSettings, and ODataUriParserSettings may variously be used to accomplish the same purpose.
    • EnableReadingKeyAsSegment and EnableReadingODataAnnotationWithoutPrefix properties moved to ODataMessageReaderSettings class.
    • EnableWritingKeyAsSegment property moved to ODataMessageWriterSettings class.
    • SetOmitODataPrefix(bool), SetOmitODataPrefix(bool, ODataVersion), GetOmitODataPrefix(), and GetOmitODataPrefix(ODataVersion) methods moved to ODataMessageWriterSettings class.
    • EnableParsingKeyAsSegment property moved to ODataUriParserSettings class.
  • In ODL 7, when ODataBinaryStreamValue class is initialized using the ODataBinaryStreamValue(Stream) constructor, the stream is left open by default upon the object being disposed. In ODL 8, the stream is closed by default the object objects is disposed. The ODataBinaryStreamValue(Stream, bool) constructor overload may be used where leaving the stream open is intended.
  • Func<string, bool> ShouldIncludeAnnotation property introduced in ODataMessageWriterSettings. This property makes it possible for developers to force a custom instance annotation to be written even if it's not include in the optional @odata.include-annotations preference token in Prefer request header.
  • IContainerBuilder interface used when registering OData services was dropped. Use Microsoft.Extensions.DependencyInjection library instead.
    • AddDefaultODataServices(IServiceCollection, ODataVersion, Action<ODataMessageReaderSettings>, Action<ODataMessageWriterSettings>, Action<ODataUriParserSettings>) extension method introduced for the purpose of registering OData services.
    • IContainerProvider interface replaced by IServiceCollectionProvider interface. It's a provider for the IServiceProvider IoC container.
    • ODataBatchOperationRequestMessage now implements IServiceCollectionProvider instead of IContainerProvider.
    • ODataBatchOperationResponseMessage now implements IServiceCollectionProvider instead of IContainerProvider.
  • HttpWebRequestMessage class has been dropped - effectively dropping support for HttpWebRequest. Use HttpClientRequestMessage class instead.
  • IHttpClientHandlerProvider interface used to provide HttpClientHandler for use with DataServiceContext has been dropped.
  • HttpClientHandlerProvider property defined in DataServiceClientRequestMessageArgs class and used for providing HttpClientHandler substituted with HttpClientFactory property that accomplishes the same purpose.
  • HttpClientHandlerProvider property defined in DataServiceContext class and used for providing HttpClientHandler substituted with HttpClientFactory property that accomplishes the same purpose.
  • Obsolete Credentials property dropped from DataServiceClientRequestMessage abstract class. The recommended way to configure credentials is through HttpClientHandler that can be provided using IHttpClientFactory.
  • Obsolete Credentials property dropped from HttpClientRequestMessage class. The recommended way to configure credentials is through HttpClientHandler that can be provided using IHttpClientFactory.
  • Obsolete Credentials property dropped from DataServiceContext class. The recommended way to configure credentials is through HttpClientHandler that can be provided using IHttpClientFactory.
  • Obsolete ReadWriteTimeout property dropped from DataServiceClientRequestMessage abstract class. This property would be used with HttpWebRequestMessage. Timeout property may be used instead.
  • Obsolete ReadWriteTimeout property dropped from HttpClientRequestMessage class. This property would be used with HttpWebRequestMessage. Timeout property may be used instead.
  • In DataServiceClientRequestMessageArgs class, the DataServiceClientRequestMessageArgs(string, Uri, bool, bool, IDictionary<string, string>) constructor has changed to DataServiceClientRequestMessageArgs(string, Uri, bool, IDictionary<string, string>). The boolean useDefaultCredentials parameter is no longer supported.
  • In DataServiceClientRequestMessageArgs class, the DataServiceClientRequestMessageArgs(string, Uri, bool, bool, IDictionary<string, string>, IHttpClientHandlerProvider) constructor has changed to DataServiceClientRequestMessageArgs(string, Uri, bool, IDictionary<string, string>, IHttpClientFactory). The boolean useDefaultCredentials parameter is no longer supported.
  • In DataServiceClientRequestMessageArgs class, the UseDefaultCredentials property dropped from DataServiceClientRequestMessageArgs class. The recommended way to configure credentials is through HttpClientHandler that can be provided using IHttpClientFactory.
  • HttpRequestTransportMode enum property was dropped from DataServiceContext. This property was used to switch between HttpClient and HttpWebRequest that was dropped.
  • KeyComparisonGeneratesFilterQuery flag defined in DataServiceContext class marked as deprecated. Flag will be removed in ODL 9.
    • Default value for keyComparisonGeneratesFilterQuery flag set to true such that a Where expression with only the key property in the predicate is translated into a $filter query rather a resouce URL for requesting a single entity.
  • Obsolete IncludeTotalCount() method was dropped from DataServiceQuery<TElement> class. Use IncludeCount() method.
  • Obsolete IncludeTotalCount(bool) method was dropped from DataServiceQuery<TElement> class: Use IncludeCount(bool) the method.
  • Obsolete TotalCount property was dropped from QueryOperationResponse class. Use Count property.
  • Obsolete TotalCount property was dropped from QueryOperationResponse<T> class. Use Count property.
  • Obsolete CreateODataDeltaReader(IEdmEntitySetBase, IEdmEntityType) method dropped from ODataMessageReader class. Use CreateODataDeltaResourceSetReader(IEdmEntitySetBase, IEdmStructuredType) method.
  • Obsolete CreateODataDeltaReaderAsync(IEdmEntitySetBase, IEdmEntityType) method dropped from ODataMessageReader class. Use CreateODataDeltaResourceSetReader(IEdmEntitySetBase, IEdmStructuredType) method.
  • Obsolete CreateODataDeltaWriter(IEdmEntitySetBase, IEdmEntityType) method dropped from ODataMessageReader class. Use CreateODataDeltaResourceSetWriter(IEdmEntitySetBase, IEdmStructuredType) method.
  • Obsolete CreateODataDeltaWriterAsync(IEdmEntitySetBase, IEdmEntityType) method dropped from ODataMessageReader class. Use CreateODataDeltaResourceSetWriterAsync(IEdmEntitySetBase, IEdmStructuredType) method.
  • Obsolete Expressions property dropped from AggregateToken class. Use AggregateExpressions property.
  • Obsolete Expressions property dropped from AggregateTransformationNode class. Use AggregateExpressions property.
  • Obsolete EntityTypeInvalidKeyKeyDefinedInBaseClass validation rule dropped from ValidationRules class. Use EntityTypeInvalidKeyKeyDefinedInAncestor validation rule.
  • Obsolete EntityTypeKeyMissingOnEntityType validation rule dropped from ValidationRules class. Use NavigationSourceTypeHasNoKeys validation rule.
  • IEdmEntityType EntityType property introduced in IEdmNavigationSource interface.
    • Any implementation of IEdmNavigationSource needs to implement the EntityType property.
    • The public EntityType(IEdmNavigationSource) static method has been marked as obsolete and will be removed in ODL 9.