/// <summary>
        /// Read the deleted resource.
        /// </summary>
        /// <param name="reader">The OData reader.</param>
        /// <param name="itemsStack">The item stack.</param>
        private static void ReadDeletedResource(ODataReader reader, Stack <ODataItemWrapper> itemsStack)
        {
            Contract.Assert(reader != null);
            Contract.Assert(itemsStack != null);
            Contract.Assert(ODataReaderState.DeletedResourceStart == reader.State);

            ODataDeletedResource deletedResource = (ODataDeletedResource)reader.Item;

            Contract.Assert(deletedResource != null, "Deleted resource should not be null");

            ODataDeletedResourceWrapper deletedResourceWrapper = new ODataDeletedResourceWrapper(deletedResource);

            // top-level resource should never be deleted.
            Contract.Assert(itemsStack.Count != 0, "Deleted Resource should not be top level item");

            ODataItemWrapper             parentItem = itemsStack.Peek();
            ODataDeltaResourceSetWrapper parentDeletaResourceSet = parentItem as ODataDeltaResourceSetWrapper;

            if (parentDeletaResourceSet != null)
            {
                parentDeletaResourceSet.DeltaItems.Add(deletedResourceWrapper);
            }
            else
            {
                ODataNestedResourceInfoWrapper parentNestedResource = (ODataNestedResourceInfoWrapper)itemsStack.Peek();
                Contract.Assert(parentNestedResource.NestedResourceInfo.IsCollection == false, "Only singleton nested properties can contain resource as their child.");
                Contract.Assert(parentNestedResource.NestedResourceSet == null, "Each single nested property can not contain resource set.");
                Contract.Assert(parentNestedResource.NestedResource == null, "Each single nested property can not contain multiple resources as its direct child.");
                Contract.Assert(parentNestedResource.NestedLinks == null, "Each single nested property can not contain reference link as its direct child.");
                parentNestedResource.NestedResource = deletedResourceWrapper;
            }

            itemsStack.Push(deletedResourceWrapper);
        }
        /// <summary>
        /// Read OData item.
        /// </summary>
        /// <param name="reader">The odata reader.</param>
        /// <param name="itemsStack">The item stack.</param>
        /// <param name="topLevelItem">The top level item.</param>
        private static void ReadODataItem(ODataReader reader, Stack <ODataItemWrapper> itemsStack, ref ODataItemWrapper topLevelItem)
        {
            Contract.Assert(reader != null);
            Contract.Assert(itemsStack != null);

            switch (reader.State)
            {
            case ODataReaderState.ResourceStart:
                ReadResource(reader, itemsStack, ref topLevelItem);
                break;

            case ODataReaderState.DeletedResourceStart:
                ReadDeletedResource(reader, itemsStack);
                break;

            case ODataReaderState.ResourceEnd:
                Contract.Assert(itemsStack.Count > 0, "The resource which is ending should be on the top of the items stack.");
                ODataResourceWrapper resourceWrapper = itemsStack.Peek() as ODataResourceWrapper;
                if (resourceWrapper != null)
                {
                    // Resource could be null
                    Contract.Assert(resourceWrapper.Resource == reader.Item, "The resource should be the same item in the reader.");
                }

                itemsStack.Pop();
                break;

            case ODataReaderState.DeletedResourceEnd:
                Contract.Assert(itemsStack.Count > 0, "The deleted resource which is ending should be on the top of the items stack.");
                ODataDeletedResourceWrapper deletedResourceWrapper = itemsStack.Peek() as ODataDeletedResourceWrapper;
                Contract.Assert(deletedResourceWrapper != null, "The top object in the stack should be delete resource wrapper.");
                Contract.Assert(deletedResourceWrapper.DeletedResource == reader.Item, "The deleted resource should be the same item in the reader.");
                itemsStack.Pop();
                break;

            case ODataReaderState.NestedResourceInfoStart:
                ODataNestedResourceInfo nestedResourceInfo = (ODataNestedResourceInfo)reader.Item;
                Contract.Assert(nestedResourceInfo != null, "nested resource info should never be null.");

                ODataNestedResourceInfoWrapper nestedResourceInfoWrapper = new ODataNestedResourceInfoWrapper(nestedResourceInfo);
                Contract.Assert(itemsStack.Count > 0, "nested resource info can't appear as top-level item.");
                {
                    ODataResourceBaseWrapper parentResource = (ODataResourceBaseWrapper)itemsStack.Peek();
                    parentResource.NestedResourceInfos.Add(nestedResourceInfoWrapper);
                }

                itemsStack.Push(nestedResourceInfoWrapper);
                break;

            case ODataReaderState.NestedResourceInfoEnd:
                Contract.Assert(itemsStack.Count > 0, "The nested resource info which is ending should be on the top of the items stack.");
                ODataNestedResourceInfoWrapper nestedInfoWrapper = itemsStack.Peek() as ODataNestedResourceInfoWrapper;
                Contract.Assert(nestedInfoWrapper != null, "The top object in the stack should be nested resource info wrapper.");
                Contract.Assert(nestedInfoWrapper.NestedResourceInfo == reader.Item, "The nested resource info should be the same item in the reader.");
                itemsStack.Pop();
                break;

            case ODataReaderState.ResourceSetStart:     // resource set
                ReadResourceSet(reader, itemsStack, ref topLevelItem);
                break;

            case ODataReaderState.DeltaResourceSetStart:     // delta resource set
                ReadDeltaResourceSet(reader, itemsStack, ref topLevelItem);
                break;

            case ODataReaderState.ResourceSetEnd:
                Contract.Assert(itemsStack.Count > 0, "The resource set which is ending should be on the top of the items stack.");
                ODataResourceSetWrapper resourceSetWrapper = itemsStack.Peek() as ODataResourceSetWrapper;
                Contract.Assert(resourceSetWrapper != null, "The top object in the stack should be resource set wrapper.");
                Contract.Assert(resourceSetWrapper.ResourceSet == reader.Item, "The resource set should be the same item in the reader.");
                itemsStack.Pop();
                break;

            case ODataReaderState.DeltaResourceSetEnd:
                Contract.Assert(itemsStack.Count > 0, "The delta resource set which is ending should be on the top of the items stack.");
                ODataDeltaResourceSetWrapper deltaResourceSetWrapper = itemsStack.Peek() as ODataDeltaResourceSetWrapper;
                Contract.Assert(deltaResourceSetWrapper != null, "The top object in the stack should be delta resource set wrapper.");
                Contract.Assert(deltaResourceSetWrapper.DeltaResourceSet == reader.Item, "The delta resource set should be the same item in the reader.");
                itemsStack.Pop();
                break;

            case ODataReaderState.EntityReferenceLink:
                ODataEntityReferenceLink entityReferenceLink = (ODataEntityReferenceLink)reader.Item;
                Contract.Assert(entityReferenceLink != null, "Entity reference link should never be null.");
                ODataEntityReferenceLinkWrapper entityReferenceLinkWrapper = new ODataEntityReferenceLinkWrapper(entityReferenceLink);

                Contract.Assert(itemsStack.Count > 0, "Entity reference link should never be reported as top-level item.");
                {
                    ODataNestedResourceInfoWrapper parentNestedResource = (ODataNestedResourceInfoWrapper)itemsStack.Peek();
                    Contract.Assert(parentNestedResource.NestedResourceSet == null, "Each reference nested property can not contain resource set as its direct child.");
                    Contract.Assert(parentNestedResource.NestedResource == null, "Each reference nested property can not contain resource as its direct child.");
                    parentNestedResource.AppendReferenceLink(entityReferenceLinkWrapper);
                }

                break;

            case ODataReaderState.DeltaLink:        // added link
            case ODataReaderState.DeltaDeletedLink: // deleted link
                ODataDeltaLinkBaseWrapper linkBaseWrapper;
                if (ODataReaderState.DeltaLink == reader.State)
                {
                    ODataDeltaLink deltaLink = (ODataDeltaLink)reader.Item;
                    Contract.Assert(deltaLink != null, "Delta link should never be null.");
                    linkBaseWrapper = new ODataDeltaLinkWrapper(deltaLink);
                }
                else
                {
                    ODataDeltaDeletedLink deltaDeletedLink = (ODataDeltaDeletedLink)reader.Item;
                    Contract.Assert(deltaDeletedLink != null, "Delta deleted link should never be null.");
                    linkBaseWrapper = new ODataDeltaDeletedLinkWrapper(deltaDeletedLink);
                }

                Contract.Assert(itemsStack.Count > 0, "Delta link should never be reported as top-level item.");
                // Should never add a delta link to a non-delta resource set.
                ODataDeltaResourceSetWrapper linkResourceSetWrapper = (ODataDeltaResourceSetWrapper)itemsStack.Peek();
                Contract.Assert(linkResourceSetWrapper != null, "ODataDeltaResourceSetWrapper for delta link should not be null.");
                linkResourceSetWrapper.DeltaItems.Add(linkBaseWrapper);
                break;

            default:
                Contract.Assert(false, "We should never get here, it means the ODataReader reported a wrong state.");
                break;
            }
        }