//--------------------------------------------------------------------- // // Copyright (c) Microsoft Corporation. All rights reserved. // // // @owner Microsoft // @backupOwner Microsoft //--------------------------------------------------------------------- namespace System.Data.EntityModel.SchemaObjectModel { using System.Collections.Generic; using System.Data.Metadata.Edm; using System.Diagnostics; using System.Xml; /// /// Represents an End element in a relationship /// internal sealed class RelationshipEnd : SchemaElement, IRelationshipEnd { private string _unresolvedType; private RelationshipMultiplicity? _multiplicity; private SchemaEntityType _type; private List _operations; /// /// construct a Relationship End /// /// public RelationshipEnd(Relationship relationship) : base(relationship) { } /// /// Type of the End /// public SchemaEntityType Type { get { return _type; } private set { _type = value; } } /// /// Multiplicity of the End /// public RelationshipMultiplicity? Multiplicity { get { return _multiplicity; } set { _multiplicity = value; } } /// /// The On<Operation>s defined for the End /// public ICollection Operations { get { if (_operations == null) _operations = new List(); return _operations; } } /// /// do whole element resolution /// internal override void ResolveTopLevelNames() { base.ResolveTopLevelNames(); if (Type == null && _unresolvedType != null) { SchemaType element; if (!Schema.ResolveTypeName(this, _unresolvedType, out element)) { return; } Type = element as SchemaEntityType; if (Type == null) { AddError(ErrorCode.InvalidRelationshipEndType, EdmSchemaErrorSeverity.Error, System.Data.Entity.Strings.InvalidRelationshipEndType(ParentElement.Name, element.FQName)); } } } internal override void Validate() { base.Validate(); // Check if the end has multiplicity as many, it cannot have any operation behaviour if (Multiplicity == RelationshipMultiplicity.Many && Operations.Count != 0) { AddError(ErrorCode.EndWithManyMultiplicityCannotHaveOperationsSpecified, EdmSchemaErrorSeverity.Error, System.Data.Entity.Strings.EndWithManyMultiplicityCannotHaveOperationsSpecified(this.Name, ParentElement.FQName)); } // if there is no RefConstraint in Association and multiplicity is null if (this.ParentElement.Constraints.Count == 0 && Multiplicity == null) { AddError(ErrorCode.EndWithoutMultiplicity, EdmSchemaErrorSeverity.Error, System.Data.Entity.Strings.EndWithoutMultiplicity(this.Name, ParentElement.FQName)); } } /// /// Do simple validation across attributes /// protected override void HandleAttributesComplete() { // set up the default name in before validating anythig that might want to display it in an error message; if (Name == null && _unresolvedType != null) Name = Utils.ExtractTypeName(Schema.DataModel, _unresolvedType); base.HandleAttributesComplete(); } protected override bool ProhibitAttribute(string namespaceUri, string localName) { if (base.ProhibitAttribute(namespaceUri, localName)) { return true; } if (namespaceUri == null && localName == XmlConstants.Name) { return false; } return false; } protected override bool HandleAttribute(XmlReader reader) { if (base.HandleAttribute(reader)) { return true; } else if (CanHandleAttribute(reader, XmlConstants.Multiplicity)) { HandleMultiplicityAttribute(reader); return true; } else if (CanHandleAttribute(reader, XmlConstants.Role)) { HandleNameAttribute(reader); return true; } else if (CanHandleAttribute(reader, XmlConstants.TypeElement)) { HandleTypeAttribute(reader); return true; } return false; } protected override bool HandleElement(XmlReader reader) { if (base.HandleElement(reader)) { return true; } else if (CanHandleElement(reader, XmlConstants.OnDelete)) { HandleOnDeleteElement(reader); return true; } return false; } /// /// Handle the Type attribute /// /// reader positioned at Type attribute private void HandleTypeAttribute(XmlReader reader) { Debug.Assert(reader != null); string type; if (!Utils.GetDottedName(this.Schema, reader, out type)) return; _unresolvedType = type; } /// /// Handle the Multiplicity attribute /// /// reader positioned at Type attribute private void HandleMultiplicityAttribute(XmlReader reader) { Debug.Assert(reader != null); RelationshipMultiplicity multiplicity; if (!TryParseMultiplicity(reader.Value, out multiplicity)) { AddError(ErrorCode.InvalidMultiplicity, EdmSchemaErrorSeverity.Error, reader, System.Data.Entity.Strings.InvalidRelationshipEndMultiplicity(ParentElement.Name, reader.Value)); } _multiplicity = multiplicity; } /// /// Handle an OnDelete element /// /// reader positioned at the element private void HandleOnDeleteElement(XmlReader reader) { HandleOnOperationElement(reader, Operation.Delete); } /// /// Handle an On<Operation> element /// /// reader positioned at the element /// the kind of operation being handled private void HandleOnOperationElement(XmlReader reader, Operation operation) { Debug.Assert(reader != null); foreach (OnOperation other in Operations) { if (other.Operation == operation) AddError(ErrorCode.InvalidOperation, EdmSchemaErrorSeverity.Error, reader, System.Data.Entity.Strings.DuplicationOperation(reader.Name)); } OnOperation onOperation = new OnOperation(this, operation); onOperation.Parse(reader); _operations.Add(onOperation); } /// /// The parent element as an IRelationship /// internal new IRelationship ParentElement { get { return (IRelationship)(base.ParentElement); } } /// /// Create a new Multiplicity object from a string /// /// string containing Multiplicity definition /// new multiplicity object (null if there were errors) /// try if the string was parsable, false otherwise private static bool TryParseMultiplicity(string value, out RelationshipMultiplicity multiplicity) { switch (value) { case "0..1": multiplicity = RelationshipMultiplicity.ZeroOrOne; return true; case "1": multiplicity = RelationshipMultiplicity.One; return true; case "*": multiplicity = RelationshipMultiplicity.Many; return true; default: multiplicity = (RelationshipMultiplicity)(- 1); return false; } } } }