Event Grid Explorer - Adding Support for Event Grid V2

.gitignore

@@ -166,3 +166,6 @@ $RECYCLE.BIN/
 
 # VS code settings
 .vscode/settings.json
+
+# Event Grid Explorer Library pkgrefgen
+/src/EventGridExplorerLibrary/.pkgrefgen/

EventGridExplorer_README.md

@@ -0,0 +1,45 @@
+# Event Grid Explorer - Support for Event Grid V2 in Service Bus Explorer
+**Author:** Amy Wang
+
+The Event Grid Explorer provides a tool for viewing and managing Event Grid V2 entities, including namespaces, topics and subscriptions, as well as provide create/delete operations for topics and subscriptions, publish/receive operations for events, and acknowledge/release/reject operations for events.
+Currently, the Event Grid Explorer features the functionality that is available for the preview version of Event Grid V2.
+This additional support for Event Grid enables users to test event delivery with ease, contributing to the adoption of the new service.
+Note: The EventGridExplorerLibrary uses models that are generated by Microsoft (R) AutoRest Code Generator
+
+## Connect to Event Grid
+
+Under the File tab, the user can connect to an Event Grid V2 namespace by providing the Resource Group, Namespace Name, Subscription ID, API Version, Retry Timeout and Cloud Tenant which selects the associated tenant ID.
+
+![Connect to EGV2](./media/connect-event-grid.png)
+
+![Connection Info](./media/connect-info-event-grid.png)
+
+## Main View
+
+When the connection is successful, a tree view of the Event Grid V2 namespace with its contained topics and subscriptions is displayed along with properties views.
+Right-clicking the Topics and Subscriptions nodes enables the user to create topics/subscriptions and right-clicking the existing topics and subscriptions enables the user to publish/receive events and delete these entities.
+
+![Main View](./media/main-view-event-grid.png)
+
+## Publish
+
+When right-clicking the Publish option on a topic, the user can create and publish an event by entering the event source, type and JSON payload. 
+Events are expected to use the CloudEvent format, as specified in the Azure SDK for .NET
+
+![Publish Event to Topic](./media/publish-event-grid.png)
+
+## Receive
+
+When receiving events through a subscription, the user can receive the maximum number of events (100) or a top number of events.
+When successful, the data view table is populated with the received events and the event data is displayed in a JSON format.
+
+![Receive Event Popup](./media/receive-popup-event-grid.png)
+
+![Receive Events in Subscription](./media/receive-results-event-grid.png)
+
+## Event Settlement
+
+The user can multi-select the received events in the table to acknowledge, release, or reject events.
+When successful, the event status column is updated with the operation performed.
+
+![Event Action](./media/event-action-event-grid.png)

src/Common/Common.csproj

@@ -43,6 +43,7 @@
     </AdditionalFiles>
   </ItemGroup>
   <ItemGroup>
+    <ProjectReference Include="..\EventGridExplorerLibrary\EventGridExplorerLibrary.csproj" />
     <ProjectReference Include="..\EventHubs\EventHubs.csproj" />
     <ProjectReference Include="..\Relay\Relay.csproj" />
     <ProjectReference Include="..\ServiceBus\ServiceBus.csproj" />

src/Common/Helpers/Constants.cs

