File: System\Data\Metadata\Edm\PrimitiveType.cs
Project: ndp\fx\src\DataEntity\System.Data.Entity.csproj (System.Data.Entity)
//---------------------------------------------------------------------
// <copyright file="PrimitiveType.cs" company="Microsoft">
//      Copyright (c) Microsoft Corporation.  All rights reserved.
// </copyright>
//
// @owner       Microsoft
// @backupOwner Microsoft
//---------------------------------------------------------------------
using System.Collections.Generic;
using System.Data.Common;
using System.Data.Common.Utils;
using System.Data.Spatial;
using System.Diagnostics;
using System.Linq;
 
namespace System.Data.Metadata.Edm
{
    /// <summary>
    /// Class representing a primitive type
    /// </summary>
    public sealed class PrimitiveType : SimpleType
    {
        #region constructors
        /// <summary>
        /// Initializes a new instance of PrimitiveType
        /// </summary>      
        internal PrimitiveType()
        {
            // No initialization of item attributes in here, it's used as a pass thru in the case for delay population
            // of item attributes
        }
 
        /// <summary>
        /// The constructor for PrimitiveType.  It takes the required information to identify this type.
        /// </summary>
        /// <param name="name">The name of this type</param>
        /// <param name="namespaceName">The namespace name of this type</param>
        /// <param name="version">The version of this type</param>
        /// <param name="dataSpace">dataSpace in which this primitive type belongs to</param>
        /// <param name="baseType">The primitive type that this type is derived from</param>
        /// <param name="providerManifest">The ProviderManifest of the provider of this type</param>
        /// <exception cref="System.ArgumentNullException">Thrown if name, namespaceName, version, baseType or providerManifest arguments are null</exception>
        internal PrimitiveType(string name,
                             string namespaceName,
                             DataSpace dataSpace,
                             PrimitiveType baseType,
                             DbProviderManifest providerManifest)
            : base(name, namespaceName, dataSpace)
        {
            EntityUtil.GenericCheckArgumentNull(baseType, "baseType");
            EntityUtil.GenericCheckArgumentNull(providerManifest, "providerManifest");
 
            this.BaseType = baseType;
 
            Initialize(this, baseType.PrimitiveTypeKind,
                false, // isDefault
                providerManifest);
        }
 
        /// <summary>
        /// The constructor for PrimitiveType, it takes in a CLR type containing the identity information
        /// </summary>
        /// <param name="clrType">The CLR type object for this primitive type</param>
        /// <param name="baseType">The base type for this primitive type</param>
        /// <param name="providerManifest">The ProviderManifest of the provider of this type</param>
        internal PrimitiveType(Type clrType,
                               PrimitiveType baseType,
                               DbProviderManifest providerManifest)
            : this(EntityUtil.GenericCheckArgumentNull(clrType, "clrType").Name, clrType.Namespace,
            DataSpace.OSpace, baseType, providerManifest)
        {
            Debug.Assert(clrType == ClrEquivalentType, "not equivalent to ClrEquivalentType");
        }
        #endregion
 
        #region Fields
        private PrimitiveTypeKind _primitiveTypeKind;
        private DbProviderManifest _providerManifest;
        #endregion
 
 
        #region Properties
        /// <summary>
        /// Returns the kind of the type
        /// </summary>
        public override BuiltInTypeKind BuiltInTypeKind { get { return BuiltInTypeKind.PrimitiveType; } }
 
        /// <summary>
        /// </summary>
        internal override System.Type ClrType
        {
            get { return ClrEquivalentType; }
        }
 
        /// <summary>
        /// Returns the PrimitiveTypeKind enumeration value indicating what kind of primitive type this is
        /// </summary>
        /// <returns>A PrimitiveTypeKind value</returns>
        [MetadataProperty(BuiltInTypeKind.PrimitiveTypeKind, false)]
        public PrimitiveTypeKind PrimitiveTypeKind
        {
            get
            {
                return _primitiveTypeKind;
            }
            internal set
            {
                _primitiveTypeKind = value;
            }
        }
 
        /// <summary>
        /// Returns the ProviderManifest giving access to the Manifest that this type came from
        /// </summary>
        /// <returns>The types ProviderManifest value</returns>
        internal DbProviderManifest ProviderManifest
        {
            get
            {
                Debug.Assert(_providerManifest != null, "This primitive type should have been added to a manifest, which should have set this");
                return _providerManifest;
            }
            set
            {
                Debug.Assert(value != null, "This primitive type should have been added to a manifest, which should have set this");
                _providerManifest = value;
            }
        }
 
        /// <summary>
        /// Gets the FacetDescriptions for this type
        /// </summary>
        /// <returns>The FacetDescritions for this type.</returns>
        public System.Collections.ObjectModel.ReadOnlyCollection<FacetDescription> FacetDescriptions
        {
            get
            {
                return ProviderManifest.GetFacetDescriptions(this);
            }
        }
 
