#region Disclaimer / License // Copyright (C) 2011, Kenneth Skovhede // http://www.hexad.dk, opensource@hexad.dk // // This library is free software; you can redistribute it and/or // modify it under the terms of the GNU Lesser General Public // License as published by the Free Software Foundation; either // version 2.1 of the License, or (at your option) any later version. // // This library is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU // Lesser General Public License for more details. // // You should have received a copy of the GNU Lesser General Public // License along with this library; if not, write to the Free Software // Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA // #endregion using System; using System.Collections.Generic; using System.Text; using Duplicati.Library.Interface; namespace Duplicati.Library.DynamicLoader { /// /// Loads all encryption modules dynamically and exposes a list of those /// public class EncryptionLoader { /// /// Implementation overrides specific to encryption /// private class EncryptionLoaderSub : DynamicLoader { /// /// Returns the filename extension, which is also the key /// /// The item to load the key for /// The file extension used by the module protected override string GetInterfaceKey(IEncryption item) { return item.FilenameExtension; } /// /// Returns the subfolders searched for encryption modules /// protected override string[] Subfolders { get { return new string[] { "encryption" }; } } /// /// Instanciates a specific encryption module, given the file extension and options /// /// The file extension to create the instance for /// The passphrase used to encrypt contents /// The options to pass to the instance constructor /// The instanciated encryption module or null if the file extension is not supported public IEncryption GetModule(string fileExtension, string passphrase, Dictionary options) { if (string.IsNullOrEmpty(fileExtension)) throw new ArgumentNullException("fileExtension"); if (string.IsNullOrEmpty(passphrase)) throw new ArgumentNullException("passphrase"); LoadInterfaces(); lock (m_lock) { if (m_interfaces.ContainsKey(fileExtension)) return (IEncryption)Activator.CreateInstance(m_interfaces[fileExtension].GetType(), passphrase, options); else return null; } } /// /// Gets the supported commands for a certain key /// /// The key to find commands for /// The supported commands or null if the key was not found public IList GetSupportedCommands(string key) { if (string.IsNullOrEmpty(key)) throw new ArgumentNullException("key"); LoadInterfaces(); lock (m_lock) { IEncryption b; if (m_interfaces.TryGetValue(key, out b) && b != null) return b.SupportedCommands; else return null; } } } /// /// The static instance used to access encryption module information /// private static EncryptionLoaderSub _encryptionLoader = new EncryptionLoaderSub(); #region Public static API /// /// Gets a list of loaded encryption modules, the instances can be used to extract interface information, not used to interact with the module. /// public static IEncryption[] Modules { get { return _encryptionLoader.Interfaces; } } /// /// Gets a list of keys supported /// public static string[] Keys { get { return _encryptionLoader.Keys; } } /// /// Gets the supported commands for a given encryption module /// /// The encryption module to find the commands for /// The supported commands or null if the key is not supported public static IList GetSupportedCommands(string key) { return _encryptionLoader.GetSupportedCommands(key); } /// /// Instanciates a specific encryption module, given the file extension and options /// /// The file extension to create the instance for /// The passphrase used to encrypt contents /// The options to pass to the instance constructor /// The instanciated encryption module or null if the file extension is not supported public static IEncryption GetModule(string fileextension, string passphrase, Dictionary options) { return _encryptionLoader.GetModule(fileextension, passphrase, options); } #endregion } }