/// <summary>
/// Validate ResourcePath for given ODataContextUrlInfo for individual property.
/// </summary>
/// <param name="contextUrlInfo">The ODataContextUrlInfo to evaluate on.</param>
private static void ValidateResourcePath(ODataContextUrlInfo contextUrlInfo)
{
if (string.IsNullOrEmpty(contextUrlInfo.ResourcePath))
{
throw new ODataException(Strings.ODataContextUriBuilder_ODataUriMissingForIndividualProperty);
}
}
/// <summary>
/// Create contextUrlInfo for delta
/// </summary>
/// <param name="typeContext">The ODataResourceTypeContext to be used.</param>
/// <param name="version">The OData version of the response.</param>
/// <param name="kind">The delta kind.</param>
/// <param name="odataUri">The odata uri info for current query.</param>
/// <returns>The generated ODataContextUrlInfo.</returns>
internal static ODataContextUrlInfo Create(ODataResourceTypeContext typeContext, ODataVersion version, ODataDeltaKind kind, ODataUri odataUri = null)
{
Debug.Assert(typeContext != null, "typeContext != null");
ODataContextUrlInfo contextUriInfo = new ODataContextUrlInfo()
{
IsUnknownEntitySet = typeContext.NavigationSourceKind == EdmNavigationSourceKind.UnknownEntitySet,
NavigationSource = typeContext.NavigationSourceName,
TypeCast = typeContext.NavigationSourceEntityTypeName == typeContext.ExpectedResourceTypeName ? null : typeContext.ExpectedResourceTypeName,
TypeName = typeContext.NavigationSourceEntityTypeName,
IncludeFragmentItemSelector = kind == ODataDeltaKind.Resource && typeContext.NavigationSourceKind != EdmNavigationSourceKind.Singleton,
DeltaKind = kind,
NavigationPath = ComputeNavigationPath(typeContext.NavigationSourceKind, null, typeContext.NavigationSourceName),
};
// Only use odata uri in with model case.
if (typeContext is ODataResourceTypeContext.ODataResourceTypeContextWithModel)
{
contextUriInfo.NavigationPath = ComputeNavigationPath(typeContext.NavigationSourceKind, odataUri,
typeContext.NavigationSourceName);
contextUriInfo.ResourcePath = ComputeResourcePath(odataUri);
contextUriInfo.QueryClause = ComputeQueryClause(odataUri, version);
contextUriInfo.IsUndeclared = ComputeIfIsUndeclared(odataUri);
}
return(contextUriInfo);
}
/// <summary>
/// Validate NavigationSource for given ODataContextUrlInfo for resource or resource set.
/// </summary>
/// <param name="contextUrlInfo">The ODataContextUrlInfo to evaluate on.</param>
private static void ValidateNavigationSource(ODataContextUrlInfo contextUrlInfo)
{
// For complex or complex collection property, it doesn't have any navigation source,
// Then the TypeName should be provided.
if (!contextUrlInfo.HasNavigationSourceInfo)
{
if (string.IsNullOrEmpty(contextUrlInfo.TypeName))
{
throw new ODataException(Strings.ODataContextUriBuilder_NavigationSourceOrTypeNameMissingForResourceOrResourceSet);
}
return;
}
// For navigation property without navigation target, navigation path should be null so
// validate its navigation source (should be the name of the navigation property) which
// at least requires EdmUnknownEntitySet to be present; otherwise validate its navigation
// path as before.
if (!contextUrlInfo.IsUnknownEntitySet && string.IsNullOrEmpty(contextUrlInfo.NavigationPath) ||
contextUrlInfo.IsUnknownEntitySet && string.IsNullOrEmpty(contextUrlInfo.NavigationSource) &&
string.IsNullOrEmpty(contextUrlInfo.TypeName))
{
throw new ODataException(Strings.ODataContextUriBuilder_NavigationSourceOrTypeNameMissingForResourceOrResourceSet);
}
}
/// <summary>
/// Validate TypeName for given ODataContextUrlInfo for collection.
/// </summary>
/// <param name="contextUrlInfo">The ODataContextUrlInfo to evaluate on.</param>
private static void ValidateCollectionType(ODataContextUrlInfo contextUrlInfo)
{
if (string.IsNullOrEmpty(contextUrlInfo.TypeName))
{
throw new ODataException(Strings.ODataContextUriBuilder_TypeNameMissingForTopLevelCollection);
}
}
/// <summary>
/// Validate TypeName for given ODataContextUrlInfo for property.
/// </summary>
/// <param name="contextUrlInfo">The ODataContextUrlInfo to evaluate on.</param>
private static void ValidateType(ODataContextUrlInfo contextUrlInfo)
{
if (string.IsNullOrEmpty(contextUrlInfo.TypeName))
{
throw new ODataException(Strings.ODataContextUriBuilder_TypeNameMissingForProperty);
}
}
/// <summary>
/// Append type cast and query clause info to string builder if any.
/// </summary>
/// <param name="builder">The string builder to append info.</param>
/// <param name="info">The ODataContextUrlInfo includes type cast and query clause info.</param>
private static void AppendTypeCastAndQueryClause(StringBuilder builder, ODataContextUrlInfo info)
{
// #ContainerName.NavigationSourceName ==> #ContainerName.NavigationSourceName/Namespace.DerivedTypeName
if (!string.IsNullOrEmpty(info.TypeCast))
{
builder.Append(ODataConstants.UriSegmentSeparatorChar);
builder.Append(info.TypeCast);
}
// #ContainerName.NavigationSourceName ==> #ContainerName.NavigationSourceName(selectedPropertyList)
if (!string.IsNullOrEmpty(info.QueryClause))
{
builder.Append(info.QueryClause);
}
}
/// <summary>
/// Determine whether current contextUrlInfo could be determined from parent contextUrlInfo.
/// </summary>
/// <param name="parentContextUrlInfo">The parent contextUrlInfo.</param>
/// <returns>Whether current contextUrlInfo could be determined from parent contextUrlInfo.</returns>
internal bool IsHiddenBy(ODataContextUrlInfo parentContextUrlInfo)
{
if (parentContextUrlInfo == null)
{
return(false);
}
if (parentContextUrlInfo.NavigationPath == NavigationPath &&
parentContextUrlInfo.DeltaKind == ODataDeltaKind.ResourceSet &&
this.DeltaKind == ODataDeltaKind.Resource)
{
return(true);
}
return(false);
}
/// <summary>
/// Create context URL from ODataPayloadKind and ODataContextUrlInfo.
/// should make the context uri correct for null primitive / null enum value / normal enum value
/// ODataEnumValue is allowed to have null or arbitrary TypeName, but the output ContextUri must have correct type name.
/// </summary>
/// <param name="payloadKind">The ODataPayloadKind for the context URI.</param>
/// <param name="contextInfo">The ODataContextUrlInfo to be used.</param>
/// <returns>The generated context url.</returns>
internal Uri BuildContextUri(ODataPayloadKind payloadKind, ODataContextUrlInfo contextInfo = null)
{
if (this.baseContextUrl == null)
{
return(null);
}
Action <ODataContextUrlInfo> verifyAction;
if (ValidationDictionary.TryGetValue(payloadKind, out verifyAction))
{
if (verifyAction != null && throwIfMissingInfo)
{
Debug.Assert(contextInfo != null, "contextInfo != null");
verifyAction(contextInfo);
}
}
else
{
throw new ODataException(Strings.ODataContextUriBuilder_UnsupportedPayloadKind(payloadKind.ToString()));
}
switch (payloadKind)
{
case ODataPayloadKind.ServiceDocument:
return(this.baseContextUrl);
case ODataPayloadKind.EntityReferenceLink:
return(new Uri(this.baseContextUrl, ODataConstants.SingleEntityReferencesContextUrlSegment));
case ODataPayloadKind.EntityReferenceLinks:
return(new Uri(this.baseContextUrl, ODataConstants.CollectionOfEntityReferencesContextUrlSegment));
}
return(CreateFromContextUrlInfo(contextInfo));
}
/// <summary>
/// Validate the given ODataContextUrlInfo for delta
/// </summary>
/// <param name="contextUrlInfo">The ODataContextUrlInfo to evaluate on.</param>
private static void ValidateDelta(ODataContextUrlInfo contextUrlInfo)
{
Debug.Assert(contextUrlInfo.DeltaKind != ODataDeltaKind.None, "contextUrlInfo.DeltaKind != ODataDeltaKind.None");
}
/// <summary>
/// Create context URL from ODataContextUrlInfo.
/// </summary>
/// <param name="info">The ODataContextUrlInfo to be used.</param>
/// <returns>The generated context url.</returns>
private Uri CreateFromContextUrlInfo(ODataContextUrlInfo info)
{
StringBuilder builder = new StringBuilder();
// #
builder.Append(ODataConstants.ContextUriFragmentIndicator);
if (!string.IsNullOrEmpty(info.ResourcePath))
{
builder.Append(info.ResourcePath);
// For navigation property under complex property
if (info.DeltaKind == ODataDeltaKind.None)
{
AppendTypeCastAndQueryClause(builder, info);
}
}
else if (!string.IsNullOrEmpty(info.NavigationPath))
{
// #ContainerName.NavigationSourceName
builder.Append(info.NavigationPath);
if (info.DeltaKind == ODataDeltaKind.None || info.DeltaKind == ODataDeltaKind.ResourceSet || info.DeltaKind == ODataDeltaKind.Resource)
{
AppendTypeCastAndQueryClause(builder, info);
}
switch (info.DeltaKind)
{
case ODataDeltaKind.None:
case ODataDeltaKind.Resource:
if (info.IncludeFragmentItemSelector)
{
// #ContainerName.NavigationSourceName ==> #ContainerName.NavigationSourceName/$entity
builder.Append(ODataConstants.ContextUriFragmentItemSelector);
}
break;
case ODataDeltaKind.ResourceSet:
builder.Append(ODataConstants.ContextUriDeltaResourceSet);
break;
case ODataDeltaKind.DeletedEntry:
builder.Append(ODataConstants.ContextUriDeletedEntry);
break;
case ODataDeltaKind.Link:
builder.Append(ODataConstants.ContextUriDeltaLink);
break;
case ODataDeltaKind.DeletedLink:
builder.Append(ODataConstants.ContextUriDeletedLink);
break;
}
}
else
{
// No path information
switch (info.DeltaKind)
{
case ODataDeltaKind.ResourceSet:
return(new Uri(ODataConstants.ContextUriFragmentIndicator + ODataConstants.DeltaResourceSet, UriKind.Relative));
case ODataDeltaKind.DeletedEntry:
return(new Uri(ODataConstants.ContextUriFragmentIndicator + ODataConstants.DeletedEntry, UriKind.Relative));
case ODataDeltaKind.Link:
return(new Uri(ODataConstants.ContextUriFragmentIndicator + ODataConstants.DeltaLink, UriKind.Relative));
case ODataDeltaKind.DeletedLink:
return(new Uri(ODataConstants.ContextUriFragmentIndicator + ODataConstants.DeletedLink, UriKind.Relative));
}
if (!string.IsNullOrEmpty(info.TypeName))
{ // #TypeName
builder.Append(info.TypeName);
}
else
{
return(null);
}
}
return(new Uri(this.baseContextUrl, builder.ToString()));
}