/// <summary>
/// Sets the 'DataServiceVersion' HTTP header on the message based on the protocol version specified in the settings.
/// </summary>
/// <param name="message">The message to set the data service version header on.</param>
/// <param name="settings">The <see cref="ODataMessageWriterSettings"/> determining the protocol version to use.</param>
internal static void SetDataServiceVersion(ODataMessage message, ODataMessageWriterSettings settings)
{
DebugUtils.CheckNoExternalCallers();
Debug.Assert(message != null, "message != null");
Debug.Assert(settings != null, "settings != null");
Debug.Assert(settings.Version.HasValue, "settings.Version.HasValue");
string dataServiceVersionString = ODataUtils.ODataVersionToString(settings.Version.Value) + ";";
message.SetHeader(ODataConstants.DataServiceVersionHeader, dataServiceVersionString);
}
internal static void CheckVersionSupported(ODataVersion version, ODataMessageReaderSettings messageReaderSettings)
{
DebugUtils.CheckNoExternalCallers();
Debug.Assert(messageReaderSettings != null, "messageReaderSettings != null");
if (version > messageReaderSettings.MaxProtocolVersion)
{
throw new ODataException(Strings.ODataVersionChecker_MaxProtocolVersionExceeded(
ODataUtils.ODataVersionToString(version),
ODataUtils.ODataVersionToString(messageReaderSettings.MaxProtocolVersion)));
}
#if DISABLE_V3
if (version >= ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_ProtocolVersion3IsNotSupported);
}
#endif
}
/// <summary>
/// Check whether the EPM on the specified entity type is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
/// <param name="entityType">The entity type to check.</param>
/// <param name="model">The model containing annotations for the entity type.</param>
internal static void CheckEntityPropertyMapping(ODataVersion version, IEdmEntityType entityType, IEdmModel model)
{
DebugUtils.CheckNoExternalCallers();
Debug.Assert(entityType != null, "entityType != null");
Debug.Assert(model != null, "model != null");
ODataEntityPropertyMappingCache epmCache = model.GetEpmCache(entityType);
if (epmCache != null)
{
Debug.Assert(epmCache.EpmTargetTree != null, "If the EPM annotation is present the EPM tree must already be initialized.");
if (version < epmCache.EpmTargetTree.MinimumODataProtocolVersion)
{
throw new ODataException(
Strings.ODataVersionChecker_EpmVersionNotSupported(
entityType.ODataFullName(),
ODataUtils.ODataVersionToString(epmCache.EpmTargetTree.MinimumODataProtocolVersion),
ODataUtils.ODataVersionToString(version)));
}
}
}
/// <summary>
/// Check whether the spatial value is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckSpatialValue(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_GeographyAndGeometryNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
/// <summary>
/// Check whether parameters in the payload are supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckParameterPayload(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_ParameterPayloadNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
/// <summary>
/// Check whether the custom Data Namespace feature is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckCustomDataNamespace(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version > ODataVersion.V2)
{
throw new ODataException(Strings.ODataVersionChecker_PropertyNotSupportedForODataVersionGreaterThanX("DataNamespace", ODataUtils.ODataVersionToString(ODataVersion.V2)));
}
}
internal static void CheckCollectionValueProperties(ODataVersion version, string propertyName)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_CollectionPropertiesNotSupported(propertyName, ODataUtils.ODataVersionToString(version)));
}
}
/// <summary>
/// Check whether the named streams feature is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckStreamReferenceProperty(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_StreamPropertiesNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
/// <summary>
/// Check whether CollectionValue is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckCollectionValue(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_CollectionNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckSpatialValue(ODataVersion version)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_GeographyAndGeometryNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckAssociationLinks(ODataVersion version)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_AssociationLinksNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckParameterPayload(ODataVersion version)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_ParameterPayloadNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckNextLink(ODataVersion version)
{
if (version < ODataVersion.V2)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_NextLinkNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckEntityPropertyMapping(ODataVersion version, IEdmEntityType entityType, IEdmModel model)
{
ODataEntityPropertyMappingCache epmCache = model.GetEpmCache(entityType);
if ((epmCache != null) && (version < epmCache.EpmTargetTree.MinimumODataProtocolVersion))
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_EpmVersionNotSupported(entityType.ODataFullName(), ODataUtils.ODataVersionToString(epmCache.EpmTargetTree.MinimumODataProtocolVersion), ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckCustomTypeScheme(ODataVersion version)
{
if (version > ODataVersion.V2)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_PropertyNotSupportedForODataVersionGreaterThanX("TypeScheme", ODataUtils.ODataVersionToString(ODataVersion.V2)));
}
}
/// <summary>
/// Check whether CollectionValue properties are supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
/// <param name="propertyName">The name of the property which holds the collection.</param>
internal static void CheckCollectionValueProperties(ODataVersion version, string propertyName)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V3)
{
throw new ODataException(Strings.ODataVersionChecker_CollectionPropertiesNotSupported(propertyName, ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckStreamReferenceProperty(ODataVersion version)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_StreamPropertiesNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
/// <summary>
/// Check whether the next link feature is supported in the specified version.
/// </summary>
/// <param name="version">The version to check.</param>
internal static void CheckNextLink(ODataVersion version)
{
DebugUtils.CheckNoExternalCallers();
if (version < ODataVersion.V2)
{
throw new ODataException(Strings.ODataVersionChecker_NextLinkNotSupported(ODataUtils.ODataVersionToString(version)));
}
}
internal static void CheckVersionSupported(ODataVersion version, ODataMessageReaderSettings messageReaderSettings)
{
if (version > messageReaderSettings.MaxProtocolVersion)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_MaxProtocolVersionExceeded(ODataUtils.ODataVersionToString(version), ODataUtils.ODataVersionToString(messageReaderSettings.MaxProtocolVersion)));
}
}
internal static void SetDataServiceVersion(ODataMessage message, ODataMessageWriterSettings settings)
{
string headerValue = ODataUtils.ODataVersionToString(settings.Version.Value) + ";";
message.SetHeader("DataServiceVersion", headerValue);
}
internal static void CheckCollectionValue(ODataVersion version)
{
if (version < ODataVersion.V3)
{
throw new ODataException(Microsoft.Data.OData.Strings.ODataVersionChecker_CollectionNotSupported(ODataUtils.ODataVersionToString(version)));
}
}