#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 compression modules dynamically and exposes a list of those /// public class CompressionLoader { /// /// Implementation overrides specific to compression /// private class CompressionLoaderSub : 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(ICompression item) { return item.FilenameExtension; } /// /// Returns the subfolders searched for compression modules /// protected override string[] Subfolders { get { return new string[] { "compression" }; } } /// /// Instanciates a specific compression module, given the file extension and options /// /// The file extension to create the instance for /// The filename used to compress/decompress contents /// The options to pass to the instance constructor /// The instanciated encryption module or null if the file extension is not supported public ICompression GetModule(string fileExtension, string filename, Dictionary options) { if (string.IsNullOrEmpty(fileExtension)) throw new ArgumentNullException("fileExtension"); LoadInterfaces(); lock (m_lock) { if (m_interfaces.ContainsKey(fileExtension)) return (ICompression)Activator.CreateInstance(m_interfaces[fileExtension].GetType(), filename, 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) { ICompression b; if (m_interfaces.TryGetValue(key, out b) && b != null) return b.SupportedCommands; else return null; } } } /// /// The static instance used to access compression module information /// private static CompressionLoaderSub _compressionLoader = new CompressionLoaderSub(); #region Public static API /// /// Gets a list of loaded compression modules, the instances can be used to extract interface information, not used to interact with the module. /// public static ICompression[] Modules { get { return _compressionLoader.Interfaces; } } /// /// Gets a list of keys supported /// public static string[] Keys { get { return _compressionLoader.Keys; } } /// /// Gets the supported commands for a given compression module /// /// The compression module to find the commands for /// The supported commands or null if the key is not supported public static IList GetSupportedCommands(string key) { return _compressionLoader.GetSupportedCommands(key); } /// /// Instanciates a specific compression module, given the file extension and options /// /// The file extension to create the instance for /// The filename of the file used to compress/decompress contents /// The options to pass to the instance constructor /// The instanciated compression module or null if the file extension is not supported public static ICompression GetModule(string fileextension, string filename, Dictionary options) { return _compressionLoader.GetModule(fileextension, filename, options); } #endregion } }