C# Anwendung Plugin fähig machen
By martin on Regards: .NET Framework; C#;
/// <summary> /// Definiert das "Aussehen" unseres Plugins /// </summary> public interface IPlugin { /// <summary> /// Name des Plugins /// </summary> String Name { get; set; } /// <summary> /// Beschreibung des Plugins /// </summary> String Description { get; set; } /// <summary> /// Berechnet die Eingabe /// </summary> /// <param name="pInput">Eingabe die ausgewertet werden soll.</param> /// <returns>Gibt das berechnete Ergebnis zurück</returns> String Calc(String pInput); }
Das bedeutet, dass jeder, der unser Interface implementiert zwei Properties “Name” und “Description” definiert und zu guter Letzt eine Funktion “Calc”.
Im Namen speichern wir den Funktionsnamen der Mathematischen Funktion. Als z.B. „sqrt“. In der Funktion Calc berechnen wir den Übergabewert pInput und geben das Ergebnis als String zurück. Natürlich wäre eine andere Mathematische Funktion wie z.B. Modulointeressanter zu implementieren.Als nächstes gilt es die Mathematik Klasse MathCore zu erstellen, welche die Plugins lädt und erstellt.
Als erstes wird die Funktion LoadPlugins aufgerufen. Dieser übergeben wir den Dateipfad in dem sich die Plugins befinden.
Als nächstes gilt es die Mathematik Klasse MathCore zu erstellen, welche die Plugins lädt und erstellt.
Als erstes wird die Funktion LoadPlugins aufgerufen. Dieser übergeben wir den Dateipfad in dem sich die Plugins befinden.
public void LoadPlugins(String pPluginPath) { String[] files = Directory.GetFiles(pPluginPath); foreach (String file in files) { FileInfo fileInfo = new FileInfo(file); if (fileInfo.Extension.Equals(".dll")) { Dictionary<string, object> dictionary = GetModul(file, typeof(IPlugin.IPlugin)); foreach (var a in dictionary) { Plugins.Add(a.Key,a.Value); } } } }
Es werden alle Dateien aus dem Verzeichnis gelesen und Dateien mit der Dateiendung „.dll“ gefiltert. Ist eine Datei eine „.dll“, wird die Funktion GetModul(file, Type) aufgerufen. Diese lädt die Plugins in unsere Instanz hinein. Sehen wir uns dazu diese Funktion genauer an.
private static Dictionary<string, object> GetModul(string pFileName, Type pTypeInterface) { //Hier speichern wir unsere Plugins Dictionary<string, object> interfaceinstances = new Dictionary<string, object>(); //Loads an assembly given its file name or path. Assembly assembly = Assembly.LoadFrom(pFileName); // http://msdn.microsoft.com/de-de/library/t0cs7xez.aspx // Assembly Eigenschaften checken foreach (Type type in assembly.GetTypes()) { if (type.IsPublic) // Ruft einen Wert ab, der angibt, ob der Type als öffentlich deklariert ist. { if (!type.IsAbstract) //nur Assemblys verwenden die nicht Abstrakt sind { // Sucht die Schnittstelle mit dem angegebenen Namen. Type typeInterface = type.GetInterface(pTypeInterface.ToString(), true); //Make sure the interface we want to use actually exists if (typeInterface != null) { try { object activedInstance = Activator.CreateInstance(type); if (activedInstance != null) { interfaceinstances.Add(type.Name, activedInstance); } } catch (Exception exception) { System.Diagnostics.Debug.WriteLine(exception); } } typeInterface = null; } } } assembly = null; return interfaceinstances; }
Der Funktion wird der Pfad der Assembly übergeben, die nach Plugins durchsucht werden soll. Zusätzlich muss man den Typ des Plugins übergeben.
Wir laden die Assembly mit Assembly.LoadFrom() damit wir Informationen aus ihr lesen können (Stichwort Reflection). Mit der Funktion GetTypes() erhalten wir alle Typen (Klassen), die in der Assembly gespeichert sind. Als nächstes führen wir ein paar Routineprüfungen durch wie z.B. ob der Typ public ist und nicht abstrakt.
Danach „suchen“ oder besser gesagt holen wir mit der Methode GetInterface() das Plugin-Interface falls der gerade iterierende Typ das Plugin implementiert hat. Falls kein Interface implementiert wurde ist der Rückgabewert NULL. Deshalb wird als nächstes überprüft ob der Rückgabewert ungleich NULL ist. Haben wir einen Rückgabewert erhalten, erstellen wir mit Activator.CreateInstance eine Instanz. Diese speichern wir dann in unser Dictionary.
So werden die Plugins Schritt für Schritt in unsere Anwendung geladen. Wurden alle Dateien auf Plugins überprüft, kann man mit der Funktion public string Calc(string pInput) Mathematikfunktionen aufrufen bzw. ausführen.
Ruft man _MathCore.Calc(“sqrt(3)”) auf, wird in der Funktion Calc der Input String interpretiert damit man weiß, welche Mathematikfunktion aufgerufen wird. In diesem Fall wäre das „sqrt“. Anschließend wird nach dem passenden Plugin mit der Funktion GetPlugin gesucht. Wurde es gefunden, wird der Input String an das Plugin weitergereicht und die Funktion Calc vom Plugin aufgerufen.
Wurde kein Plugin gefunden, wird “Funktion nicht gefunden” zurückgegeben.
Wie gesagt handelt es sich hierbei um ein sehr einfaches Plugin-System. Das Beispiel verwendet die Plugins zwar nur in einer Konsolen Applikation, trotzdem sollte es kein Problem sein, das Ganze in WPF oder WinForms umzusetzen.
Bei einem ausgereiften Plugin-System gibt es Features wie z.B., dass die Plugins auf bestimmte Teile des Host System zugreifen können (z.b auf ein Control), dass Plugins wiederum Plugins enthalten können oder, dass die Plugins in einer Art Sandbox (Stichwort AppDomain ) gehostet werden damit kein schädlicher Code ausgeführt werden kann usw. usf.
Seit .NET 2< wurden eine Reihe neuer Techniken mitgeliefert die das Erstellen von Plugins vereinfachen soll.
Anbei ein paar Links:
http://www.mycsharp.de/wbb2/thread.php?threadid=34472
http://www.codeproject.com/KB/cs/pluginsincsharp.aspx
Beispiel Projekt herunterladen