//--------------------------------------------------------------------- // // Copyright (c) Microsoft Corporation. All rights reserved. // // // @owner [....] // @backupOwner [....] //--------------------------------------------------------------------- using System; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Text; using System.Data.Metadata.Edm; using System.Data.Common.Utils; using System.Diagnostics; using System.Linq; namespace System.Data.Mapping { using Triple = Pair>; /// /// Represents the Mapping metadata for an Extent in CS space. /// /// /// For Example if conceptually you could represent the CS MSL file as following /// --Mapping /// --EntityContainerMapping ( CNorthwind-->SNorthwind ) /// --EntitySetMapping /// --EntityTypeMapping /// --MappingFragment /// --EntityTypeMapping /// --MappingFragment /// --AssociationSetMapping /// --AssociationTypeMapping /// --MappingFragment /// This class represents the metadata for all the extent map elements in the /// above example namely EntitySetMapping, AssociationSetMapping and CompositionSetMapping. /// The SetMapping elements that are children of the EntityContainerMapping element /// can be accessed through the properties on this type. /// internal abstract class StorageSetMapping { #region Constructors /// /// Construct the new StorageSetMapping object. /// /// Extent metadata object /// The EntityContainer mapping that contains this extent mapping internal StorageSetMapping(EntitySetBase extent, StorageEntityContainerMapping entityContainerMapping) { this.m_entityContainerMapping = entityContainerMapping; this.m_extent = extent; this.m_typeMappings = new List(); } #endregion #region Fields /// /// The EntityContainer mapping that contains this extent mapping. /// private StorageEntityContainerMapping m_entityContainerMapping; /// /// The extent for which this mapping represents. /// private EntitySetBase m_extent; /// /// Set of type mappings that make up the Set Mapping. /// Unless this is a EntitySetMapping with inheritance, /// you would have a single type mapping per set. /// private List m_typeMappings; /// /// User defined Query View for the EntitySet. /// private string m_queryView; /// /// Line Number for Set Mapping element start tag. /// private int m_startLineNumber; /// /// Line position for Set Mapping element start tag. /// private int m_startLinePosition; /// /// Has modificationfunctionmapping for set mapping. /// private bool m_hasModificationFunctionMapping; /// /// Stores type-Specific user-defined QueryViews. /// private Dictionary m_typeSpecificQueryViews = new Dictionary(Triple.PairComparer.Instance); #endregion #region Properties /// /// The set for which this mapping is for /// internal EntitySetBase Set { get { return this.m_extent; } } ///// ///// TypeMappings that make up this set type. ///// For AssociationSet and CompositionSet there will be one type (at least that's what ///// we expect as of now). EntitySet could have mappings for multiple Entity types. ///// internal ReadOnlyCollection TypeMappings { get { return this.m_typeMappings.AsReadOnly(); } } internal StorageEntityContainerMapping EntityContainerMapping { get { return m_entityContainerMapping; } } /// /// Whether the SetMapping has empty content /// Returns true if there no table Mapping fragments /// internal virtual bool HasNoContent { get { if (QueryView != null) { return false; } foreach (StorageTypeMapping typeMap in TypeMappings) { foreach (StorageMappingFragment mapFragment in typeMap.MappingFragments) { foreach (StoragePropertyMapping propertyMap in mapFragment.AllProperties) { return false; } } } return true; } } internal string QueryView { get { return m_queryView; } set { m_queryView = value; } } /// /// Line Number in MSL file where the Set Mapping Element's Start Tag is present. /// internal int StartLineNumber { get { return m_startLineNumber; } set { m_startLineNumber = value; } } /// /// Line Position in MSL file where the Set Mapping Element's Start Tag is present. /// internal int StartLinePosition { get { return m_startLinePosition; } set { m_startLinePosition = value; } } internal bool HasModificationFunctionMapping { get { return m_hasModificationFunctionMapping; } set { m_hasModificationFunctionMapping = value; } } #endregion #region Methods /// /// Add type mapping as a child under this SetMapping /// /// internal void AddTypeMapping(StorageTypeMapping typeMapping) { this.m_typeMappings.Add(typeMapping); } /// /// This method is primarily for debugging purposes. /// Will be removed shortly. /// internal abstract void Print(int index); internal bool ContainsTypeSpecificQueryView(Triple key) { return m_typeSpecificQueryViews.ContainsKey(key); } /// /// Stores a type-specific user-defiend QueryView so that it can be loaded /// into StorageMappingItemCollection's view cache. /// internal void AddTypeSpecificQueryView(Triple key, string viewString) { Debug.Assert(!m_typeSpecificQueryViews.ContainsKey(key), "Query View already present for the given Key"); m_typeSpecificQueryViews.Add(key, viewString); } internal ReadOnlyCollection GetTypeSpecificQVKeys() { return new ReadOnlyCollection(m_typeSpecificQueryViews.Keys.ToList()); } internal string GetTypeSpecificQueryView(Triple key) { Debug.Assert(m_typeSpecificQueryViews.ContainsKey(key)); return m_typeSpecificQueryViews[key]; } #endregion } }