2013-10-05 18:38:36 -07:00
using System.Net ;
using MediaBrowser.Common.Configuration ;
2013-03-06 22:34:00 -07:00
using MediaBrowser.Common.Events ;
2013-09-24 17:54:51 -07:00
using MediaBrowser.Common.Implementations.Archiving ;
2013-09-30 15:18:44 -07:00
using MediaBrowser.Common.Implementations.IO ;
2013-03-03 22:43:06 -07:00
using MediaBrowser.Common.Implementations.ScheduledTasks ;
using MediaBrowser.Common.Implementations.Security ;
using MediaBrowser.Common.Implementations.Serialization ;
2013-02-27 10:07:12 -07:00
using MediaBrowser.Common.Implementations.Updates ;
2013-02-27 09:46:48 -07:00
using MediaBrowser.Common.Net ;
2013-03-02 19:47:04 -07:00
using MediaBrowser.Common.Plugins ;
2013-02-27 09:46:48 -07:00
using MediaBrowser.Common.ScheduledTasks ;
2013-03-03 22:43:06 -07:00
using MediaBrowser.Common.Security ;
2013-02-27 07:39:11 -07:00
using MediaBrowser.Common.Updates ;
2013-09-24 17:54:51 -07:00
using MediaBrowser.Model.IO ;
2013-02-25 20:43:04 -07:00
using MediaBrowser.Model.Logging ;
using MediaBrowser.Model.Serialization ;
2013-03-03 22:43:06 -07:00
using MediaBrowser.Model.Updates ;
2013-02-25 20:43:04 -07:00
using SimpleInjector ;
using System ;
using System.Collections.Generic ;
2013-02-26 21:19:05 -07:00
using System.IO ;
using System.Linq ;
2013-08-28 13:12:58 -07:00
using System.Net.Http ;
2013-02-26 21:19:05 -07:00
using System.Reflection ;
2013-02-25 20:43:04 -07:00
using System.Threading ;
2013-03-03 22:43:06 -07:00
using System.Threading.Tasks ;
2013-02-25 20:43:04 -07:00
namespace MediaBrowser.Common.Implementations
{
2013-03-09 23:45:16 -07:00
/// <summary>
/// Class BaseApplicationHost
/// </summary>
/// <typeparam name="TApplicationPathsType">The type of the T application paths type.</typeparam>
2013-03-03 22:43:06 -07:00
public abstract class BaseApplicationHost < TApplicationPathsType > : IApplicationHost
where TApplicationPathsType : class , IApplicationPaths , new ( )
2013-02-25 20:43:04 -07:00
{
2013-03-06 22:34:00 -07:00
/// <summary>
/// Occurs when [has pending restart changed].
/// </summary>
public event EventHandler HasPendingRestartChanged ;
/// <summary>
/// Occurs when [application updated].
/// </summary>
public event EventHandler < GenericEventArgs < Version > > ApplicationUpdated ;
/// <summary>
/// Gets or sets a value indicating whether this instance has changes that require the entire application to restart.
/// </summary>
/// <value><c>true</c> if this instance has pending application restart; otherwise, <c>false</c>.</value>
public bool HasPendingRestart { get ; private set ; }
2013-02-25 20:43:04 -07:00
/// <summary>
/// Gets or sets the logger.
/// </summary>
/// <value>The logger.</value>
2013-03-03 22:43:06 -07:00
protected ILogger Logger { get ; private set ; }
2013-02-25 20:43:04 -07:00
2013-03-02 19:47:04 -07:00
/// <summary>
/// Gets or sets the plugins.
/// </summary>
/// <value>The plugins.</value>
public IEnumerable < IPlugin > Plugins { get ; protected set ; }
2013-02-26 10:21:18 -07:00
/// <summary>
/// Gets or sets the log manager.
/// </summary>
/// <value>The log manager.</value>
public ILogManager LogManager { get ; protected set ; }
/// <summary>
/// Gets the application paths.
/// </summary>
/// <value>The application paths.</value>
2013-09-20 18:04:14 -07:00
protected TApplicationPathsType ApplicationPaths { get ; private set ; }
2013-02-26 10:21:18 -07:00
2013-02-25 20:43:04 -07:00
/// <summary>
/// The container
/// </summary>
protected readonly Container Container = new Container ( ) ;
2013-03-03 00:27:40 -07:00
2013-03-03 22:43:06 -07:00
/// <summary>
/// The json serializer
/// </summary>
2013-03-07 22:08:27 -07:00
public readonly IJsonSerializer JsonSerializer = new JsonSerializer ( ) ;
2013-03-03 22:43:06 -07:00
/// <summary>
/// The _XML serializer
/// </summary>
protected readonly IXmlSerializer XmlSerializer = new XmlSerializer ( ) ;
2013-02-25 20:43:04 -07:00
/// <summary>
/// Gets assemblies that failed to load
/// </summary>
2013-03-09 23:45:16 -07:00
/// <value>The failed assemblies.</value>
2013-02-25 20:43:04 -07:00
public List < string > FailedAssemblies { get ; protected set ; }
/// <summary>
/// Gets all types within all running assemblies
/// </summary>
/// <value>All types.</value>
public Type [ ] AllTypes { get ; protected set ; }
/// <summary>
/// Gets all concrete types.
/// </summary>
/// <value>All concrete types.</value>
public Type [ ] AllConcreteTypes { get ; protected set ; }
/// <summary>
/// The disposable parts
/// </summary>
protected readonly List < IDisposable > DisposableParts = new List < IDisposable > ( ) ;
2013-02-26 10:21:18 -07: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-03-03 22:43:06 -07:00
/// <summary>
/// Gets the kernel.
/// </summary>
/// <value>The kernel.</value>
protected ITaskManager TaskManager { get ; private set ; }
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets the security manager.
/// </summary>
/// <value>The security manager.</value>
2013-03-03 22:43:06 -07:00
protected ISecurityManager SecurityManager { get ; private set ; }
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets the HTTP client.
/// </summary>
/// <value>The HTTP client.</value>
2013-03-04 21:25:27 -07:00
protected IHttpClient HttpClient { get ; private set ; }
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets the network manager.
/// </summary>
/// <value>The network manager.</value>
2013-03-06 22:34:00 -07:00
protected INetworkManager NetworkManager { get ; private set ; }
2013-03-03 22:43:06 -07:00
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets the configuration manager.
/// </summary>
/// <value>The configuration manager.</value>
2013-03-03 22:43:06 -07:00
protected IConfigurationManager ConfigurationManager { get ; private set ; }
2013-06-30 19:27:50 -07:00
/// <summary>
/// Gets or sets the installation manager.
/// </summary>
/// <value>The installation manager.</value>
protected IInstallationManager InstallationManager { get ; set ; }
2013-09-13 18:56:03 -07:00
2013-09-24 17:54:51 -07:00
/// <summary>
/// Gets or sets the zip client.
/// </summary>
/// <value>The zip client.</value>
protected IZipClient ZipClient { get ; set ; }
2013-09-30 15:18:44 -07:00
protected IIsoManager IsoManager { get ; set ; }
2013-10-02 09:20:11 -07:00
2013-02-25 20:43:04 -07:00
/// <summary>
2013-04-10 08:45:15 -07:00
/// Initializes a new instance of the <see cref="BaseApplicationHost{TApplicationPathsType}"/> class.
2013-02-25 20:43:04 -07:00
/// </summary>
2013-09-20 18:04:14 -07:00
protected BaseApplicationHost ( TApplicationPathsType applicationPaths , ILogManager logManager )
2013-02-25 20:43:04 -07:00
{
FailedAssemblies = new List < string > ( ) ;
2013-03-03 22:43:06 -07:00
2013-09-20 18:04:14 -07:00
ApplicationPaths = applicationPaths ;
LogManager = logManager ;
2013-03-03 22:43:06 -07:00
ConfigurationManager = GetConfigurationManager ( ) ;
2013-03-03 00:27:40 -07:00
}
2013-02-26 10:21:18 -07:00
2013-03-03 00:27:40 -07:00
/// <summary>
/// Inits this instance.
/// </summary>
/// <returns>Task.</returns>
2013-03-04 11:13:47 -07:00
public virtual async Task Init ( )
2013-03-03 00:27:40 -07:00
{
2013-03-04 11:13:47 -07:00
IsFirstRun = ! ConfigurationManager . CommonConfiguration . IsStartupWizardCompleted ;
2013-02-26 10:21:18 -07:00
2013-03-04 11:13:47 -07:00
Logger = LogManager . GetLogger ( "App" ) ;
2013-03-03 22:43:06 -07:00
2013-09-20 18:04:14 -07:00
LogManager . LogSeverity = ConfigurationManager . CommonConfiguration . EnableDebugLevelLogging
? LogSeverity . Debug
: LogSeverity . Info ;
2013-04-08 09:45:40 -07:00
OnLoggerLoaded ( ) ;
2013-03-03 22:43:06 -07:00
2013-03-05 16:11:32 -07:00
DiscoverTypes ( ) ;
2013-03-04 11:13:47 -07:00
Logger . Info ( "Version {0} initializing" , ApplicationVersion ) ;
2013-03-03 22:43:06 -07:00
2013-10-05 18:38:36 -07:00
SetHttpLimit ( ) ;
2013-03-04 11:13:47 -07:00
await RegisterResources ( ) . ConfigureAwait ( false ) ;
2013-03-03 22:43:06 -07:00
2013-03-04 11:13:47 -07:00
FindParts ( ) ;
2013-09-30 15:18:44 -07:00
await InstallIsoMounters ( CancellationToken . None ) . ConfigureAwait ( false ) ;
2013-03-09 23:45:16 -07:00
}
2013-09-30 15:18:44 -07:00
/// <summary>
/// Called when [logger loaded].
/// </summary>
2013-04-08 09:45:40 -07:00
protected virtual void OnLoggerLoaded ( )
{
2013-09-13 18:56:03 -07:00
2013-04-08 09:45:40 -07:00
}
2013-10-05 18:38:36 -07:00
private void SetHttpLimit ( )
{
try
{
2013-10-05 20:03:08 -07:00
// Increase the max http request limit
2013-10-06 17:49:33 -07:00
ServicePointManager . DefaultConnectionLimit = Math . Max ( 48 , ServicePointManager . DefaultConnectionLimit ) ;
2013-10-05 18:38:36 -07:00
}
catch ( Exception ex )
{
Logger . ErrorException ( "Error setting http limit" , ex ) ;
}
}
2013-09-30 15:18:44 -07:00
/// <summary>
/// Installs the iso mounters.
/// </summary>
/// <param name="cancellationToken">The cancellation token.</param>
/// <returns>Task.</returns>
private async Task InstallIsoMounters ( CancellationToken cancellationToken )
{
var list = new List < IIsoMounter > ( ) ;
foreach ( var isoMounter in GetExports < IIsoMounter > ( ) )
{
try
{
if ( isoMounter . RequiresInstallation & & ! isoMounter . IsInstalled )
{
Logger . Info ( "Installing {0}" , isoMounter . Name ) ;
await isoMounter . Install ( cancellationToken ) . ConfigureAwait ( false ) ;
}
list . Add ( isoMounter ) ;
}
catch ( Exception ex )
{
Logger . ErrorException ( "{0} failed to load." , ex , isoMounter . Name ) ;
}
}
IsoManager . AddParts ( list ) ;
}
2013-03-09 23:45:16 -07:00
/// <summary>
/// Runs the startup tasks.
/// </summary>
/// <returns>Task.</returns>
2013-10-02 09:20:11 -07:00
public virtual Task RunStartupTasks ( )
2013-03-09 23:45:16 -07:00
{
return Task . Run ( ( ) = >
{
Resolve < ITaskManager > ( ) . AddTasks ( GetExports < IScheduledTask > ( false ) ) ;
2013-09-24 17:54:51 -07:00
Task . Run ( ( ) = > ConfigureAutorun ( ) ) ;
2013-03-13 15:33:09 -07:00
2013-05-07 12:07:51 -07:00
ConfigurationManager . ConfigurationUpdated + = OnConfigurationUpdated ;
2013-03-09 23:45:16 -07:00
} ) ;
2013-02-25 20:43:04 -07:00
}
2013-09-24 17:54:51 -07:00
/// <summary>
/// Configures the autorun.
/// </summary>
private void ConfigureAutorun ( )
{
try
{
ConfigureAutoRunAtStartup ( ConfigurationManager . CommonConfiguration . RunAtStartup ) ;
}
catch ( Exception ex )
{
Logger . ErrorException ( "Error configuring autorun" , ex ) ;
}
}
2013-02-25 20:43:04 -07:00
/// <summary>
/// Gets the composable part assemblies.
/// </summary>
/// <returns>IEnumerable{Assembly}.</returns>
protected abstract IEnumerable < Assembly > GetComposablePartAssemblies ( ) ;
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets the configuration manager.
/// </summary>
/// <returns>IConfigurationManager.</returns>
2013-03-03 22:43:06 -07:00
protected abstract IConfigurationManager GetConfigurationManager ( ) ;
2013-02-27 09:46:48 -07:00
/// <summary>
/// Finds the parts.
/// </summary>
protected virtual void FindParts ( )
{
2013-03-02 19:47:04 -07:00
Plugins = GetExports < IPlugin > ( ) ;
2013-02-27 09:46:48 -07:00
}
2013-03-03 00:27:40 -07:00
2013-02-25 20:43:04 -07:00
/// <summary>
/// Discovers the types.
/// </summary>
protected void DiscoverTypes ( )
{
FailedAssemblies . Clear ( ) ;
2013-09-19 17:53:18 -07:00
var assemblies = GetComposablePartAssemblies ( ) . ToList ( ) ;
2013-03-05 16:11:32 -07:00
2013-04-08 14:05:00 -07:00
foreach ( var assembly in assemblies )
{
Logger . Info ( "Loading {0}" , assembly . FullName ) ;
}
2013-03-05 16:11:32 -07:00
AllTypes = assemblies . SelectMany ( GetTypes ) . ToArray ( ) ;
2013-02-25 20:43:04 -07:00
AllConcreteTypes = AllTypes . Where ( t = > t . IsClass & & ! t . IsAbstract & & ! t . IsInterface & & ! t . IsGenericType ) . ToArray ( ) ;
}
2013-02-27 09:46:48 -07:00
/// <summary>
/// Registers resources that classes will depend on
/// </summary>
2013-03-09 23:45:16 -07:00
/// <returns>Task.</returns>
2013-03-04 11:13:47 -07:00
protected virtual Task RegisterResources ( )
2013-02-27 09:46:48 -07:00
{
2013-03-04 11:13:47 -07:00
return Task . Run ( ( ) = >
{
RegisterSingleInstance ( ConfigurationManager ) ;
RegisterSingleInstance < IApplicationHost > ( this ) ;
2013-03-03 22:43:06 -07:00
2013-03-04 11:13:47 -07:00
RegisterSingleInstance < IApplicationPaths > ( ApplicationPaths ) ;
2013-03-03 22:43:06 -07:00
2013-03-06 22:34:00 -07:00
TaskManager = new TaskManager ( ApplicationPaths , JsonSerializer , Logger ) ;
2013-03-03 22:43:06 -07:00
2013-03-04 11:13:47 -07:00
RegisterSingleInstance ( JsonSerializer ) ;
RegisterSingleInstance ( XmlSerializer ) ;
2013-03-03 22:43:06 -07:00
2013-03-04 11:13:47 -07:00
RegisterSingleInstance ( LogManager ) ;
RegisterSingleInstance ( Logger ) ;
2013-02-27 09:46:48 -07:00
2013-03-04 11:13:47 -07:00
RegisterSingleInstance ( TaskManager ) ;
2013-02-27 09:46:48 -07:00
2013-10-02 10:05:13 -07:00
HttpClient = new HttpClientManager . HttpClientManager ( ApplicationPaths , Logger , CreateHttpClient ) ;
2013-03-04 21:25:27 -07:00
RegisterSingleInstance ( HttpClient ) ;
2013-03-03 22:43:06 -07:00
2013-10-05 10:13:32 -07:00
NetworkManager = CreateNetworkManager ( ) ;
2013-03-06 22:34:00 -07:00
RegisterSingleInstance ( NetworkManager ) ;
2013-09-13 13:45:12 -07:00
SecurityManager = new PluginSecurityManager ( this , HttpClient , JsonSerializer , ApplicationPaths , NetworkManager ) ;
2013-03-04 11:13:47 -07:00
RegisterSingleInstance ( SecurityManager ) ;
2013-03-03 22:43:06 -07:00
2013-08-30 07:05:44 -07:00
InstallationManager = new InstallationManager ( Logger , this , ApplicationPaths , HttpClient , JsonSerializer , SecurityManager , NetworkManager , ConfigurationManager ) ;
2013-06-30 19:27:50 -07:00
RegisterSingleInstance ( InstallationManager ) ;
2013-09-24 17:54:51 -07:00
ZipClient = new ZipClient ( ) ;
RegisterSingleInstance ( ZipClient ) ;
2013-09-30 15:18:44 -07:00
IsoManager = new IsoManager ( ) ;
RegisterSingleInstance ( IsoManager ) ;
2013-03-04 11:13:47 -07:00
} ) ;
2013-02-27 09:46:48 -07:00
}
2013-03-03 00:27:40 -07:00
2013-10-02 10:05:13 -07:00
protected abstract HttpClient CreateHttpClient ( bool enableHttpCompression ) ;
2013-08-28 13:12:58 -07:00
2013-02-25 20:43:04 -07:00
/// <summary>
/// Gets a list of types within an assembly
/// This will handle situations that would normally throw an exception - such as a type within the assembly that depends on some other non-existant reference
/// </summary>
/// <param name="assembly">The assembly.</param>
/// <returns>IEnumerable{Type}.</returns>
/// <exception cref="System.ArgumentNullException">assembly</exception>
protected IEnumerable < Type > GetTypes ( Assembly assembly )
{
if ( assembly = = null )
{
throw new ArgumentNullException ( "assembly" ) ;
}
try
{
return assembly . GetTypes ( ) ;
}
catch ( ReflectionTypeLoadException ex )
{
// If it fails we can still get a list of the Types it was able to resolve
return ex . Types . Where ( t = > t ! = null ) ;
}
}
2013-10-05 10:13:32 -07:00
protected abstract INetworkManager CreateNetworkManager ( ) ;
2013-02-25 20:43:04 -07:00
/// <summary>
/// Creates an instance of type and resolves all constructor dependancies
/// </summary>
/// <param name="type">The type.</param>
/// <returns>System.Object.</returns>
2013-10-03 07:14:40 -07:00
public object CreateInstance ( Type type )
2013-02-25 20:43:04 -07:00
{
try
{
return Container . GetInstance ( type ) ;
}
2013-04-23 14:05:21 -07:00
catch ( Exception ex )
2013-02-25 20:43:04 -07:00
{
2013-04-23 14:05:21 -07:00
Logger . Error ( "Error creating {0}" , ex , type . Name ) ;
2013-02-25 20:43:04 -07:00
throw ;
}
}
2013-10-02 09:20:11 -07:00
/// <summary>
/// Creates the instance safe.
/// </summary>
/// <param name="type">The type.</param>
/// <returns>System.Object.</returns>
protected object CreateInstanceSafe ( Type type )
{
try
{
return Container . GetInstance ( type ) ;
}
catch ( Exception ex )
{
Logger . Error ( "Error creating {0}" , ex , type . Name ) ;
2013-10-02 12:08:58 -07:00
#if DEBUG
throw ;
#endif
// Don't blow up in release mode
2013-10-02 09:20:11 -07:00
return null ;
}
}
2013-02-25 20:43:04 -07:00
/// <summary>
/// Registers the specified obj.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="obj">The obj.</param>
2013-02-26 09:10:55 -07:00
/// <param name="manageLifetime">if set to <c>true</c> [manage lifetime].</param>
protected void RegisterSingleInstance < T > ( T obj , bool manageLifetime = true )
2013-02-25 20:43:04 -07:00
where T : class
{
Container . RegisterSingle ( obj ) ;
2013-02-26 09:10:55 -07:00
if ( manageLifetime )
{
var disposable = obj as IDisposable ;
if ( disposable ! = null )
{
DisposableParts . Add ( disposable ) ;
}
}
2013-02-25 20:43:04 -07:00
}
/// <summary>
/// Registers the single instance.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="func">The func.</param>
protected void RegisterSingleInstance < T > ( Func < T > func )
where T : class
{
Container . RegisterSingle ( func ) ;
}
/// <summary>
/// Resolves this instance.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <returns>``0.</returns>
public T Resolve < T > ( )
{
return ( T ) Container . GetRegistration ( typeof ( T ) , true ) . GetInstance ( ) ;
}
/// <summary>
/// Resolves this instance.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <returns>``0.</returns>
public T TryResolve < T > ( )
{
var result = Container . GetRegistration ( typeof ( T ) , false ) ;
if ( result = = null )
{
return default ( T ) ;
}
return ( T ) result . GetInstance ( ) ;
}
/// <summary>
/// Loads the assembly.
/// </summary>
/// <param name="file">The file.</param>
/// <returns>Assembly.</returns>
protected Assembly LoadAssembly ( string file )
{
try
{
return Assembly . Load ( File . ReadAllBytes ( ( file ) ) ) ;
}
catch ( Exception ex )
{
FailedAssemblies . Add ( file ) ;
Logger . ErrorException ( "Error loading assembly {0}" , ex , file ) ;
return null ;
}
}
2013-06-20 09:44:24 -07:00
/// <summary>
/// Gets the export types.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <returns>IEnumerable{Type}.</returns>
public IEnumerable < Type > GetExportTypes < T > ( )
{
var currentType = typeof ( T ) ;
return AllConcreteTypes . AsParallel ( ) . Where ( currentType . IsAssignableFrom ) ;
}
2013-02-25 20:43:04 -07:00
/// <summary>
/// Gets the exports.
/// </summary>
/// <typeparam name="T"></typeparam>
/// <param name="manageLiftime">if set to <c>true</c> [manage liftime].</param>
/// <returns>IEnumerable{``0}.</returns>
public IEnumerable < T > GetExports < T > ( bool manageLiftime = true )
{
2013-10-02 09:20:11 -07:00
var parts = GetExportTypes < T > ( )
. Select ( CreateInstanceSafe )
. Where ( i = > i ! = null )
. Cast < T > ( )
. ToList ( ) ;
2013-02-25 20:43:04 -07:00
if ( manageLiftime )
{
2013-03-14 18:40:38 -07:00
lock ( DisposableParts )
{
DisposableParts . AddRange ( parts . OfType < IDisposable > ( ) ) ;
}
2013-02-25 20:43:04 -07:00
}
return parts ;
}
/// <summary>
/// Gets the current application version
/// </summary>
/// <value>The application version.</value>
public Version ApplicationVersion
{
get
{
return GetType ( ) . Assembly . GetName ( ) . Version ;
}
}
2013-03-13 15:33:09 -07:00
/// <summary>
/// Handles the ConfigurationUpdated event of the ConfigurationManager control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="EventArgs" /> instance containing the event data.</param>
/// <exception cref="System.NotImplementedException"></exception>
2013-05-07 12:07:51 -07:00
protected virtual void OnConfigurationUpdated ( object sender , EventArgs e )
2013-03-13 15:33:09 -07:00
{
2013-09-24 17:54:51 -07:00
ConfigureAutorun ( ) ;
2013-03-13 15:33:09 -07:00
}
2013-09-13 18:56:03 -07:00
2013-09-24 17:54:51 -07:00
protected abstract void ConfigureAutoRunAtStartup ( bool autorun ) ;
2013-02-27 14:07:51 -07:00
2013-03-02 19:47:04 -07:00
/// <summary>
/// Removes the plugin.
/// </summary>
/// <param name="plugin">The plugin.</param>
public void RemovePlugin ( IPlugin plugin )
{
var list = Plugins . ToList ( ) ;
list . Remove ( plugin ) ;
Plugins = list ;
}
2013-10-07 07:38:31 -07:00
/// <summary>
/// Gets a value indicating whether this instance can self restart.
/// </summary>
/// <value><c>true</c> if this instance can self restart; otherwise, <c>false</c>.</value>
public abstract bool CanSelfRestart { get ; }
2013-03-06 22:34:00 -07:00
/// <summary>
/// Notifies that the kernel that a change has been made that requires a restart
/// </summary>
public void NotifyPendingRestart ( )
{
HasPendingRestart = true ;
EventHelper . QueueEventIfNotNull ( HasPendingRestartChanged , this , EventArgs . Empty , Logger ) ;
}
2013-02-25 20:43:04 -07:00
/// <summary>
/// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
/// </summary>
public void Dispose ( )
{
Dispose ( true ) ;
}
/// <summary>
/// Releases unmanaged and - optionally - managed resources.
/// </summary>
/// <param name="dispose"><c>true</c> to release both managed and unmanaged resources; <c>false</c> to release only unmanaged resources.</param>
protected virtual void Dispose ( bool dispose )
{
2013-02-26 21:19:05 -07:00
if ( dispose )
{
var type = GetType ( ) ;
2013-02-26 09:10:55 -07:00
2013-02-26 21:19:05 -07:00
Logger . Info ( "Disposing " + type . Name ) ;
2013-02-26 09:10:55 -07:00
2013-02-26 21:19:05 -07:00
var parts = DisposableParts . Distinct ( ) . Where ( i = > i . GetType ( ) ! = type ) . ToList ( ) ;
DisposableParts . Clear ( ) ;
2013-02-26 09:10:55 -07:00
2013-02-26 21:19:05 -07:00
foreach ( var part in parts )
{
Logger . Info ( "Disposing " + part . GetType ( ) . Name ) ;
2013-02-25 20:43:04 -07:00
2013-02-26 21:19:05 -07:00
part . Dispose ( ) ;
}
}
2013-02-25 20:43:04 -07:00
}
2013-03-03 22:43:06 -07:00
2013-03-09 23:45:16 -07:00
/// <summary>
/// Restarts this instance.
/// </summary>
2013-09-20 10:32:10 -07:00
public abstract Task Restart ( ) ;
2013-03-03 22:43:06 -07:00
2013-03-09 23:45:16 -07:00
/// <summary>
/// Gets or sets a value indicating whether this instance can self update.
/// </summary>
/// <value><c>true</c> if this instance can self update; otherwise, <c>false</c>.</value>
2013-03-03 22:43:06 -07:00
public abstract bool CanSelfUpdate { get ; }
2013-03-09 23:45:16 -07:00
/// <summary>
/// Checks for update.
/// </summary>
/// <param name="cancellationToken">The cancellation token.</param>
/// <param name="progress">The progress.</param>
/// <returns>Task{CheckForUpdateResult}.</returns>
2013-09-13 18:56:03 -07:00
public abstract Task < CheckForUpdateResult > CheckForApplicationUpdate ( CancellationToken cancellationToken ,
IProgress < double > progress ) ;
2013-08-16 11:43:11 -07:00
/// <summary>
2013-09-13 18:56:03 -07:00
/// Updates the application.
2013-08-16 11:43:11 -07:00
/// </summary>
2013-09-13 18:56:03 -07:00
/// <param name="package">The package that contains the update</param>
2013-08-16 11:43:11 -07:00
/// <param name="cancellationToken">The cancellation token.</param>
/// <param name="progress">The progress.</param>
2013-09-13 18:56:03 -07:00
/// <returns>Task.</returns>
public abstract Task UpdateApplication ( PackageVersionInfo package , CancellationToken cancellationToken ,
IProgress < double > progress ) ;
2013-08-16 11:43:11 -07:00
/// <summary>
2013-09-13 18:56:03 -07:00
/// Shuts down.
2013-08-16 11:43:11 -07:00
/// </summary>
2013-09-20 10:32:10 -07:00
public abstract Task Shutdown ( ) ;
2013-03-03 22:43:06 -07:00
2013-03-06 22:34:00 -07:00
/// <summary>
2013-09-13 18:56:03 -07:00
/// Called when [application updated].
2013-03-06 22:34:00 -07:00
/// </summary>
2013-09-13 18:56:03 -07:00
/// <param name="newVersion">The new version.</param>
protected void OnApplicationUpdated ( Version newVersion )
2013-03-06 22:34:00 -07:00
{
2013-09-29 17:51:04 -07:00
Logger . Info ( "Application has been updated to version {0}" , newVersion ) ;
2013-09-13 18:56:03 -07:00
EventHelper . QueueEventIfNotNull ( ApplicationUpdated , this , new GenericEventArgs < Version > { Argument = newVersion } , Logger ) ;
2013-03-11 12:36:32 -07:00
NotifyPendingRestart ( ) ;
2013-03-06 22:34:00 -07:00
}
2013-02-25 20:43:04 -07:00
}
}