        /// <summary>
        /// Returns an equivalent CLR type representing this primitive type
        /// </summary>
        public Type ClrEquivalentType
        {
            get
            {
                switch (PrimitiveTypeKind)
                {
                    case PrimitiveTypeKind.Binary:
                        return typeof(byte[]);
                    case PrimitiveTypeKind.Boolean:
                        return typeof(bool);
                    case PrimitiveTypeKind.Byte:
                        return typeof(byte);
                    case PrimitiveTypeKind.DateTime:
                        return typeof(DateTime);
                    case PrimitiveTypeKind.Time:
                        return typeof(TimeSpan);
                    case PrimitiveTypeKind.DateTimeOffset:
                        return typeof(DateTimeOffset);
                    case PrimitiveTypeKind.Decimal:
                        return typeof(decimal);
                    case PrimitiveTypeKind.Double:
                        return typeof(double);
                    case PrimitiveTypeKind.Geography:
                    case PrimitiveTypeKind.GeographyPoint:
                    case PrimitiveTypeKind.GeographyLineString:
                    case PrimitiveTypeKind.GeographyPolygon:
                    case PrimitiveTypeKind.GeographyMultiPoint:
                    case PrimitiveTypeKind.GeographyMultiLineString:
                    case PrimitiveTypeKind.GeographyMultiPolygon:
                    case PrimitiveTypeKind.GeographyCollection:
                        return typeof(DbGeography);
                    case PrimitiveTypeKind.Geometry:
                    case PrimitiveTypeKind.GeometryPoint:
                    case PrimitiveTypeKind.GeometryLineString:
                    case PrimitiveTypeKind.GeometryPolygon:
                    case PrimitiveTypeKind.GeometryMultiPoint:
                    case PrimitiveTypeKind.GeometryMultiLineString:
                    case PrimitiveTypeKind.GeometryMultiPolygon:
                    case PrimitiveTypeKind.GeometryCollection:
                        return typeof(DbGeometry);
                    case PrimitiveTypeKind.Guid:
                        return typeof(Guid);
                    case PrimitiveTypeKind.Single:
                        return typeof(Single);
                    case PrimitiveTypeKind.SByte:
                        return typeof(sbyte);
                    case PrimitiveTypeKind.Int16:
                        return typeof(short);
                    case PrimitiveTypeKind.Int32:
                        return typeof(int);
                    case PrimitiveTypeKind.Int64:
                        return typeof(long);
                    case PrimitiveTypeKind.String:
                        return typeof(string);
                }
 
                return null;
            }
        }
        #endregion
 
        #region Methods
        internal override IEnumerable<FacetDescription> GetAssociatedFacetDescriptions()
        {
            // return all general facets and facets associated with this type
            return base.GetAssociatedFacetDescriptions().Concat(this.FacetDescriptions);
        }
 
        /// <summary>
        /// Perform initialization that's common across all constructors
        /// </summary>
        /// <param name="primitiveType">The primitive type to initialize</param>
        /// <param name="primitiveTypeKind">The primitive type kind of this primitive type</param>
        /// <param name="isDefaultType">When true this is the default type to return when a type is asked for by PrimitiveTypeKind</param>
        /// <param name="providerManifest">The ProviderManifest of the provider of this type</param>
        internal static void Initialize(PrimitiveType primitiveType,
                                                      PrimitiveTypeKind primitiveTypeKind,
                                                      bool isDefaultType,
                                                      DbProviderManifest providerManifest)
        {
            primitiveType._primitiveTypeKind = primitiveTypeKind;
            primitiveType._providerManifest = providerManifest;
        }
 
        /// <summary>
        /// return the model equivalent type for this type,
        /// for example if this instance is nvarchar and it's
        /// base type is Edm String then the return type is Edm String.
        /// If the type is actually already a model type then the 
        /// return type is "this".
        /// </summary>
        /// <returns></returns>
        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Edm")]
        public EdmType GetEdmPrimitiveType()
        {
            return MetadataItem.EdmProviderManifest.GetPrimitiveType(PrimitiveTypeKind);
        }
 
        /// <summary>
        /// Returns the list of EDM primitive types
        /// </summary>
        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Edm")]
        public static System.Collections.ObjectModel.ReadOnlyCollection<PrimitiveType> GetEdmPrimitiveTypes()
        {
            return EdmProviderManifest.GetStoreTypes();
        }
 
        [System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1704:IdentifiersShouldBeSpelledCorrectly", MessageId = "Edm")]
        public static PrimitiveType GetEdmPrimitiveType(PrimitiveTypeKind primitiveTypeKind)
        {
            return MetadataItem.EdmProviderManifest.GetPrimitiveType(primitiveTypeKind);
        }
        #endregion
    }
}