jellyfin/MediaBrowser.Common/Plugins/BasePlugin.cs

353 lines
11 KiB
C#
Raw Normal View History

2013-03-04 05:43:06 +00:00
using MediaBrowser.Common.Configuration;
2013-02-21 01:33:05 +00:00
using MediaBrowser.Model.Plugins;
using MediaBrowser.Model.Serialization;
2013-02-21 01:33:05 +00:00
using System;
using System.IO;
using System.Reflection;
using System.Runtime.InteropServices;
namespace MediaBrowser.Common.Plugins
{
/// <summary>
/// Provides a common base class for all plugins
/// </summary>
/// <typeparam name="TConfigurationType">The type of the T configuration type.</typeparam>
public abstract class BasePlugin<TConfigurationType> : IPlugin
2013-02-21 01:33:05 +00:00
where TConfigurationType : BasePluginConfiguration
{
/// <summary>
2013-03-04 05:43:06 +00:00
/// Gets the application paths.
2013-02-21 01:33:05 +00:00
/// </summary>
2013-03-04 05:43:06 +00:00
/// <value>The application paths.</value>
protected IApplicationPaths ApplicationPaths { get; private set; }
2013-02-21 01:33:05 +00:00
/// <summary>
/// Gets the XML serializer.
/// </summary>
/// <value>The XML serializer.</value>
protected IXmlSerializer XmlSerializer { get; private set; }
2013-02-21 01:33:05 +00:00
/// <summary>
/// Gets the name of the plugin
/// </summary>
/// <value>The name.</value>
public abstract string Name { get; }
2013-04-11 01:52:15 +00:00
/// <summary>
/// Gets a value indicating whether this instance is first run.
/// </summary>
/// <value><c>true</c> if this instance is first run; otherwise, <c>false</c>.</value>
public bool IsFirstRun { get; private set; }
2013-02-21 01:33:05 +00:00
/// <summary>
/// Gets the description.
/// </summary>
/// <value>The description.</value>
public virtual string Description
{
get { return string.Empty; }
}
/// <summary>
/// Gets the type of configuration this plugin uses
/// </summary>
/// <value>The type of the configuration.</value>
public Type ConfigurationType
{
get { return typeof(TConfigurationType); }
}
2013-02-21 01:33:05 +00:00
/// <summary>
/// The _assembly name
/// </summary>
private AssemblyName _assemblyName;
/// <summary>
/// Gets the name of the assembly.
/// </summary>
/// <value>The name of the assembly.</value>
protected AssemblyName AssemblyName
{
get
{
return _assemblyName ?? (_assemblyName = GetType().Assembly.GetName());
}
}
/// <summary>
/// The _unique id
/// </summary>
private Guid? _uniqueId;
/// <summary>
/// Gets the unique id.
/// </summary>
/// <value>The unique id.</value>
2013-02-22 06:28:57 +00:00
public Guid Id
2013-02-21 01:33:05 +00:00
{
get
{
if (!_uniqueId.HasValue)
{
var attribute = (GuidAttribute)GetType().Assembly.GetCustomAttributes(typeof(GuidAttribute), true)[0];
_uniqueId = new Guid(attribute.Value);
2013-02-21 01:33:05 +00:00
}
return _uniqueId.Value;
}
}
/// <summary>
/// Gets the plugin version
/// </summary>
/// <value>The version.</value>
public Version Version
{
get
{
return AssemblyName.Version;
}
}
/// <summary>
/// Gets the name the assembly file
/// </summary>
/// <value>The name of the assembly file.</value>
public string AssemblyFileName
{
get
{
return AssemblyName.Name + ".dll";
}
}
/// <summary>
/// Gets the last date modified of the configuration
/// </summary>
/// <value>The configuration date last modified.</value>
public DateTime ConfigurationDateLastModified
{
get
{
// Ensure it's been lazy loaded
var config = Configuration;
return File.GetLastWriteTimeUtc(ConfigurationFilePath);
}
}
/// <summary>
/// Gets the last date modified of the plugin
/// </summary>
/// <value>The assembly date last modified.</value>
public DateTime AssemblyDateLastModified
{
get
{
return File.GetLastWriteTimeUtc(AssemblyFilePath);
}
}
/// <summary>
/// Gets the path to the assembly file
/// </summary>
/// <value>The assembly file path.</value>
public string AssemblyFilePath
{
get
{
2013-03-04 05:43:06 +00:00
return Path.Combine(ApplicationPaths.PluginsPath, AssemblyFileName);
2013-02-21 01:33:05 +00:00
}
}
/// <summary>
/// The _configuration sync lock
/// </summary>
2014-12-21 05:57:06 +00:00
private readonly object _configurationSyncLock = new object();
2013-02-21 01:33:05 +00:00
/// <summary>
/// The _configuration
/// </summary>
private TConfigurationType _configuration;
/// <summary>
/// Gets the plugin's configuration
/// </summary>
/// <value>The configuration.</value>
public TConfigurationType Configuration
{
get
{
// Lazy load
2014-12-21 05:57:06 +00:00
if (_configuration == null)
{
lock (_configurationSyncLock)
{
if (_configuration == null)
{
_configuration = LoadConfiguration();
}
}
}
2013-02-21 01:33:05 +00:00
return _configuration;
}
protected set
{
_configuration = value;
2014-12-21 05:57:06 +00:00
}
}
2013-02-21 01:33:05 +00:00
2014-12-21 05:57:06 +00:00
private TConfigurationType LoadConfiguration()
{
var path = ConfigurationFilePath;
try
{
return (TConfigurationType)XmlSerializer.DeserializeFromFile(typeof(TConfigurationType), path);
}
2014-12-23 03:58:14 +00:00
catch (DirectoryNotFoundException)
{
return (TConfigurationType)Activator.CreateInstance(typeof(TConfigurationType));
}
2014-12-21 05:57:06 +00:00
catch (FileNotFoundException)
{
return (TConfigurationType)Activator.CreateInstance(typeof(TConfigurationType));
}
catch (Exception ex)
{
return (TConfigurationType)Activator.CreateInstance(typeof(TConfigurationType));
2013-02-21 01:33:05 +00:00
}
}
/// <summary>
/// Gets the name of the configuration file. Subclasses should override
/// </summary>
/// <value>The name of the configuration file.</value>
public virtual string ConfigurationFileName
{
get { return Path.ChangeExtension(AssemblyFileName, ".xml"); }
}
/// <summary>
/// Gets the full path to the configuration file
/// </summary>
/// <value>The configuration file path.</value>
public string ConfigurationFilePath
{
get
{
2013-03-04 05:43:06 +00:00
return Path.Combine(ApplicationPaths.PluginConfigurationsPath, ConfigurationFileName);
2013-02-21 01:33:05 +00:00
}
}
/// <summary>
/// The _data folder path
/// </summary>
private string _dataFolderPath;
/// <summary>
/// Gets the full path to the data folder, where the plugin can store any miscellaneous files needed
/// </summary>
/// <value>The data folder path.</value>
public string DataFolderPath
{
get
{
if (_dataFolderPath == null)
{
// Give the folder name the same name as the config file name
// We can always make this configurable if/when needed
2013-03-04 05:43:06 +00:00
_dataFolderPath = Path.Combine(ApplicationPaths.PluginsPath, Path.GetFileNameWithoutExtension(ConfigurationFileName));
2013-02-21 01:33:05 +00:00
Directory.CreateDirectory(_dataFolderPath);
2013-02-21 01:33:05 +00:00
}
return _dataFolderPath;
}
}
/// <summary>
/// Initializes a new instance of the <see cref="BasePlugin{TConfigurationType}" /> class.
2013-02-21 01:33:05 +00:00
/// </summary>
2013-03-04 05:43:06 +00:00
/// <param name="applicationPaths">The application paths.</param>
2013-02-24 21:53:54 +00:00
/// <param name="xmlSerializer">The XML serializer.</param>
2013-03-04 05:43:06 +00:00
protected BasePlugin(IApplicationPaths applicationPaths, IXmlSerializer xmlSerializer)
2013-02-21 01:33:05 +00:00
{
2013-03-04 05:43:06 +00:00
ApplicationPaths = applicationPaths;
XmlSerializer = xmlSerializer;
2013-05-02 02:44:52 +00:00
IsFirstRun = !File.Exists(ConfigurationFilePath);
2013-02-21 01:33:05 +00:00
}
/// <summary>
/// The _save lock
/// </summary>
private readonly object _configurationSaveLock = new object();
/// <summary>
/// Saves the current configuration to the file system
/// </summary>
public virtual void SaveConfiguration()
{
lock (_configurationSaveLock)
{
2013-12-29 14:12:29 +00:00
Directory.CreateDirectory(Path.GetDirectoryName(ConfigurationFilePath));
2013-02-21 01:33:05 +00:00
XmlSerializer.SerializeToFile(Configuration, ConfigurationFilePath);
}
}
/// <summary>
/// Completely overwrites the current configuration with a new copy
/// Returns true or false indicating success or failure
/// </summary>
/// <param name="configuration">The configuration.</param>
/// <exception cref="System.ArgumentNullException">configuration</exception>
public virtual void UpdateConfiguration(BasePluginConfiguration configuration)
{
if (configuration == null)
{
throw new ArgumentNullException("configuration");
}
2013-02-21 01:33:05 +00:00
Configuration = (TConfigurationType)configuration;
SaveConfiguration();
}
/// <summary>
/// Gets the plugin info.
/// </summary>
/// <returns>PluginInfo.</returns>
public PluginInfo GetPluginInfo()
{
var info = new PluginInfo
{
Name = Name,
Version = Version.ToString(),
AssemblyFileName = AssemblyFileName,
ConfigurationDateLastModified = ConfigurationDateLastModified,
Description = Description,
2015-03-08 17:58:45 +00:00
Id = Id.ToString(),
2013-02-21 01:33:05 +00:00
ConfigurationFileName = ConfigurationFileName
};
return info;
}
/// <summary>
/// Called when just before the plugin is uninstalled from the server.
/// </summary>
public virtual void OnUninstalling()
{
2013-02-21 01:33:05 +00:00
}
/// <summary>
/// Gets the plugin's configuration
/// </summary>
/// <value>The configuration.</value>
BasePluginConfiguration IPlugin.Configuration
{
get { return Configuration; }
}
}
}