2013-09-18 04:43:34 +02:00
|
|
|
|
using MediaBrowser.Common.Extensions;
|
2013-03-04 06:43:06 +01:00
|
|
|
|
using MediaBrowser.Controller.Configuration;
|
2013-02-21 02:33:05 +01:00
|
|
|
|
using MediaBrowser.Controller.Entities;
|
2013-06-21 20:50:44 +02:00
|
|
|
|
using MediaBrowser.Controller.Library;
|
2013-02-21 02:33:05 +01:00
|
|
|
|
using MediaBrowser.Model.Logging;
|
|
|
|
|
using System;
|
|
|
|
|
using System.Threading;
|
|
|
|
|
using System.Threading.Tasks;
|
|
|
|
|
|
|
|
|
|
namespace MediaBrowser.Controller.Providers
|
|
|
|
|
{
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Class BaseMetadataProvider
|
|
|
|
|
/// </summary>
|
2013-03-08 06:08:27 +01:00
|
|
|
|
public abstract class BaseMetadataProvider
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the logger.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value>The logger.</value>
|
2013-03-02 18:59:15 +01:00
|
|
|
|
protected ILogger Logger { get; set; }
|
2013-11-07 16:56:35 +01:00
|
|
|
|
|
2013-03-02 18:59:15 +01:00
|
|
|
|
protected ILogManager LogManager { get; set; }
|
2013-02-21 02:33:05 +01:00
|
|
|
|
|
2013-03-04 06:43:06 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the configuration manager.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value>The configuration manager.</value>
|
|
|
|
|
protected IServerConfigurationManager ConfigurationManager { get; private set; }
|
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// The _id
|
|
|
|
|
/// </summary>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
public readonly Guid Id;
|
2013-02-21 02:33:05 +01:00
|
|
|
|
|
2013-04-15 22:33:43 +02:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// The true task result
|
|
|
|
|
/// </summary>
|
|
|
|
|
protected static readonly Task<bool> TrueTaskResult = Task.FromResult(true);
|
2013-11-07 16:56:35 +01:00
|
|
|
|
|
2013-04-15 22:33:43 +02:00
|
|
|
|
protected static readonly Task<bool> FalseTaskResult = Task.FromResult(false);
|
|
|
|
|
|
2014-01-07 19:39:35 +01:00
|
|
|
|
protected static readonly SemaphoreSlim XmlParsingResourcePool = new SemaphoreSlim(4, 4);
|
2013-06-21 20:50:44 +02:00
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Supportses the specified item.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise</returns>
|
|
|
|
|
public abstract bool Supports(BaseItem item);
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a value indicating whether [requires internet].
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value><c>true</c> if [requires internet]; otherwise, <c>false</c>.</value>
|
|
|
|
|
public virtual bool RequiresInternet
|
|
|
|
|
{
|
|
|
|
|
get
|
|
|
|
|
{
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the provider version.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value>The provider version.</value>
|
|
|
|
|
protected virtual string ProviderVersion
|
|
|
|
|
{
|
|
|
|
|
get
|
|
|
|
|
{
|
|
|
|
|
return null;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2013-06-25 03:22:21 +02:00
|
|
|
|
public virtual ItemUpdateType ItemUpdateType
|
|
|
|
|
{
|
2013-06-28 01:01:03 +02:00
|
|
|
|
get { return RequiresInternet ? ItemUpdateType.MetadataDownload : ItemUpdateType.MetadataImport; }
|
2013-06-25 03:22:21 +02:00
|
|
|
|
}
|
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a value indicating whether [refresh on version change].
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value><c>true</c> if [refresh on version change]; otherwise, <c>false</c>.</value>
|
|
|
|
|
protected virtual bool RefreshOnVersionChange
|
|
|
|
|
{
|
|
|
|
|
get
|
|
|
|
|
{
|
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Determines if this provider is relatively slow and, therefore, should be skipped
|
|
|
|
|
/// in certain instances. Default is whether or not it requires internet. Can be overridden
|
|
|
|
|
/// for explicit designation.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value><c>true</c> if this instance is slow; otherwise, <c>false</c>.</value>
|
|
|
|
|
public virtual bool IsSlow
|
|
|
|
|
{
|
|
|
|
|
get { return RequiresInternet; }
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Initializes a new instance of the <see cref="BaseMetadataProvider" /> class.
|
|
|
|
|
/// </summary>
|
2013-03-04 06:43:06 +01:00
|
|
|
|
protected BaseMetadataProvider(ILogManager logManager, IServerConfigurationManager configurationManager)
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
2013-03-02 18:59:15 +01:00
|
|
|
|
Logger = logManager.GetLogger(GetType().Name);
|
|
|
|
|
LogManager = logManager;
|
2013-03-04 06:43:06 +01:00
|
|
|
|
ConfigurationManager = configurationManager;
|
2013-04-13 20:02:30 +02:00
|
|
|
|
Id = GetType().FullName.GetMD5();
|
2013-03-02 18:59:15 +01:00
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
Initialize();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Initializes this instance.
|
|
|
|
|
/// </summary>
|
|
|
|
|
protected virtual void Initialize()
|
|
|
|
|
{
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Sets the persisted last refresh date on the item for this provider.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <param name="value">The value.</param>
|
|
|
|
|
/// <param name="providerVersion">The provider version.</param>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
/// <param name="providerInfo">The provider information.</param>
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <param name="status">The status.</param>
|
|
|
|
|
/// <exception cref="System.ArgumentNullException">item</exception>
|
2013-11-07 16:56:35 +01:00
|
|
|
|
public virtual void SetLastRefreshed(BaseItem item, DateTime value, string providerVersion,
|
2013-12-06 21:07:34 +01:00
|
|
|
|
BaseProviderInfo providerInfo, ProviderRefreshStatus status = ProviderRefreshStatus.Success)
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
|
|
|
|
if (item == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException("item");
|
|
|
|
|
}
|
2013-04-13 20:02:30 +02:00
|
|
|
|
|
2013-12-06 21:07:34 +01:00
|
|
|
|
providerInfo.LastRefreshed = value;
|
|
|
|
|
providerInfo.LastRefreshStatus = status;
|
|
|
|
|
providerInfo.ProviderVersion = providerVersion;
|
2013-02-21 02:33:05 +01:00
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Sets the last refreshed.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <param name="value">The value.</param>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
/// <param name="providerInfo">The provider information.</param>
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <param name="status">The status.</param>
|
2013-11-07 16:56:35 +01:00
|
|
|
|
public void SetLastRefreshed(BaseItem item, DateTime value,
|
2013-12-06 21:07:34 +01:00
|
|
|
|
BaseProviderInfo providerInfo, ProviderRefreshStatus status = ProviderRefreshStatus.Success)
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
2013-12-06 21:07:34 +01:00
|
|
|
|
SetLastRefreshed(item, value, ProviderVersion, providerInfo, status);
|
2013-02-21 02:33:05 +01:00
|
|
|
|
}
|
2013-04-13 20:02:30 +02:00
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Returns whether or not this provider should be re-fetched. Default functionality can
|
|
|
|
|
/// compare a provided date with a last refresh time. This can be overridden for more complex
|
|
|
|
|
/// determinations.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise</returns>
|
|
|
|
|
/// <exception cref="System.ArgumentNullException"></exception>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
public bool NeedsRefresh(BaseItem item, BaseProviderInfo data)
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
|
|
|
|
if (item == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException();
|
|
|
|
|
}
|
|
|
|
|
|
2013-04-13 20:02:30 +02:00
|
|
|
|
return NeedsRefreshInternal(item, data);
|
2013-02-21 02:33:05 +01:00
|
|
|
|
}
|
|
|
|
|
|
2013-09-23 16:02:56 +02:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets a value indicating whether [enforce dont fetch metadata].
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value><c>true</c> if [enforce dont fetch metadata]; otherwise, <c>false</c>.</value>
|
|
|
|
|
public virtual bool EnforceDontFetchMetadata
|
|
|
|
|
{
|
|
|
|
|
get
|
|
|
|
|
{
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Needses the refresh internal.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <param name="providerInfo">The provider info.</param>
|
|
|
|
|
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise</returns>
|
|
|
|
|
/// <exception cref="System.ArgumentNullException"></exception>
|
|
|
|
|
protected virtual bool NeedsRefreshInternal(BaseItem item, BaseProviderInfo providerInfo)
|
|
|
|
|
{
|
|
|
|
|
if (item == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException("item");
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
if (providerInfo == null)
|
|
|
|
|
{
|
|
|
|
|
throw new ArgumentNullException("providerInfo");
|
|
|
|
|
}
|
2013-04-13 20:02:30 +02:00
|
|
|
|
|
2013-12-11 20:54:33 +01:00
|
|
|
|
if (providerInfo.LastRefreshed == default(DateTime))
|
|
|
|
|
{
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
2013-10-10 18:55:07 +02:00
|
|
|
|
if (NeedsRefreshBasedOnCompareDate(item, providerInfo))
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
|
|
|
|
return true;
|
|
|
|
|
}
|
|
|
|
|
|
2013-10-10 18:55:07 +02:00
|
|
|
|
if (RefreshOnVersionChange && !String.Equals(ProviderVersion, providerInfo.ProviderVersion))
|
2013-02-21 02:33:05 +01:00
|
|
|
|
{
|
|
|
|
|
return true;
|
|
|
|
|
}
|
2013-04-13 20:02:30 +02:00
|
|
|
|
|
2013-10-10 18:55:07 +02:00
|
|
|
|
if (providerInfo.LastRefreshStatus != ProviderRefreshStatus.Success)
|
2013-04-29 01:39:17 +02:00
|
|
|
|
{
|
|
|
|
|
return true;
|
|
|
|
|
}
|
2013-06-21 20:50:44 +02:00
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
return false;
|
|
|
|
|
}
|
|
|
|
|
|
2013-10-01 20:24:27 +02:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Needses the refresh based on compare date.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <param name="providerInfo">The provider info.</param>
|
|
|
|
|
/// <returns><c>true</c> if XXXX, <c>false</c> otherwise</returns>
|
|
|
|
|
protected virtual bool NeedsRefreshBasedOnCompareDate(BaseItem item, BaseProviderInfo providerInfo)
|
|
|
|
|
{
|
|
|
|
|
return CompareDate(item) > providerInfo.LastRefreshed;
|
|
|
|
|
}
|
|
|
|
|
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <summary>
|
|
|
|
|
/// Override this to return the date that should be compared to the last refresh date
|
|
|
|
|
/// to determine if this provider should be re-fetched.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <returns>DateTime.</returns>
|
|
|
|
|
protected virtual DateTime CompareDate(BaseItem item)
|
|
|
|
|
{
|
|
|
|
|
return DateTime.MinValue.AddMinutes(1); // want this to be greater than mindate so new items will refresh
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Fetches metadata and returns true or false indicating if any work that requires persistence was done
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <param name="item">The item.</param>
|
|
|
|
|
/// <param name="force">if set to <c>true</c> [force].</param>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
/// <param name="providerInfo">The provider information.</param>
|
2013-02-21 02:33:05 +01:00
|
|
|
|
/// <param name="cancellationToken">The cancellation token.</param>
|
|
|
|
|
/// <returns>Task{System.Boolean}.</returns>
|
|
|
|
|
/// <exception cref="System.ArgumentNullException"></exception>
|
2013-12-06 21:07:34 +01:00
|
|
|
|
public abstract Task<bool> FetchAsync(BaseItem item, bool force, BaseProviderInfo providerInfo, CancellationToken cancellationToken);
|
2013-02-21 02:33:05 +01:00
|
|
|
|
|
|
|
|
|
/// <summary>
|
|
|
|
|
/// Gets the priority.
|
|
|
|
|
/// </summary>
|
|
|
|
|
/// <value>The priority.</value>
|
|
|
|
|
public abstract MetadataProviderPriority Priority { get; }
|
|
|
|
|
}
|
|
|
|
|
}
|