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
- TreeNodeClickEventArgs.cs
- ValidationEventArgs.cs
- ExpressionNode.cs
- WebEventCodes.cs
- DataGridViewBand.cs
- DropTarget.cs
- ParagraphResult.cs
- HtmlButton.cs
- DelegatingTypeDescriptionProvider.cs
- EntityDataSourceValidationException.cs
- DataGridParentRows.cs
- XmlSerializerVersionAttribute.cs
- ComboBoxAutomationPeer.cs
- DataRelationCollection.cs
- UnmanagedMemoryStreamWrapper.cs
- XmlMembersMapping.cs
- ReturnValue.cs
- TextRenderer.cs
- ChangeBlockUndoRecord.cs
- WeakRefEnumerator.cs
- HtmlTitle.cs
- _LocalDataStoreMgr.cs
- ProxyAttribute.cs
- NamedPipeWorkerProcess.cs
- odbcmetadatacollectionnames.cs
- COAUTHINFO.cs
- BinaryQueryOperator.cs
- GeometryGroup.cs
- XmlName.cs
- StringExpressionSet.cs
- SettingsAttributes.cs
- DataServiceQueryException.cs
- CqlErrorHelper.cs
- HighContrastHelper.cs
- ToolStripDropDownItemDesigner.cs
- DBConnection.cs
- Message.cs
- Peer.cs
- AnonymousIdentificationModule.cs
- Assembly.cs
- XmlSerializer.cs
- BindingFormattingDialog.cs
- SafeReadContext.cs
- EntityClassGenerator.cs
- PassportAuthenticationModule.cs
- HtmlLink.cs
- PingOptions.cs
- StructuredProperty.cs
- ViewStateChangedEventArgs.cs
- XmlDocumentType.cs
- SHA256Managed.cs
- ResourceContainerWrapper.cs
- UserNameSecurityTokenParameters.cs
- ListQueryResults.cs
- SoapCommonClasses.cs
- FillErrorEventArgs.cs
- TcpAppDomainProtocolHandler.cs
- KeyboardNavigation.cs
- MailAddressCollection.cs
- _TLSstream.cs
- TrackingMemoryStreamFactory.cs
- SaveLedgerEntryRequest.cs
- _SingleItemRequestCache.cs
- RotateTransform3D.cs
- ScrollViewer.cs
- QuotedPrintableStream.cs
- XmlSchemaInclude.cs
- ProjectionCamera.cs
- RotateTransform.cs
- EpmHelper.cs
- ProcessManager.cs
- HttpRuntime.cs
- SingleResultAttribute.cs
- ScriptControlManager.cs
- LogicalExpressionEditor.cs
- PriorityQueue.cs
- CompilationUtil.cs
- StoreItemCollection.Loader.cs
- OdbcDataReader.cs
- GeneralTransform2DTo3D.cs
- LineGeometry.cs
- AppLevelCompilationSectionCache.cs
- DbParameterHelper.cs
- TableRow.cs
- SyndicationItem.cs
- HtmlControl.cs
- ChooseAction.cs
- _ShellExpression.cs
- HostingEnvironmentSection.cs
- SiteMapDataSource.cs
- TextEndOfSegment.cs
- SQLChars.cs
- BoolExpression.cs
- XamlUtilities.cs
- SvcMapFileSerializer.cs
- RSAPKCS1KeyExchangeFormatter.cs
- StyleCollection.cs
- WebControlsSection.cs
- SystemUdpStatistics.cs
- ClockGroup.cs