// Copyright (C) 2024, The Duplicati Team // https://duplicati.com, hello@duplicati.com // // Permission is hereby granted, free of charge, to any person obtaining a // copy of this software and associated documentation files (the "Software"), // to deal in the Software without restriction, including without limitation // the rights to use, copy, modify, merge, publish, distribute, sublicense, // and/or sell copies of the Software, and to permit persons to whom the // Software is furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING // FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER // DEALINGS IN THE SOFTWARE. using System; using System.Collections.Generic; using System.Text; using Duplicati.Library.Interface; using System.Collections.Specialized; using System.Web; using System.Linq; using System.Runtime.ExceptionServices; namespace Duplicati.Library.DynamicLoader { /// /// Loads all backends dynamically and exposes a list of those /// public class BackendLoader { /// /// Implementation overrides specific to backends /// private class BackendLoaderSub : DynamicLoader { /// /// Returns the protocol key /// /// The item to load the key for /// The protocol key protected override string GetInterfaceKey(IBackend item) { return item.ProtocolKey; } /// /// Returns the subfolders searched for backends /// protected override string[] Subfolders { get { return new string[] {"backends"}; } } /// /// Instanciates a specific backend, given the url and options /// /// The url to create the instance for /// The options to pass to the instance constructor /// The instanciated backend or null if the url is not supported public IBackend GetBackend(string url, Dictionary options) { var uri = new Utility.Uri(url); LoadInterfaces(); var newOpts = new Dictionary(options); foreach (var key in uri.QueryParameters.AllKeys) newOpts[key] = uri.QueryParameters[key]; lock (m_lock) { try { if (m_interfaces.ContainsKey(uri.Scheme)) return (IBackend)Activator.CreateInstance(m_interfaces[uri.Scheme].GetType(), url, newOpts); else if (uri.Scheme.EndsWith("s", StringComparison.Ordinal)) { var tmpscheme = uri.Scheme.Substring(0, uri.Scheme.Length - 1); if (m_interfaces.ContainsKey(tmpscheme)) { var commands = m_interfaces[tmpscheme].SupportedCommands; if (commands != null && (commands.Any(x => x.Name.Equals("use-ssl", StringComparison.OrdinalIgnoreCase) || (x.Aliases != null && x.Aliases.Any(y => y.Equals("use-ssl", StringComparison.OrdinalIgnoreCase))) ))) { newOpts["use-ssl"] = "true"; return (IBackend)Activator.CreateInstance(m_interfaces[tmpscheme].GetType(), url, newOpts); } } } } catch (System.Reflection.TargetInvocationException tex) { if (tex.InnerException != null) { // Unwrap exceptions for nicer display. The ExceptionDispatchInfo class allows us to // rethrow an exception without changing the stack trace. ExceptionDispatchInfo.Capture(tex.InnerException).Throw(); } throw; } return null; } } /// /// Gets the supported commands for a certain url /// /// The url to find commands for /// The supported commands or null if the url scheme was not supported public IList GetSupportedCommands(string url) { var uri = new Utility.Uri(url); LoadInterfaces(); lock (m_lock) { IBackend b; if (m_interfaces.TryGetValue(uri.Scheme, out b) && b != null) return b.SupportedCommands; else if (uri.Scheme.EndsWith("s", StringComparison.Ordinal)) { var tmpscheme = uri.Scheme.Substring(0, uri.Scheme.Length - 1); if (m_interfaces.ContainsKey(tmpscheme)) return m_interfaces[tmpscheme].SupportedCommands; } return null; } } } /// /// The static instance used to access backend information /// private static readonly BackendLoaderSub _backendLoader = new BackendLoaderSub(); #region Public static API /// /// Gets a list of loaded backends, the instances can be used to extract interface information, not used to interact with the backend. /// public static IBackend[] Backends { get { return _backendLoader.Interfaces; } } /// /// Gets a list of keys supported /// public static string[] Keys { get { return _backendLoader.Keys; } } /// /// Gets the supported commands for a given backend /// /// The url to find the commands for /// The supported commands or null if the url is not supported public static IList GetSupportedCommands(string url) { if (string.IsNullOrEmpty(url)) throw new ArgumentNullException(nameof(url)); return _backendLoader.GetSupportedCommands(url); } /// /// Instanciates a specific backend, given the url and options /// /// The url to create the instance for /// The options to pass to the instance constructor /// The instanciated backend or null if the url is not supported public static IBackend GetBackend(string url, Dictionary options) { return _backendLoader.GetBackend(url, options); } #endregion } }