@@ -33,6 +33,7 @@ public static class Constants
     {
         public const string QueueEntities = "Queues";
         public const string TopicEntities = "Topics";
+        public const string SubscriptionEntities = "Subscriptions";
         public const string RelayEntities = "Relays";
         public const string EventHubEntities = "Event Hubs";
         public const string NotificationHubEntities = "Notification Hubs";

src/Common/Helpers/EventGridException.cs

@@ -0,0 +1,54 @@
+#region Copyright
+//=======================================================================================
+// Microsoft Azure Customer Advisory Team 
+//
+// This sample is supplemental to the technical guidance published on my personal
+// blog at http://blogs.msdn.com/b/paolos/. 
+// 
+// Author: Paolo Salvatori
+//=======================================================================================
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// 
+// LICENSED UNDER THE APACHE LICENSE, VERSION 2.0 (THE "LICENSE"); YOU MAY NOT USE THESE 
+// FILES EXCEPT IN COMPLIANCE WITH THE LICENSE. YOU MAY OBTAIN A COPY OF THE LICENSE AT 
+// http://www.apache.org/licenses/LICENSE-2.0
+// UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, SOFTWARE DISTRIBUTED UNDER THE 
+// LICENSE IS DISTRIBUTED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 
+// KIND, EITHER EXPRESS OR IMPLIED. SEE THE LICENSE FOR THE SPECIFIC LANGUAGE GOVERNING 
+// PERMISSIONS AND LIMITATIONS UNDER THE LICENSE.
+//=======================================================================================
+#endregion
+
+#region Using Directives
+
+using System;
+
+#endregion
+
+
+namespace ServiceBusExplorer.Helpers
+{
+    public class EventGridException : Exception
+    {
+        #region Public constructors
+        /// <summary>
+        /// Initializes a new instance of the <see cref="EventGridException"/> class.
+        /// </summary>
+        /// <param name="message">Message</param>
+        /// <param name="innerException">Inner exception</param>
+        public EventGridException(
+            string message,
+            Exception innerException = null)
+            : base(message, innerException)
+        {
+            FullMessage = message;
+        }
+
+        /// <summary>
+        /// Gets the full message of the exception.
+        /// </summary>
+        public  string FullMessage { get; }
+        #endregion
+
+    }
+}

src/Common/Helpers/EventGridSubscriptionWrapper.cs

@@ -0,0 +1,77 @@
+#region Copyright
+//=======================================================================================
+// Microsoft Azure Customer Advisory Team 
+//
+// This sample is supplemental to the technical guidance published on my personal
+// blog at http://blogs.msdn.com/b/paolos/. 
+// 
+// Author: Paolo Salvatori
+//=======================================================================================
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// 
+// LICENSED UNDER THE APACHE LICENSE, VERSION 2.0 (THE "LICENSE"); YOU MAY NOT USE THESE 
+// FILES EXCEPT IN COMPLIANCE WITH THE LICENSE. YOU MAY OBTAIN A COPY OF THE LICENSE AT 
+// http://www.apache.org/licenses/LICENSE-2.0
+// UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING, SOFTWARE DISTRIBUTED UNDER THE 
+// LICENSE IS DISTRIBUTED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 
+// KIND, EITHER EXPRESS OR IMPLIED. SEE THE LICENSE FOR THE SPECIFIC LANGUAGE GOVERNING 
+// PERMISSIONS AND LIMITATIONS UNDER THE LICENSE.
+//=======================================================================================
+#endregion
+
+#region Using Directives
+
+using Azure.ResourceManager.EventGrid;
+
+#endregion
+
+namespace ServiceBusExplorer.Helpers
+{
+    /// <summary>
+    /// This class adds a Subscriptions collection to the TopicDescription class
+    /// </summary>
+    public class EventGridSubscriptionWrapper
+    {
+        #region Public Constructors
+        /// <summary>
+        /// Initializes a new instance of the SubscriptionWrapper class.
+        /// </summary>
+        public EventGridSubscriptionWrapper()
+        {
+            SubscriptionDescription = null;
+            TopicDescription = null;
+            Filter = null;
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the SubscriptionWrapper class.
+        /// </summary>
+        /// <param name="subscription">A subscription.</param>
+        /// <param name="topic">The topic the subscription belongs to.</param>
+        public EventGridSubscriptionWrapper(NamespaceTopicEventSubscriptionResource subscription, NamespaceTopicResource topic)
+        {
+            SubscriptionDescription = subscription;
+            TopicDescription = topic;
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the SubscriptionWrapper class.
+        /// </summary>
+        /// <param name="subscription">A subscription.</param>
+        /// <param name="topic">The topic the subscription belongs to.</param>
+        /// <param name="filter">The OData filter.</param>
+        public EventGridSubscriptionWrapper(NamespaceTopicEventSubscriptionResource subscription, NamespaceTopicResource topic, string filter)
+        {
+            SubscriptionDescription = subscription;
+            TopicDescription = topic;
+            Filter = filter;
+        }
+        #endregion
+
+        #region Public Properties
+        public NamespaceTopicEventSubscriptionResource SubscriptionDescription { get; set; }
+        public NamespaceTopicResource TopicDescription { get; set; }
+        public string Filter { get; set; }
+        #endregion
+    }
+}