Code:
/ 4.0 / 4.0 / untmp / DEVDIV_TFS / Dev10 / Releases / RTMRel / ndp / fx / src / DataEntity / System / Data / Common / EntitySql / CqlQuery.cs / 1305376 / CqlQuery.cs
//---------------------------------------------------------------------- //// Copyright (c) Microsoft Corporation. All rights reserved. // // // @owner [....] // @backupOwner [....] //--------------------------------------------------------------------- namespace System.Data.Common.EntitySql { using System; using System.Collections.Generic; using System.Globalization; using System.Text; using System.Diagnostics; using System.Diagnostics.CodeAnalysis; using System.Data.Metadata.Edm; using System.Data.Common.CommandTrees; ////// Provides eSQL text Parsing and Compilation services. /// ////// This class exposes services that perform syntactic and semantic analysis of eSQL commands. /// The syntactic validation ensures the given command conforms to eSQL formal grammar. The semantic analysis will /// perform (list not exhaustive): type resolution and validation, ensure semantic and scoping rules, etc. /// The services exposed by this class are: /// //////
/// Queries can be formulated in O-Space, C-Space and S-Space and the services exposed by this class are agnostic of the especific typespace or /// metadata instance passed as required parameter in the semantic analysis by the perspective parameter. It is assumed that the perspective and /// metadata was properly initialized. /// Provided that the command is syntacticaly correct and meaningful within the given typespace, the result will be a valid- Translation from eSQL text commands to valid
///s - Translation from eSQL text commands to valid
///s or /// otherwise EntityException will be thrown indicating the reason(s) why the given command cannot be accepted. /// It is also possible that MetadataException and MappingException be thrown if mapping or metadata related problems are encountered during compilation. /// ///
internal static class CqlQuery { ///- ///
- ///
- ///
/// Compiles an eSQL command producing a validated /// eSQL command text /// perspective /// parser options. /// /// ordinary parameters /// The command tree produced by parsing the given command. ///Thrown when Syntatic or Semantic rules are violated and the query cannot be accepted ///Thrown when metadata related service requests fail ///Thrown when mapping related service requests fail ////// This method is not thread safe. /// ////// internal static DbCommandTree Compile(string commandText, Perspective perspective, ParserOptions parserOptions, IEnumerable parameters) { DbCommandTree commandTreeResult = CompileCommon(commandText, perspective, parserOptions, (astCommand, validatedParserOptions) => { DbCommandTree commandTree = AnalyzeCommandSemantics(astCommand, perspective, validatedParserOptions, parameters); TypeHelpers.AssertEdmType(commandTree); Debug.Assert(commandTree != null, "commandTree != null post-condition FAILED"); return commandTree; }); return commandTreeResult; } /// /// Compiles an eSQL query command producing a validated /// eSQL query command text /// perspective /// parser options. /// /// ordinary command parameters /// command free variables /// The query expression tree produced by parsing the given query command. ///Thrown when Syntatic or Semantic rules are violated and the query expression cannot be accepted ///Thrown when metadata related service requests fail ///Thrown when mapping related service requests fail ////// This method is not thread safe. /// ////// internal static DbLambda CompileQueryCommandLambda(string queryCommandText, Perspective perspective, ParserOptions parserOptions, IEnumerable parameters, IEnumerable variables) { return CompileCommon(queryCommandText, perspective, parserOptions, (astCommand, validatedParserOptions) => { DbLambda lambda = AnalyzeQueryExpressionSemantics(astCommand, perspective, validatedParserOptions, parameters, variables); TypeHelpers.AssertEdmType(lambda.Body.ResultType); Debug.Assert(lambda != null, "lambda != null post-condition FAILED"); return lambda; }); } #region Private /// /// Parse eSQL command string into an AST /// /// eSQL command /// parser options/// Ast ///Thrown when Syntatic or Semantic rules are violated and the query cannot be accepted ////// This method is not thread safe. /// ///private static AST.Node Parse(string commandText, ParserOptions parserOptions) { #region BID TRACING // // enter bid scope // IntPtr bidCookie = IntPtr.Zero; EntityBid.ScopeEnter(out bidCookie, " "); #endregion AST.Node astExpr = null; try { #region BID TRACING // // trace arguments // if (EntityBid.TraceOn) { EntityBid.Trace(" parserOptions.ParserCompilationMode=%d{System.Data.Common.ParserOptions.CompilationMode}\n", (int)parserOptions.ParserCompilationMode); EntityBid.Trace(" commandText BEGIN\n"); EntityBid.PutStr(commandText); EntityBid.Trace(" commandText END\n"); } #endregion // // commandText and parserOptions are validated inside of CqlParser // // // Create Parser // CqlParser cqlParser = new CqlParser(parserOptions, true); // // Invoke parser // astExpr = cqlParser.Parse(commandText); #region BID TRACING // // trace result // if (EntityBid.TraceOn) { EntityBid.Trace(" astExpr=%d#\n", (null != astExpr) ? astExpr.GetHashCode() : 0); } #endregion } finally { #region BID TRACING // // leave bid scope // EntityBid.ScopeLeave(ref bidCookie); #endregion } if (null == astExpr) { throw EntityUtil.EntitySqlError(commandText, System.Data.Entity.Strings.InvalidEmptyQuery, 0); } return astExpr; } private static TResult CompileCommon (string commandText, Perspective perspective, ParserOptions parserOptions, Func compilationFunction) where TResult : class { #region BID TRACING // // enter bid scope // IntPtr bidCookie = IntPtr.Zero; EntityBid.ScopeEnter(out bidCookie, " "); #endregion TResult result = null; try { // // Validate arguments // EntityUtil.CheckArgumentNull(perspective, "commandText"); EntityUtil.CheckArgumentNull(perspective, "perspective"); #region BID TRACING // // trace TargetDataspace // EntityBid.Trace(" perspective.TargetDataspace: %d{DataSpace}\n", (int)perspective.TargetDataspace); #endregion // // Validate parser options - if null, give default options // parserOptions = parserOptions ?? new ParserOptions(); // // Invoke Parser // AST.Node astCommand = Parse(commandText, parserOptions); // // Perform Semantic Analysis/Conversion // result = compilationFunction(astCommand, parserOptions); } finally { #region BID TRACING // // leave bid scope // EntityBid.ScopeLeave(ref bidCookie); #endregion } return result; } /// /// Performs semantic conversion, validation on a command AST and creates a /// Abstract Syntax Tree of the command /// perspective /// parser options/// /// ordinary command parameters /// a valid command tree ///Parameters name/types must be bound before invoking this method ///Thrown when Syntatic or Semantic rules are violated and the query cannot be accepted. ///Thrown as inner exception of a EntityException when metadata related service requests fail. ///Thrown as inner exception of a EntityException when mapping related service requests fail. ////// This method is not thread safe. /// ////// private static DbCommandTree AnalyzeCommandSemantics(AST.Node astExpr, Perspective perspective, ParserOptions parserOptions, IEnumerable parameters) { DbCommandTree resultCommandTree = AnalyzeSemanticsCommon(astExpr, perspective, parserOptions, parameters, null/*variables*/, (analyzer, astExpression) => { DbCommandTree commandTree = analyzer.AnalyzeCommand(astExpression); #region BID TRACING // // trace result // if (EntityBid.TraceOn && null != commandTree) { EntityBid.Trace(" DbCommandTree DUMP BEGIN\n"); commandTree.Trace(); EntityBid.Trace(" DbCommandTree DUMP END\n"); } #endregion Debug.Assert(commandTree != null, "commandTree != null post-condition FAILED"); return commandTree; }); return resultCommandTree; } /// /// Performs semantic conversion, validation on a query command AST and creates a /// Abstract Syntax Tree of the query command /// perspective /// parser options/// /// ordinary command parameters /// command free variables /// Parameters name/types must be bound before invoking this method ///Thrown when Syntatic or Semantic rules are violated and the query cannot be accepted. ///Thrown as inner exception of a EntityException when metadata related service requests fail. ///Thrown as inner exception of a EntityException when mapping related service requests fail. ////// This method is not thread safe. /// ////// private static DbLambda AnalyzeQueryExpressionSemantics(AST.Node astQueryCommand, Perspective perspective, ParserOptions parserOptions, IEnumerable parameters, IEnumerable variables) { return AnalyzeSemanticsCommon( astQueryCommand, perspective, parserOptions, parameters, variables, (analyzer, astExpr) => { DbLambda lambda = analyzer.AnalyzeQueryCommand(astExpr); Debug.Assert(null != lambda, "null != lambda post-condition FAILED"); return lambda; }); } private static TResult AnalyzeSemanticsCommon (AST.Node astExpr, Perspective perspective, ParserOptions parserOptions, IEnumerable parameters, IEnumerable variables, Func analysisFunction) where TResult : class { #region BID TRACING // // enter bid scope // IntPtr bidCookie = IntPtr.Zero; EntityBid.ScopeEnter(out bidCookie, " "); #endregion TResult result = null; try { // // Validate arguments // EntityUtil.CheckArgumentNull(astExpr, "astExpr"); EntityUtil.CheckArgumentNull(perspective, "perspective"); #region BID TRACING // // trace arguments // if (EntityBid.TraceOn) { EntityBid.Trace(" astExpr=%d#\n", astExpr.GetHashCode()); EntityBid.Trace(" perspective=%d, perspective Type='%ls'\n", perspective.GetHashCode(), perspective.GetType().Name); if (null != parserOptions) EntityBid.Trace(" parserOptions.ParserCompilationMode=%d{System.Data.Common.ParserOptions.CompilationMode}\n", (int)parserOptions.ParserCompilationMode); else EntityBid.Trace(" parserOptions is NULL\n"); if (null != parameters) foreach (DbParameterReferenceExpression param in parameters) EntityBid.Trace(" parameter='%ls', Type='%ls'\n", param.ParameterName, param.ResultType.EdmType.Name); else EntityBid.Trace(" parameters=null\n"); if (null != variables) foreach (DbVariableReferenceExpression var in variables) EntityBid.Trace(" variable='%ls', Type='%ls'\n", var.VariableName, var.ResultType.EdmType.Name); else EntityBid.Trace(" variables=null\n"); } #endregion // // Invoke semantic analysis // SemanticAnalyzer analyzer = (new SemanticAnalyzer(SemanticResolver.Create(perspective, parserOptions, parameters, variables))); result = analysisFunction(analyzer, astExpr); } // // Wrap MetadataException as EntityException inner exception // catch (System.Data.MetadataException metadataException) { throw EntityUtil.EntitySqlError(System.Data.Entity.Strings.GeneralExceptionAsQueryInnerException("Metadata"), metadataException); } // // Wrap MappingException as EntityException inner exception // catch (System.Data.MappingException mappingException) { throw EntityUtil.EntitySqlError(System.Data.Entity.Strings.GeneralExceptionAsQueryInnerException("Mapping"), mappingException); } finally { #region BID TRACING // // leave Bid scope // EntityBid.ScopeLeave(ref bidCookie); #endregion } return result; } #endregion } } // File provided for Reference Use Only by Microsoft Corporation (c) 2007.
Link Menu
This book is available now!
Buy at Amazon US or
Buy at Amazon UK
- DataSourceProvider.cs
- LocatorGroup.cs
- Int32AnimationUsingKeyFrames.cs
- Point.cs
- DateTimeUtil.cs
- IndependentlyAnimatedPropertyMetadata.cs
- ObjectPropertyMapping.cs
- Stacktrace.cs
- ToolBar.cs
- DataControlButton.cs
- SetState.cs
- LocatorPartList.cs
- WebPartMovingEventArgs.cs
- ParameterReplacerVisitor.cs
- ToolbarAUtomationPeer.cs
- XmlQuerySequence.cs
- TypeDelegator.cs
- WizardStepBase.cs
- DetailsViewPagerRow.cs
- GenericNameHandler.cs
- LineSegment.cs
- BypassElement.cs
- Transform3DGroup.cs
- DataGridViewCellStateChangedEventArgs.cs
- EntryPointNotFoundException.cs
- PageClientProxyGenerator.cs
- TypedTableBase.cs
- MenuItem.cs
- ApplicationDirectory.cs
- RawStylusInputReport.cs
- DataGridViewRowHeaderCell.cs
- ObservableDictionary.cs
- thaishape.cs
- XmlReaderSettings.cs
- SqlClientWrapperSmiStream.cs
- ResourceCategoryAttribute.cs
- StructuredTypeEmitter.cs
- Range.cs
- Activity.cs
- WebPartConnectionsConnectVerb.cs
- DataSourceDescriptorCollection.cs
- RoutedEventConverter.cs
- WebConfigurationHostFileChange.cs
- FontFamilyValueSerializer.cs
- SystemIPInterfaceStatistics.cs
- Int32RectConverter.cs
- ConfigurationPropertyAttribute.cs
- ValidationHelper.cs
- EmissiveMaterial.cs
- BamlBinaryWriter.cs
- CompiledELinqQueryState.cs
- QueryInterceptorAttribute.cs
- SyndicationItem.cs
- HostVisual.cs
- WebWorkflowRole.cs
- NavigationService.cs
- PersonalizationEntry.cs
- ResourceCodeDomSerializer.cs
- InvokeAction.cs
- ColumnWidthChangedEvent.cs
- Figure.cs
- OracleParameter.cs
- Point3DCollection.cs
- BitmapInitialize.cs
- Brushes.cs
- DocumentOrderQuery.cs
- HandlerBase.cs
- XmlComment.cs
- QuadraticEase.cs
- PolicyChain.cs
- SearchForVirtualItemEventArgs.cs
- HostProtectionException.cs
- WaitHandleCannotBeOpenedException.cs
- NetworkAddressChange.cs
- MediaElement.cs
- ReferencedAssemblyResolver.cs
- BitmapPalettes.cs
- PersonalizationProvider.cs
- ZeroOpNode.cs
- SignalGate.cs
- HtmlInputText.cs
- OLEDB_Util.cs
- DataContract.cs
- MsmqIntegrationElement.cs
- CodeConditionStatement.cs
- InheritanceRules.cs
- Vector3DConverter.cs
- GlyphRunDrawing.cs
- DecoderFallbackWithFailureFlag.cs
- TemplateColumn.cs
- Trace.cs
- ChangeProcessor.cs
- RewritingPass.cs
- DeflateStream.cs
- SettingsAttributes.cs
- TemplateControlParser.cs
- QilTypeChecker.cs
- IgnoreSection.cs
- MenuItemBinding.cs
- DataColumnMappingCollection.cs