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
- DesignerDataParameter.cs
- PreservationFileReader.cs
- RangeContentEnumerator.cs
- ButtonField.cs
- SoapIgnoreAttribute.cs
- PropertyValueEditor.cs
- ContainerControl.cs
- LayoutExceptionEventArgs.cs
- mediaeventargs.cs
- SqlServices.cs
- ComplexTypeEmitter.cs
- QueryOutputWriter.cs
- TextContainerChangedEventArgs.cs
- LinqDataSourceDeleteEventArgs.cs
- CollectionEditorDialog.cs
- ContainerUtilities.cs
- SerializationInfo.cs
- DefaultTextStore.cs
- NamespaceList.cs
- InkCanvasSelectionAdorner.cs
- PackageDigitalSignature.cs
- TextBoxRenderer.cs
- TextParentUndoUnit.cs
- ObjectDataSourceMethodEventArgs.cs
- Deflater.cs
- SimpleHandlerBuildProvider.cs
- FlatButtonAppearance.cs
- GraphicsContainer.cs
- TypeDefinition.cs
- ProcessManager.cs
- MethodAccessException.cs
- XmlLanguageConverter.cs
- HttpModulesSection.cs
- DecoderExceptionFallback.cs
- DataTrigger.cs
- PersonalizationEntry.cs
- FolderBrowserDialog.cs
- Pkcs9Attribute.cs
- Sequence.cs
- Stylus.cs
- ProfileGroupSettingsCollection.cs
- ISAPIWorkerRequest.cs
- ContextStaticAttribute.cs
- Rules.cs
- CategoryNameCollection.cs
- EmbeddedObject.cs
- BulletedList.cs
- JsonUriDataContract.cs
- IBuiltInEvidence.cs
- DesignerOptions.cs
- WinEventWrap.cs
- DbResourceAllocator.cs
- ScriptingWebServicesSectionGroup.cs
- JsonGlobals.cs
- CompositeFontParser.cs
- MSAANativeProvider.cs
- ComponentResourceManager.cs
- WorkflowQueueInfo.cs
- ValueTypeFixupInfo.cs
- StatusBar.cs
- DocumentSchemaValidator.cs
- QueryTreeBuilder.cs
- DataGridCaption.cs
- Tablet.cs
- PropagatorResult.cs
- MailAddressCollection.cs
- XsltOutput.cs
- ProcessStartInfo.cs
- InvalidDataException.cs
- XmlStrings.cs
- SymbolMethod.cs
- HttpFormatExtensions.cs
- OciEnlistContext.cs
- EdmRelationshipRoleAttribute.cs
- DataObjectSettingDataEventArgs.cs
- PeerUnsafeNativeCryptMethods.cs
- ConnectionsZone.cs
- ConnectorDragDropGlyph.cs
- EntityDataSourceReferenceGroup.cs
- InvalidCastException.cs
- Variant.cs
- XmlNamespaceMappingCollection.cs
- DynamicScriptObject.cs
- AnnotationDocumentPaginator.cs
- HtmlLink.cs
- EditorPart.cs
- FreezableCollection.cs
- EntityDataSourceViewSchema.cs
- LexicalChunk.cs
- SiteMap.cs
- Positioning.cs
- TraceHwndHost.cs
- UserPreferenceChangingEventArgs.cs
- CalendarDesigner.cs
- SchemaManager.cs
- BinHexDecoder.cs
- QilInvokeEarlyBound.cs
- AnnotationHelper.cs
- TextBoxRenderer.cs
- TextServicesManager.cs