//----------------------------------------------------------------------------- // Copyright (c) Microsoft Corporation. All rights reserved. //----------------------------------------------------------------------------- namespace System.Activities.Runtime { using System; using System.Activities.Hosting; using System.Collections.Generic; using System.Collections.ObjectModel; using System.Diagnostics.CodeAnalysis; using System.Globalization; using System.Runtime; using System.Runtime.DurableInstancing; using System.Runtime.Serialization; [DataContract] class BookmarkScopeManager { Dictionary bookmarkManagers; List uninitializedScopes; List keysToAssociate; List keysToDisassociate; BookmarkScope defaultScope; long nextTemporaryId; public BookmarkScopeManager() { this.nextTemporaryId = 1; this.defaultScope = CreateAndRegisterScope(Guid.Empty); } public BookmarkScope Default { get { return this.defaultScope; } } public bool HasKeysToUpdate { get { if (this.keysToAssociate != null && this.keysToAssociate.Count > 0) { return true; } if (this.keysToDisassociate != null && this.keysToDisassociate.Count > 0) { return true; } return false; } } [DataMember(Name = "defaultScope")] internal BookmarkScope SerializedDefaultScope { get { return this.defaultScope; } set { this.defaultScope = value; } } [DataMember(Name = "nextTemporaryId")] internal long SerializedNextTemporaryId { get { return this.nextTemporaryId; } set { this.nextTemporaryId = value; } } [DataMember(EmitDefaultValue = false)] [SuppressMessage(FxCop.Category.Performance, FxCop.Rule.AvoidUncalledPrivateCode, Justification = "Called from Serialization")] internal Dictionary SerializedBookmarkManagers { get { Fx.Assert(this.bookmarkManagers != null && this.bookmarkManagers.Count > 0, "We always have the default sub instance."); return this.bookmarkManagers; } set { Fx.Assert(value != null, "We don't serialize null."); this.bookmarkManagers = value; } } [DataMember(EmitDefaultValue = false)] [SuppressMessage(FxCop.Category.Performance, FxCop.Rule.AvoidUncalledPrivateCode, Justification = "Called from Serialization")] internal List SerializedUninitializedScopes { get { if (this.uninitializedScopes == null || this.uninitializedScopes.Count == 0) { return null; } else { return this.uninitializedScopes; } } set { Fx.Assert(value != null, "We don't serialize null."); this.uninitializedScopes = value; } } long GetNextTemporaryId() { long temp = this.nextTemporaryId; this.nextTemporaryId++; return temp; } public Bookmark CreateBookmark(string name, BookmarkScope scope, BookmarkCallback callback, ActivityInstance owningInstance, BookmarkOptions options) { Fx.Assert(scope != null, "We should never have a null scope."); BookmarkManager manager = null; BookmarkScope lookupScope = scope; if (scope.IsDefault) { lookupScope = this.defaultScope; } if (!this.bookmarkManagers.TryGetValue(lookupScope, out manager)) { throw FxTrace.Exception.AsError(new InvalidOperationException(SR.RegisteredBookmarkScopeRequired)); } return manager.CreateBookmark(name, callback, owningInstance, options); } public bool RemoveBookmark(Bookmark bookmark, BookmarkScope scope, ActivityInstance instanceAttemptingRemove) { Fx.Assert(scope != null, "We should never have a null scope."); BookmarkScope lookupScope = scope; if (scope.IsDefault) { lookupScope = this.defaultScope; } BookmarkManager manager; if (this.bookmarkManagers.TryGetValue(lookupScope, out manager)) { return manager.Remove(bookmark, instanceAttemptingRemove); } else { return false; } } public BookmarkResumptionResult TryGenerateWorkItem(ActivityExecutor executor, ref Bookmark bookmark, BookmarkScope scope, object value, ActivityInstance isolationInstance, bool nonScopedBookmarksExist, out ActivityExecutionWorkItem workItem) { Fx.Assert(scope != null, "We should never have a null sub instance."); BookmarkManager manager = null; workItem = null; BookmarkScope lookupScope = scope; if (scope.IsDefault) { lookupScope = this.defaultScope; } // We don't really care about the return value since we'll // use null to know we should check uninitialized sub instances this.bookmarkManagers.TryGetValue(lookupScope, out manager); if (manager == null) { Fx.Assert(lookupScope != null, "The sub instance should not be default if we are here."); BookmarkResumptionResult finalResult = BookmarkResumptionResult.NotFound; // Check the uninitialized sub instances for a matching bookmark if (this.uninitializedScopes != null) { for (int i = 0; i < this.uninitializedScopes.Count; i++) { BookmarkScope uninitializedScope = this.uninitializedScopes[i]; Fx.Assert(this.bookmarkManagers.ContainsKey(uninitializedScope), "We must always have the uninitialized sub instances."); Bookmark internalBookmark; BookmarkCallbackWrapper callbackWrapper; BookmarkResumptionResult resumptionResult; if (!this.bookmarkManagers[uninitializedScope].TryGetBookmarkFromInternalList(bookmark, out internalBookmark, out callbackWrapper)) { resumptionResult = BookmarkResumptionResult.NotFound; } else if (IsExclusiveScopeUnstable(internalBookmark)) { resumptionResult = BookmarkResumptionResult.NotReady; } else { resumptionResult = this.bookmarkManagers[uninitializedScope].TryGenerateWorkItem(executor, true, ref bookmark, value, isolationInstance, out workItem); } if (resumptionResult == BookmarkResumptionResult.Success) { // We are using InitializeBookmarkScopeWithoutKeyAssociation because we know this is a new uninitialized scope and // the key we would associate is already associated. And if we did the association here, the subsequent call to // FlushBookmarkScopeKeys would try to flush it out, but it won't have the transaction correct so will hang waiting for // the transaction that has the PersistenceContext locked to complete. But it won't complete successfully until // we finish processing here. InitializeBookmarkScopeWithoutKeyAssociation(uninitializedScope, scope.Id); // We've found what we were looking for return BookmarkResumptionResult.Success; } else if (resumptionResult == BookmarkResumptionResult.NotReady) { // This uninitialized sub-instance has a matching bookmark but // it can't currently be resumed. We won't return BookmarkNotFound // because of this. finalResult = BookmarkResumptionResult.NotReady; } else { if (finalResult == BookmarkResumptionResult.NotFound) { // If we still are planning on returning failure then // we'll incur the cost of seeing if this scope is // stable or not. if (!IsStable(uninitializedScope, nonScopedBookmarksExist)) { // There exists an uninitialized scope which is unstable. // At the very least this means we'll return NotReady since // this uninitialized scope might eventually contain this // bookmark. finalResult = BookmarkResumptionResult.NotReady; } } } } } return finalResult; } else { Bookmark bookmarkFromList; BookmarkCallbackWrapper callbackWrapper; BookmarkResumptionResult resumptionResult; if (!manager.TryGetBookmarkFromInternalList(bookmark, out bookmarkFromList, out callbackWrapper)) { resumptionResult = BookmarkResumptionResult.NotFound; } else { if (IsExclusiveScopeUnstable(bookmarkFromList)) { resumptionResult = BookmarkResumptionResult.NotReady; } else { resumptionResult = manager.TryGenerateWorkItem(executor, true, ref bookmark, value, isolationInstance, out workItem); } } if (resumptionResult == BookmarkResumptionResult.NotFound) { if (!IsStable(lookupScope, nonScopedBookmarksExist)) { resumptionResult = BookmarkResumptionResult.NotReady; } } return resumptionResult; } } public void PopulateBookmarkInfo(ref List bookmarks) { foreach (BookmarkManager manager in this.bookmarkManagers.Values) { if (manager.HasBookmarks) { if (bookmarks == null) { bookmarks = new List(); } manager.PopulateBookmarkInfo(bookmarks); } } } public ReadOnlyCollection GetBookmarks(BookmarkScope scope) { Fx.Assert(scope != null, "We should never be passed null here."); BookmarkManager manager = null; BookmarkScope lookupScope = scope; if (scope.IsDefault) { lookupScope = this.defaultScope; } if (this.bookmarkManagers.TryGetValue(lookupScope, out manager)) { if (!manager.HasBookmarks) { manager = null; } } if (manager != null) { List bookmarks = new List(); manager.PopulateBookmarkInfo(bookmarks); return new ReadOnlyCollection(bookmarks); } else { return null; } } public ICollection GetKeysToAssociate() { if (this.keysToAssociate == null || this.keysToAssociate.Count == 0) { return null; } ICollection result = this.keysToAssociate; this.keysToAssociate = null; return result; } public ICollection GetKeysToDisassociate() { if (this.keysToDisassociate == null || this.keysToDisassociate.Count == 0) { return null; } ICollection result = this.keysToDisassociate; this.keysToDisassociate = null; return result; } public void InitializeScope(BookmarkScope scope, Guid id) { Fx.Assert(!scope.IsInitialized, "This should have been checked by the caller."); BookmarkScope lookupScope = InitializeBookmarkScopeWithoutKeyAssociation(scope, id); CreateAssociatedKey(lookupScope); } public BookmarkScope InitializeBookmarkScopeWithoutKeyAssociation(BookmarkScope scope, Guid id) { Fx.Assert(!scope.IsInitialized, "This should have been checked by the caller."); BookmarkScope lookupScope = scope; if (scope.IsDefault) { lookupScope = this.defaultScope; } if (this.uninitializedScopes == null || !this.uninitializedScopes.Contains(lookupScope)) { throw FxTrace.Exception.AsError(new InvalidOperationException(SR.BookmarkScopeNotRegisteredForInitialize)); } Fx.Assert(this.bookmarkManagers != null, "This is never null if uninitializedScopes is non-null."); if (this.bookmarkManagers.ContainsKey(new BookmarkScope(id))) { throw FxTrace.Exception.AsError(new InvalidOperationException(SR.BookmarkScopeWithIdAlreadyExists(id))); } BookmarkManager bookmarks = this.bookmarkManagers[lookupScope]; this.bookmarkManagers.Remove(lookupScope); this.uninitializedScopes.Remove(lookupScope); long temporaryId = lookupScope.TemporaryId; // We initialize and re-add to our dictionary. We have to // re-add because the hash has changed. lookupScope.Id = id; this.bookmarkManagers.Add(lookupScope, bookmarks); if (TD.BookmarkScopeInitializedIsEnabled()) { TD.BookmarkScopeInitialized(temporaryId.ToString(CultureInfo.InvariantCulture), lookupScope.Id.ToString()); } return lookupScope; } public BookmarkScope CreateAndRegisterScope(Guid scopeId) { return this.CreateAndRegisterScope(scopeId, null); } internal BookmarkScope CreateAndRegisterScope(Guid scopeId, BookmarkScopeHandle scopeHandle) { if (this.bookmarkManagers == null) { this.bookmarkManagers = new Dictionary(); } BookmarkScope scope = null; if (scopeId == Guid.Empty) { // // This is the very first activity which started the sub-instance // scope = new BookmarkScope(GetNextTemporaryId()); this.bookmarkManagers.Add(scope, new BookmarkManager(scope, scopeHandle)); if (TD.CreateBookmarkScopeIsEnabled()) { TD.CreateBookmarkScope(ActivityUtilities.GetTraceString(scope)); } if (this.uninitializedScopes == null) { this.uninitializedScopes = new List(); } this.uninitializedScopes.Add(scope); } else { // // Try to find one in the existing sub-instances // foreach (BookmarkScope eachScope in this.bookmarkManagers.Keys) { if (eachScope.Id.Equals(scopeId)) { scope = eachScope; break; } } // // We did not find one, e.g. the first receive will get the correlation id from the // correlation channel // if (scope == null) { scope = new BookmarkScope(scopeId); this.bookmarkManagers.Add(scope, new BookmarkManager(scope, scopeHandle)); if (TD.CreateBookmarkScopeIsEnabled()) { TD.CreateBookmarkScope(string.Format(CultureInfo.InvariantCulture, "Id: {0}", ActivityUtilities.GetTraceString(scope))); } } CreateAssociatedKey(scope); } return scope; } void CreateAssociatedKey(BookmarkScope newScope) { if (this.keysToAssociate == null) { this.keysToAssociate = new List(2); } this.keysToAssociate.Add(new InstanceKey(newScope.Id)); } public void UnregisterScope(BookmarkScope scope) { Fx.Assert(!scope.IsDefault, "Cannot unregister the default sub instance."); if (this.bookmarkManagers == null || !this.bookmarkManagers.ContainsKey(scope)) { throw FxTrace.Exception.AsError(new InvalidOperationException(SR.BookmarkScopeNotRegisteredForUnregister)); } if (this.bookmarkManagers[scope].HasBookmarks) { throw FxTrace.Exception.AsError(new InvalidOperationException(SR.BookmarkScopeHasBookmarks)); } this.bookmarkManagers.Remove(scope); if (!scope.IsInitialized) { Fx.Assert(this.uninitializedScopes != null && this.uninitializedScopes.Contains(scope), "Something is wrong with our housekeeping."); this.uninitializedScopes.Remove(scope); } else { if (this.keysToDisassociate == null) { this.keysToDisassociate = new List(2); } this.keysToDisassociate.Add(new InstanceKey(scope.Id)); Fx.Assert(this.uninitializedScopes == null || !this.uninitializedScopes.Contains(scope), "We shouldn't have this in the uninitialized list."); } } bool IsStable(BookmarkScope scope, bool nonScopedBookmarksExist) { Fx.Assert(this.bookmarkManagers.ContainsKey(scope), "The caller should have made sure this scope exists in the bookmark managers dictionary."); if (nonScopedBookmarksExist) { return false; } if (this.bookmarkManagers != null) { foreach (KeyValuePair scopeBookmarks in this.bookmarkManagers) { IEquatable comparison = scopeBookmarks.Key; if (!comparison.Equals(scope)) { if (scopeBookmarks.Value.HasBookmarks) { return false; } } } } return true; } public bool IsExclusiveScopeUnstable(Bookmark bookmark) { if (bookmark.ExclusiveHandles != null) { for (int i = 0; i < bookmark.ExclusiveHandles.Count; i++) { ExclusiveHandle handle = bookmark.ExclusiveHandles[i]; Fx.Assert(handle != null, "Internal error..ExclusiveHandle was null"); if ((handle.ImportantBookmarks != null && handle.ImportantBookmarks.Contains(bookmark)) && (handle.UnimportantBookmarks != null && handle.UnimportantBookmarks.Count != 0)) { return true; } } } return false; } public void PurgeBookmarks(BookmarkManager nonScopedBookmarkManager, Bookmark singleBookmark, IList multipleBookmarks) { if (singleBookmark != null) { PurgeBookmark(singleBookmark, nonScopedBookmarkManager); } else { Fx.Assert(multipleBookmarks != null, "caller should never pass null"); for (int i = 0; i < multipleBookmarks.Count; i++) { Bookmark bookmark = multipleBookmarks[i]; PurgeBookmark(bookmark, nonScopedBookmarkManager); } } } void PurgeBookmark(Bookmark bookmark, BookmarkManager nonScopedBookmarkManager) { BookmarkManager manager = null; if (bookmark.Scope != null) { BookmarkScope lookupScope = bookmark.Scope; if (bookmark.Scope.IsDefault) { lookupScope = this.defaultScope; } Fx.Assert(this.bookmarkManagers.ContainsKey(bookmark.Scope), "We should have the single bookmark's sub instance registered"); manager = this.bookmarkManagers[bookmark.Scope]; } else { manager = nonScopedBookmarkManager; } manager.PurgeSingleBookmark(bookmark); } } }