//******************************************************************************************************
// MySqlInputAdapter.cs - Gbtc
//
// Copyright © 2012, Grid Protection Alliance. All Rights Reserved.
//
// Licensed to the Grid Protection Alliance (GPA) under one or more contributor license agreements. See
// the NOTICE file distributed with this work for additional information regarding copyright ownership.
// The GPA licenses this file to you under the MIT License (MIT), the "License"; you may
// not use this file except in compliance with the License. You may obtain a copy of the License at:
//
// http://www.opensource.org/licenses/MIT
//
// Unless agreed to in writing, the subject software distributed under the License is distributed on an
// "AS-IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. Refer to the
// License for the specific language governing permissions and limitations.
//
// Code Modification History:
// ----------------------------------------------------------------------------------------------------
// 11/13/2009 - Stephen C. Wills
// Generated original version of source code.
// 12/13/2012 - Starlynn Danyelle Gilliam
// Modified Header.
//
//******************************************************************************************************
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Data.Common;
using System.Linq;
using System.Reflection;
using System.Text;
using System.Timers;
using GSF;
using GSF.TimeSeries;
using GSF.TimeSeries.Adapters;
namespace MySqlAdapters
{
///
/// Represents an input adapter that reads measurements from a MySQL database table.
///
[Description("MySQL: Reads measurements from a MySQL database")]
public class MySqlInputAdapter : InputAdapterBase
{
#region [ Members ]
// Fields
private string m_mySqlConnectionString;
private DbConnection m_connection;
private Timer m_timer;
private int m_inputInterval;
private int m_measurementsPerInput;
private int m_startingMeasurement;
private bool m_fakeTimestamps;
private bool m_disposed;
#endregion
#region [ Constructors ]
///
/// Initializes a new instance of the class.
///
public MySqlInputAdapter()
{
m_timer = new Timer();
m_inputInterval = 33;
m_measurementsPerInput = 5;
m_fakeTimestamps = false;
}
#endregion
#region [ Properties ]
///
/// Gets or sets the interval of time, in milliseconds, between sending frames into the concentrator.
///
[ConnectionStringParameter,
Description("Define the interval of time, in milliseconds, between sending frames into the concentrator."),
DefaultValue(33)]
public int InputInterval
{
get
{
return m_inputInterval;
}
set
{
m_inputInterval = value;
}
}
///
/// Gets or sets the number of measurements that are read from the MySQL database in each frame.
///
[ConnectionStringParameter,
Description("Define the number of measurements that are read from the MySQL database in each frame."),
DefaultValue(5)]
public int MeasurementsPerInput
{
get
{
return m_measurementsPerInput;
}
set
{
m_measurementsPerInput = value;
}
}
///
/// Gets or sets the value that determines whether timestamps are simulated for real-time concentration.
///
[ConnectionStringParameter,
Description("Indicate whether timestamps are simulated for real-time concentration."),
DefaultValue(false)]
public bool FakeTimestamps
{
get
{
return m_fakeTimestamps;
}
set
{
m_fakeTimestamps = value;
}
}
///
/// Returns a connection string containing only the key-value pairs
/// that are used to connect to MySQL.
///
public string MySqlConnectionString
{
get
{
return m_mySqlConnectionString;
}
}
///
/// Gets a flag that determines if this
/// uses an asynchronous connection.
///
protected override bool UseAsyncConnect
{
get
{
return false;
}
}
///
/// Gets the flag indicating if this adapter supports temporal processing.
///
public override bool SupportsTemporalProcessing
{
get
{
return true;
}
}
#endregion
#region [ Methods ]
///
/// Initializes this .
///
public override void Initialize()
{
base.Initialize();
Dictionary settings = Settings;
string setting;
if (settings.TryGetValue("inputInterval", out setting))
m_inputInterval = int.Parse(setting);
if (settings.TryGetValue("measurementsPerInput", out setting))
m_measurementsPerInput = int.Parse(setting);
if (settings.TryGetValue("fakeTimestamps", out setting))
m_fakeTimestamps = bool.Parse(setting);
// Create the MySQL connection string using only the portions of the
// original connection string that are used by MySQL
StringBuilder builder = new StringBuilder();
string[] pairs = ConnectionString.Split(';');
foreach (string pair in pairs)
{
string key = pair.ToLower().Split('=')[0].Trim();
if (s_validKeys.Contains(key))
{
builder.Append(pair);
builder.Append(';');
}
}
m_mySqlConnectionString = builder.ToString();
// Create a new MySql connection object
m_connection = CreateConnection();
m_connection.ConnectionString = m_mySqlConnectionString;
m_connection.StateChange += m_connection_StateChange;
// Override input interval based on temporal processing interval if it's not set to default
if (ProcessingInterval > -1)
{
if (ProcessingInterval == 0)
m_inputInterval = 1;
else
m_inputInterval = ProcessingInterval;
}
// Set up the timer to trigger inputs
m_timer.Interval = m_inputInterval;
m_timer.AutoReset = true;
m_timer.Elapsed += m_timer_Elapsed;
}
///
/// Attempts to connect to this .
///
protected override void AttemptConnection()
{
m_connection.Open();
m_timer.Start();
}
///
/// Attempts to disconnect from this .
///
protected override void AttemptDisconnection()
{
m_timer.Stop();
m_connection.Close();
}
///
/// Gets a short one-line status of this .
///
/// Maximum length of the status message.
/// Text of the status message.
public override string GetShortStatus(int maxLength)
{
return string.Format("{0} measurements read from database.", ProcessedMeasurements).CenterText(maxLength);
}
///
/// Releases the unmanaged resources used by the object and optionally releases the managed resources.
///
/// true to release both managed and unmanaged resources; false to release only unmanaged resources.
protected override void Dispose(bool disposing)
{
if (!m_disposed)
{
try
{
if (disposing)
{
if (m_connection != null)
{
m_connection.StateChange -= m_connection_StateChange;
m_connection.Dispose();
}
m_connection = null;
if (m_timer != null)
{
m_timer.Elapsed -= m_timer_Elapsed;
m_timer.Dispose();
}
m_timer = null;
}
}
finally
{
m_disposed = true; // Prevent duplicate dispose.
base.Dispose(disposing); // Call base class Dispose().
}
}
}
private DbConnection CreateConnection()
{
string[] mySQLConnectorNetVersions = { "6.3.6.0", "6.3.4.0", "6.2.4.0", "6.1.5.0", "6.0.7.0", "5.2.7.0", "5.1.7.0", "5.0.9.0" };
string assemblyNameFormat = "MySql.Data, Version={0}, Culture=neutral, PublicKeyToken=c5687fc88969c44d";
string assemblyName;
// Attempt to load latest version of the MySQL connector net to creator the proper data provider string
foreach (string connectorNetVersion in mySQLConnectorNetVersions)
{
try
{
Assembly mySqlAssembly;
Type connectionType;
// Create an assembly name based on this version of the MySQL Connector/NET
assemblyName = string.Format(assemblyNameFormat, connectorNetVersion);
// See if this version of the MySQL Connector/NET can be loaded
mySqlAssembly = Assembly.Load(new AssemblyName(assemblyName));
// If assembly load succeeded, create a valid data provider string
connectionType = mySqlAssembly.GetType("MySql.Data.MySqlClient.MySqlConnection");
return (DbConnection)Activator.CreateInstance(connectionType);
}
catch
{
// Nothing to do but try next version
}
}
return null;
}
private void m_timer_Elapsed(object sender, ElapsedEventArgs e)
{
List measurements = new List();
StringBuilder columnString = new StringBuilder();
int timestampColumn = GetColumnIndex("Timestamp");
int idColumn = GetColumnIndex("SignalID");
int valueColumn = GetColumnIndex("Value");
string commandString;
IDbCommand command;
IDataReader reader;
foreach (string columnName in s_measurementColumns)
{
if (columnString.Length > 0)
columnString.Append(',');
columnString.Append(columnName);
}
commandString = string.Format("SELECT {0} FROM Measurement LIMIT {1},{2}", columnString, m_startingMeasurement, m_measurementsPerInput);
command = m_connection.CreateCommand();
command.CommandText = commandString;
using (reader = command.ExecuteReader())
{
while (reader.Read())
{
Ticks timeStamp = m_fakeTimestamps ? new Ticks(DateTime.UtcNow) : new Ticks(reader.GetInt64(timestampColumn));
MeasurementKey key = MeasurementKey.LookUpBySignalID(reader.GetGuid(idColumn));
if (key != MeasurementKey.Undefined)
{
measurements.Add(new Measurement
{
Metadata = key.Metadata,
Value = reader.GetDouble(valueColumn),
Timestamp = timeStamp
});
}
}
}
OnNewMeasurements(measurements);
m_startingMeasurement += m_measurementsPerInput;
}
private void m_connection_StateChange(object sender, StateChangeEventArgs e)
{
if (e.CurrentState == ConnectionState.Closed && Enabled)
{
// Connection lost,
// attempt to reconnect
Start();
}
}
#endregion
#region [ Static ]
// Static Fields
// Collection of column names used in database queries.
private static readonly string[] s_measurementColumns = { "SignalID", "Timestamp", "Value" };
// Collection of keys that can be used in a MySQL connection string.
private static readonly string[] s_validKeys =
{
"server", "port", "protocol",
"database", "uid", "user", "pwd", "password",
"encryption", "encrypt", "charset",
"default command timeout", "connection timeout",
"ignore prepare", "shared memory name"
};
// Static Methods
// Gets the index of the column specified by the column name.
private static int GetColumnIndex(string columnName)
{
for (int i = 0; i < s_measurementColumns.Length; i++)
{
if (s_measurementColumns[i] == columnName)
return i;
}
return -1;
}
#endregion
}
}