/// <summary> /// Returns a new temporal <see cref="IaonSession"/> for a <see cref="IClientSubscription"/>. /// </summary> /// <param name="clientSubscription"><see cref="IClientSubscription"/> instance to create temporal <see cref="IaonSession"/> for.</param> /// <returns>New temporal <see cref="IaonSession"/> for a <see cref="IClientSubscription"/>.</returns> public static IaonSession CreateTemporalSession(this IClientSubscription clientSubscription) { IaonSession session; // Cache the specified input measurement keys requested by the remote subscription // internally since these will only be needed in the private Iaon session MeasurementKey[] inputMeasurementKeys = clientSubscription.InputMeasurementKeys; IMeasurement[] outputMeasurements = clientSubscription.OutputMeasurements; // Since historical data is requested, we "turn off" interaction with the outside real-time world // by removing the client subscription adapter from external routes. To accomplish this we expose // I/O demands for an undefined measurement as assigning to null would mean "broadcast" is desired. clientSubscription.InputMeasurementKeys = new[] { MeasurementKey.Undefined }; clientSubscription.OutputMeasurements = new IMeasurement[] { Measurement.Undefined }; // Create a new Iaon session session = new IaonSession(); session.Name = "<" + clientSubscription.HostName.ToNonNullString("unavailable") + ">@" + clientSubscription.StartTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss"); // Assign requested input measurement keys as a routing restriction session.InputMeasurementKeysRestriction = inputMeasurementKeys; // Setup default bubbling event handlers associated with the client session adapter EventHandler <EventArgs <string, UpdateType> > statusMessageHandler = (sender, e) => { if (e.Argument2 == UpdateType.Information) { clientSubscription.OnStatusMessage(e.Argument1); } else { clientSubscription.OnStatusMessage("0x" + (int)e.Argument2 + e.Argument1); } }; EventHandler <EventArgs <Exception> > processExceptionHandler = (sender, e) => clientSubscription.OnProcessException(e.Argument); EventHandler processingCompletedHandler = clientSubscription.OnProcessingCompleted; // Cache dynamic event handlers so they can be detached later s_statusMessageHandlers[clientSubscription] = statusMessageHandler; s_processExceptionHandlers[clientSubscription] = processExceptionHandler; s_processingCompletedHandlers[clientSubscription] = processingCompletedHandler; // Attach handlers to new session - this will proxy all temporal session messages through the client session adapter session.StatusMessage += statusMessageHandler; session.ProcessException += processExceptionHandler; session.ProcessingComplete += processingCompletedHandler; // Send the first message indicating a new temporal session is being established statusMessageHandler(null, new EventArgs <string, UpdateType>( string.Format("Initializing temporal session for host \"{0}\" spanning {1} to {2} processing data {3}...", clientSubscription.HostName.ToNonNullString("unknown"), clientSubscription.StartTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss.fff"), clientSubscription.StopTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss.fff"), clientSubscription.ProcessingInterval == 0 ? "as fast as possible" : clientSubscription.ProcessingInterval == -1 ? "at the default rate" : "at " + clientSubscription.ProcessingInterval + "ms intervals"), UpdateType.Information)); // Duplicate current real-time session configuration for adapters that report temporal support session.DataSource = IaonSession.ExtractTemporalConfiguration(clientSubscription.DataSource); // Initialize temporal session adapters without starting them session.Initialize(false); // Define an in-situ action adapter for the temporal Iaon session used to proxy data back to the client subscription. Note // to enable adapters that are connect-on-demand in the temporal session, we must make sure the proxy adapter is setup to // respect input demands. The proxy adapter produces no points into the temporal session - all received points are simply // internally proxied out to the parent client subscription outside the purview of the Iaon session; from the perspective // of the Iaon session, points seem to dead-end in the proxy adapter. The proxy adapter is an action adapter and action // adapters typically produce measurements, as such, actions default to respecting output demands not input demands. Using // the default settings of not respecting input demands and the proxy adapter not producing any points, the Iaon session // would ignore the adapter's input needs. In this case we want Iaon session to recognize the inputs of the proxy adapter // as important to the connect-on-demand dependency chain, so we request respect for the input demands. TemporalClientSubscriptionProxy proxyAdapter = new TemporalClientSubscriptionProxy { // Assign critical adapter properties ID = 0, Name = "PROXY!SERVICES", ConnectionString = "", DataSource = session.DataSource, RespectInputDemands = true, InputMeasurementKeys = inputMeasurementKeys, OutputMeasurements = outputMeasurements, Parent = clientSubscription, Initialized = true }; // Add new proxy adapter to temporal session action adapter collection - this will start adapter session.ActionAdapters.Add(proxyAdapter); // Load current temporal constraint parameters Dictionary <string, string> settings = clientSubscription.Settings; string startTime, stopTime, parameters; settings.TryGetValue("startTimeConstraint", out startTime); settings.TryGetValue("stopTimeConstraint", out stopTime); settings.TryGetValue("timeConstraintParameters", out parameters); // Assign requested temporal constraints to all private session adapters session.AllAdapters.SetTemporalConstraint(startTime, stopTime, parameters); session.AllAdapters.ProcessingInterval = clientSubscription.ProcessingInterval; // Start temporal session adapters session.AllAdapters.Start(); // Recalculate routing tables to accommodate addition of proxy adapter and handle // input measurement keys restriction session.RecalculateRoutingTables(); return(session); }
/// <summary> /// Returns a new temporal <see cref="IaonSession"/> for a <see cref="IClientSubscription"/>. /// </summary> /// <param name="clientSubscription"><see cref="IClientSubscription"/> instance to create temporal <see cref="IaonSession"/> for.</param> /// <returns>New temporal <see cref="IaonSession"/> for a <see cref="IClientSubscription"/>.</returns> public static IaonSession CreateTemporalSession(this IClientSubscription clientSubscription) { IaonSession session; // Cache the specified input measurement keys requested by the remote subscription // internally since these will only be needed in the private Iaon session MeasurementKey[] inputMeasurementKeys = clientSubscription.InputMeasurementKeys; IMeasurement[] outputMeasurements = clientSubscription.OutputMeasurements; // Since historical data is requested, we "turn off" interaction with the outside real-time world // by removing this adapter from external routes. To accomplish this we expose I/O demands for an // undefined measurement. Note: assigning to null would mean "broadcast" of all data is desired. clientSubscription.InputMeasurementKeys = new MeasurementKey[] { MeasurementKey.Undefined }; clientSubscription.OutputMeasurements = new IMeasurement[] { Measurement.Undefined }; // Create a new Iaon session session = new IaonSession(); session.Name = "<" + clientSubscription.HostName.ToNonNullString("unavailable") + ">@" + clientSubscription.StartTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss"); // Assign requested input measurement keys as a routing restriction session.InputMeasurementKeysRestriction = inputMeasurementKeys; // Setup default bubbling event handlers associated with the client session adapter EventHandler <EventArgs <string, UpdateType> > statusMessageHandler = (sender, e) => { if (e.Argument2 == UpdateType.Information) { clientSubscription.OnStatusMessage(e.Argument1); } else { clientSubscription.OnStatusMessage("0x" + (int)e.Argument2 + e.Argument1); } }; EventHandler <EventArgs <Exception> > processExceptionHandler = (sender, e) => clientSubscription.OnProcessException(e.Argument); EventHandler processingCompletedHandler = (sender, e) => clientSubscription.OnProcessingCompleted(sender, e); // Cache dynamic event handlers so they can be detached later s_statusMessageHandlers[clientSubscription] = statusMessageHandler; s_processExceptionHandlers[clientSubscription] = processExceptionHandler; s_processingCompletedHandlers[clientSubscription] = processingCompletedHandler; // Attach handlers to new session - this will proxy all temporal session messages through the client session adapter session.StatusMessage += statusMessageHandler; session.ProcessException += processExceptionHandler; session.ProcessingComplete += processingCompletedHandler; // Send the first message indicating a new temporal session is being established statusMessageHandler(null, new EventArgs <string, UpdateType>( string.Format("Initializing temporal session for host \"{0}\" spanning {1} to {2} processing data {3}...", clientSubscription.HostName.ToNonNullString("unknown"), clientSubscription.StartTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss.fff"), clientSubscription.StopTimeConstraint.ToString("yyyy-MM-dd HH:mm:ss.fff"), clientSubscription.ProcessingInterval == 0 ? "as fast as possible" : clientSubscription.ProcessingInterval == -1 ? "at the default rate" : "at " + clientSubscription.ProcessingInterval + "ms intervals"), UpdateType.Information)); // Duplicate current real-time session configuration for adapters that report temporal support session.DataSource = IaonSession.ExtractTemporalConfiguration(clientSubscription.DataSource); // Define an in-situ action adapter for the temporal Iaon session used to proxy data back to the client subscription DataTable actionAdapters = session.DataSource.Tables["ActionAdapters"]; DataRow proxyAdapterRow = actionAdapters.NewRow(); // Define connection string for proxy adapter based on original inputs and ouputs as requested by client subscription StringBuilder connectionString = new StringBuilder(); if (inputMeasurementKeys != null && inputMeasurementKeys.Length > 0) { connectionString.AppendFormat("inputMeasurementKeys={{{0}}}", inputMeasurementKeys.Select(key => key.SignalID).ToDelimitedString(";")); } if (outputMeasurements != null && outputMeasurements.Length > 0) { if (connectionString.Length > 0) { connectionString.Append("; "); } connectionString.AppendFormat("outputMeasurements={{{0}}}", outputMeasurements.Select(m => m.ID).ToDelimitedString(";")); } // Assign critical adapter properties proxyAdapterRow["ID"] = 0; proxyAdapterRow["AdapterName"] = "PROXY!SERVICES"; proxyAdapterRow["AssemblyName"] = "GSF.TimeSeries.dll"; proxyAdapterRow["TypeName"] = "GSF.TimeSeries.Transport.TemporalClientSubscriptionProxy"; proxyAdapterRow["ConnectionString"] = connectionString.ToString(); // Add proxy row to Iaon action adapter definitions actionAdapters.Rows.Add(proxyAdapterRow); // Initialize temporal session adapters without starting them session.Initialize(false); // Get reference to temporal session proxy adapter to it can be associated with the client subscription TemporalClientSubscriptionProxy proxyAdapter = null; IActionAdapter adapter0; // Lookup proxy adapter defined with reserved ID zero if (session.ActionAdapters.TryGetAdapterByID(0, out adapter0)) { proxyAdapter = adapter0 as TemporalClientSubscriptionProxy; } if ((object)proxyAdapter == null) { throw new InvalidOperationException("Failed to define temporal subscription proxy adapter - cannot complete temporal session initialization."); } // Associate proxy with client subscription proxyAdapter.Parent = clientSubscription; // Load current temporal constraint parameters Dictionary <string, string> settings = clientSubscription.Settings; string startTime, stopTime, parameters; settings.TryGetValue("startTimeConstraint", out startTime); settings.TryGetValue("stopTimeConstraint", out stopTime); settings.TryGetValue("timeConstraintParameters", out parameters); // Assign requested temporal constraints to all private session adapters session.AllAdapters.SetTemporalConstraint(startTime, stopTime, parameters); session.AllAdapters.ProcessingInterval = clientSubscription.ProcessingInterval; // Start temporal session adapters session.AllAdapters.Start(); // Recalculate routing tables to accomodate addtion of proxy adapter and handle // input measurement keys restriction session.RecalculateRoutingTables(); return(session); }