DashboardService.cs 18 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490
  1. #pragma warning disable CS1591
  2. #pragma warning disable SA1402
  3. #pragma warning disable SA1649
  4. using System;
  5. using System.Collections.Generic;
  6. using System.Diagnostics.CodeAnalysis;
  7. using System.IO;
  8. using System.Linq;
  9. using System.Threading.Tasks;
  10. using MediaBrowser.Common.Extensions;
  11. using MediaBrowser.Common.Plugins;
  12. using MediaBrowser.Controller;
  13. using MediaBrowser.Controller.Configuration;
  14. using MediaBrowser.Controller.Extensions;
  15. using MediaBrowser.Controller.Net;
  16. using MediaBrowser.Controller.Plugins;
  17. using MediaBrowser.Model.IO;
  18. using MediaBrowser.Model.Net;
  19. using MediaBrowser.Model.Plugins;
  20. using MediaBrowser.Model.Services;
  21. using Microsoft.Extensions.Configuration;
  22. using Microsoft.Extensions.Logging;
  23. namespace MediaBrowser.WebDashboard.Api
  24. {
  25. /// <summary>
  26. /// Class GetDashboardConfigurationPages.
  27. /// </summary>
  28. [Route("/web/ConfigurationPages", "GET")]
  29. public class GetDashboardConfigurationPages : IReturn<List<ConfigurationPageInfo>>
  30. {
  31. /// <summary>
  32. /// Gets or sets the type of the page.
  33. /// </summary>
  34. /// <value>The type of the page.</value>
  35. public ConfigurationPageType? PageType { get; set; }
  36. public bool? EnableInMainMenu { get; set; }
  37. }
  38. /// <summary>
  39. /// Class GetDashboardConfigurationPage.
  40. /// </summary>
  41. [Route("/web/ConfigurationPage", "GET")]
  42. public class GetDashboardConfigurationPage
  43. {
  44. /// <summary>
  45. /// Gets or sets the name.
  46. /// </summary>
  47. /// <value>The name.</value>
  48. public string Name { get; set; }
  49. }
  50. [Route("/web/Package", "GET", IsHidden = true)]
  51. public class GetDashboardPackage
  52. {
  53. public string Mode { get; set; }
  54. }
  55. [Route("/robots.txt", "GET", IsHidden = true)]
  56. public class GetRobotsTxt
  57. {
  58. }
  59. /// <summary>
  60. /// Class GetDashboardResource.
  61. /// </summary>
  62. [Route("/web/{ResourceName*}", "GET", IsHidden = true)]
  63. public class GetDashboardResource
  64. {
  65. /// <summary>
  66. /// Gets or sets the name.
  67. /// </summary>
  68. /// <value>The name.</value>
  69. public string ResourceName { get; set; }
  70. /// <summary>
  71. /// Gets or sets the V.
  72. /// </summary>
  73. /// <value>The V.</value>
  74. public string V { get; set; }
  75. }
  76. [Route("/favicon.ico", "GET", IsHidden = true)]
  77. public class GetFavIcon
  78. {
  79. }
  80. /// <summary>
  81. /// Class DashboardService.
  82. /// </summary>
  83. public class DashboardService : IService, IRequiresRequest
  84. {
  85. /// <summary>
  86. /// Gets or sets the logger.
  87. /// </summary>
  88. /// <value>The logger.</value>
  89. private readonly ILogger _logger;
  90. /// <summary>
  91. /// Gets or sets the HTTP result factory.
  92. /// </summary>
  93. /// <value>The HTTP result factory.</value>
  94. private readonly IHttpResultFactory _resultFactory;
  95. private readonly IServerApplicationHost _appHost;
  96. private readonly IConfiguration _appConfig;
  97. private readonly IServerConfigurationManager _serverConfigurationManager;
  98. private readonly IFileSystem _fileSystem;
  99. private readonly IResourceFileManager _resourceFileManager;
  100. /// <summary>
  101. /// Initializes a new instance of the <see cref="DashboardService" /> class.
  102. /// </summary>
  103. /// <param name="logger">The logger.</param>
  104. /// <param name="appHost">The application host.</param>
  105. /// <param name="appConfig">The application configuration.</param>
  106. /// <param name="resourceFileManager">The resource file manager.</param>
  107. /// <param name="serverConfigurationManager">The server configuration manager.</param>
  108. /// <param name="fileSystem">The file system.</param>
  109. /// <param name="resultFactory">The result factory.</param>
  110. public DashboardService(
  111. ILogger<DashboardService> logger,
  112. IServerApplicationHost appHost,
  113. IConfiguration appConfig,
  114. IResourceFileManager resourceFileManager,
  115. IServerConfigurationManager serverConfigurationManager,
  116. IFileSystem fileSystem,
  117. IHttpResultFactory resultFactory)
  118. {
  119. _logger = logger;
  120. _appHost = appHost;
  121. _appConfig = appConfig;
  122. _resourceFileManager = resourceFileManager;
  123. _serverConfigurationManager = serverConfigurationManager;
  124. _fileSystem = fileSystem;
  125. _resultFactory = resultFactory;
  126. // If hosting the web client, validate the client content path
  127. if (appConfig.HostWebClient())
  128. {
  129. string webContentPath = DashboardUIPath;
  130. if (!Directory.Exists(webContentPath) || Directory.GetFiles(webContentPath).Length == 0)
  131. {
  132. throw new InvalidOperationException(
  133. "The server is expected to host the web client, but the provided content directory is either " +
  134. $"invalid or empty: {webContentPath}. If you do not want to host the web client with the " +
  135. "server, you may set the '--nowebclient' command line flag, or set" +
  136. $"'{Controller.Extensions.ConfigurationExtensions.HostWebClientKey}=false' in your config settings.");
  137. }
  138. }
  139. }
  140. /// <summary>
  141. /// Gets or sets the request context.
  142. /// </summary>
  143. /// <value>The request context.</value>
  144. public IRequest Request { get; set; }
  145. /// <summary>
  146. /// Gets the path of the directory containing the static web interface content, or null if the server is not
  147. /// hosting the web client.
  148. /// </summary>
  149. public string DashboardUIPath
  150. {
  151. get
  152. {
  153. if (!_appConfig.HostWebClient())
  154. {
  155. return null;
  156. }
  157. if (!string.IsNullOrEmpty(_serverConfigurationManager.Configuration.DashboardSourcePath))
  158. {
  159. return _serverConfigurationManager.Configuration.DashboardSourcePath;
  160. }
  161. return _serverConfigurationManager.ApplicationPaths.WebPath;
  162. }
  163. }
  164. [SuppressMessage("Microsoft.Performance", "CA1801:ReviewUnusedParameters", MessageId = "request", Justification = "Required for ServiceStack")]
  165. public object Get(GetFavIcon request)
  166. {
  167. return Get(new GetDashboardResource
  168. {
  169. ResourceName = "favicon.ico"
  170. });
  171. }
  172. /// <summary>
  173. /// Gets the specified request.
  174. /// </summary>
  175. /// <param name="request">The request.</param>
  176. /// <returns>System.Object.</returns>
  177. [SuppressMessage("Microsoft.Performance", "CA1801:ReviewUnusedParameters", MessageId = "request", Justification = "Required for ServiceStack")]
  178. public Task<object> Get(GetDashboardConfigurationPage request)
  179. {
  180. IPlugin plugin = null;
  181. Stream stream = null;
  182. var isJs = false;
  183. var isTemplate = false;
  184. var page = ServerEntryPoint.Instance.PluginConfigurationPages.FirstOrDefault(p => string.Equals(p.Name, request.Name, StringComparison.OrdinalIgnoreCase));
  185. if (page != null)
  186. {
  187. plugin = page.Plugin;
  188. stream = page.GetHtmlStream();
  189. }
  190. if (plugin == null)
  191. {
  192. var altPage = GetPluginPages().FirstOrDefault(p => string.Equals(p.Item1.Name, request.Name, StringComparison.OrdinalIgnoreCase));
  193. if (altPage != null)
  194. {
  195. plugin = altPage.Item2;
  196. stream = plugin.GetType().Assembly.GetManifestResourceStream(altPage.Item1.EmbeddedResourcePath);
  197. isJs = string.Equals(Path.GetExtension(altPage.Item1.EmbeddedResourcePath), ".js", StringComparison.OrdinalIgnoreCase);
  198. isTemplate = altPage.Item1.EmbeddedResourcePath.EndsWith(".template.html", StringComparison.Ordinal);
  199. }
  200. }
  201. if (plugin != null && stream != null)
  202. {
  203. if (isJs)
  204. {
  205. return _resultFactory.GetStaticResult(Request, plugin.Version.ToString().GetMD5(), null, null, MimeTypes.GetMimeType("page.js"), () => Task.FromResult(stream));
  206. }
  207. if (isTemplate)
  208. {
  209. return _resultFactory.GetStaticResult(Request, plugin.Version.ToString().GetMD5(), null, null, MimeTypes.GetMimeType("page.html"), () => Task.FromResult(stream));
  210. }
  211. return _resultFactory.GetStaticResult(Request, plugin.Version.ToString().GetMD5(), null, null, MimeTypes.GetMimeType("page.html"), () => PackageCreator.ModifyHtml(false, stream, null, _appHost.ApplicationVersionString, null));
  212. }
  213. throw new ResourceNotFoundException();
  214. }
  215. /// <summary>
  216. /// Gets the specified request.
  217. /// </summary>
  218. /// <param name="request">The request.</param>
  219. /// <returns>System.Object.</returns>
  220. public object Get(GetDashboardConfigurationPages request)
  221. {
  222. const string unavailableMessage = "The server is still loading. Please try again momentarily.";
  223. var instance = ServerEntryPoint.Instance;
  224. if (instance == null)
  225. {
  226. throw new InvalidOperationException(unavailableMessage);
  227. }
  228. var pages = instance.PluginConfigurationPages;
  229. if (pages == null)
  230. {
  231. throw new InvalidOperationException(unavailableMessage);
  232. }
  233. // Don't allow a failing plugin to fail them all
  234. var configPages = pages.Select(p =>
  235. {
  236. try
  237. {
  238. return new ConfigurationPageInfo(p);
  239. }
  240. catch (Exception ex)
  241. {
  242. _logger.LogError(ex, "Error getting plugin information from {Plugin}", p.GetType().Name);
  243. return null;
  244. }
  245. })
  246. .Where(i => i != null)
  247. .ToList();
  248. configPages.AddRange(_appHost.Plugins.SelectMany(GetConfigPages));
  249. if (request.PageType.HasValue)
  250. {
  251. configPages = configPages.Where(p => p.ConfigurationPageType == request.PageType.Value).ToList();
  252. }
  253. if (request.EnableInMainMenu.HasValue)
  254. {
  255. configPages = configPages.Where(p => p.EnableInMainMenu == request.EnableInMainMenu.Value).ToList();
  256. }
  257. return configPages;
  258. }
  259. private IEnumerable<Tuple<PluginPageInfo, IPlugin>> GetPluginPages()
  260. {
  261. return _appHost.Plugins.SelectMany(GetPluginPages);
  262. }
  263. private IEnumerable<Tuple<PluginPageInfo, IPlugin>> GetPluginPages(IPlugin plugin)
  264. {
  265. var hasConfig = plugin as IHasWebPages;
  266. if (hasConfig == null)
  267. {
  268. return new List<Tuple<PluginPageInfo, IPlugin>>();
  269. }
  270. return hasConfig.GetPages().Select(i => new Tuple<PluginPageInfo, IPlugin>(i, plugin));
  271. }
  272. private IEnumerable<ConfigurationPageInfo> GetConfigPages(IPlugin plugin)
  273. {
  274. return GetPluginPages(plugin).Select(i => new ConfigurationPageInfo(plugin, i.Item1));
  275. }
  276. [SuppressMessage("Microsoft.Performance", "CA1801:ReviewUnusedParameters", MessageId = "request", Justification = "Required for ServiceStack")]
  277. public object Get(GetRobotsTxt request)
  278. {
  279. return Get(new GetDashboardResource
  280. {
  281. ResourceName = "robots.txt"
  282. });
  283. }
  284. /// <summary>
  285. /// Gets the specified request.
  286. /// </summary>
  287. /// <param name="request">The request.</param>
  288. /// <returns>System.Object.</returns>
  289. public async Task<object> Get(GetDashboardResource request)
  290. {
  291. if (!_appConfig.HostWebClient() || DashboardUIPath == null)
  292. {
  293. throw new ResourceNotFoundException();
  294. }
  295. var path = request.ResourceName;
  296. var contentType = MimeTypes.GetMimeType(path);
  297. var basePath = DashboardUIPath;
  298. // Bounce them to the startup wizard if it hasn't been completed yet
  299. if (!_serverConfigurationManager.Configuration.IsStartupWizardCompleted &&
  300. Request.RawUrl.IndexOf("wizard", StringComparison.OrdinalIgnoreCase) == -1 &&
  301. PackageCreator.IsCoreHtml(path))
  302. {
  303. // But don't redirect if an html import is being requested.
  304. if (path.IndexOf("bower_components", StringComparison.OrdinalIgnoreCase) == -1)
  305. {
  306. Request.Response.Redirect("index.html?start=wizard#!/wizardstart.html");
  307. return null;
  308. }
  309. }
  310. var localizationCulture = GetLocalizationCulture();
  311. // Don't cache if not configured to do so
  312. // But always cache images to simulate production
  313. if (!_serverConfigurationManager.Configuration.EnableDashboardResponseCaching &&
  314. !contentType.StartsWith("image/", StringComparison.OrdinalIgnoreCase) &&
  315. !contentType.StartsWith("font/", StringComparison.OrdinalIgnoreCase))
  316. {
  317. var stream = await GetResourceStream(basePath, path, localizationCulture).ConfigureAwait(false);
  318. return _resultFactory.GetResult(Request, stream, contentType);
  319. }
  320. TimeSpan? cacheDuration = null;
  321. // Cache images unconditionally - updates to image files will require new filename
  322. // If there's a version number in the query string we can cache this unconditionally
  323. if (contentType.StartsWith("image/", StringComparison.OrdinalIgnoreCase) || contentType.StartsWith("font/", StringComparison.OrdinalIgnoreCase) || !string.IsNullOrEmpty(request.V))
  324. {
  325. cacheDuration = TimeSpan.FromDays(365);
  326. }
  327. var cacheKey = (_appHost.ApplicationVersionString + (localizationCulture ?? string.Empty) + path).GetMD5();
  328. // html gets modified on the fly
  329. if (contentType.StartsWith("text/html", StringComparison.OrdinalIgnoreCase))
  330. {
  331. return await _resultFactory.GetStaticResult(Request, cacheKey, null, cacheDuration, contentType, () => GetResourceStream(basePath, path, localizationCulture)).ConfigureAwait(false);
  332. }
  333. return await _resultFactory.GetStaticFileResult(Request, _resourceFileManager.GetResourcePath(basePath, path)).ConfigureAwait(false);
  334. }
  335. private string GetLocalizationCulture()
  336. {
  337. return _serverConfigurationManager.Configuration.UICulture;
  338. }
  339. /// <summary>
  340. /// Gets the resource stream.
  341. /// </summary>
  342. private Task<Stream> GetResourceStream(string basePath, string virtualPath, string localizationCulture)
  343. {
  344. return GetPackageCreator(basePath)
  345. .GetResource(virtualPath, null, localizationCulture, _appHost.ApplicationVersionString);
  346. }
  347. private PackageCreator GetPackageCreator(string basePath)
  348. {
  349. return new PackageCreator(basePath, _resourceFileManager);
  350. }
  351. public async Task<object> Get(GetDashboardPackage request)
  352. {
  353. if (!_appConfig.HostWebClient() || DashboardUIPath == null)
  354. {
  355. throw new ResourceNotFoundException();
  356. }
  357. var mode = request.Mode;
  358. var inputPath = string.IsNullOrWhiteSpace(mode) ?
  359. DashboardUIPath
  360. : "C:\\dev\\emby-web-mobile-master\\dist";
  361. var targetPath = !string.IsNullOrWhiteSpace(mode) ?
  362. inputPath
  363. : "C:\\dev\\emby-web-mobile\\src";
  364. var packageCreator = GetPackageCreator(inputPath);
  365. if (!string.Equals(inputPath, targetPath, StringComparison.OrdinalIgnoreCase))
  366. {
  367. try
  368. {
  369. Directory.Delete(targetPath, true);
  370. }
  371. catch (IOException ex)
  372. {
  373. _logger.LogError(ex, "Error deleting {Path}", targetPath);
  374. }
  375. CopyDirectory(inputPath, targetPath);
  376. }
  377. var appVersion = _appHost.ApplicationVersionString;
  378. await DumpHtml(packageCreator, inputPath, targetPath, mode, appVersion).ConfigureAwait(false);
  379. return string.Empty;
  380. }
  381. private async Task DumpHtml(PackageCreator packageCreator, string source, string destination, string mode, string appVersion)
  382. {
  383. foreach (var file in _fileSystem.GetFiles(source))
  384. {
  385. var filename = file.Name;
  386. if (!string.Equals(file.Extension, ".html", StringComparison.OrdinalIgnoreCase))
  387. {
  388. continue;
  389. }
  390. await DumpFile(packageCreator, filename, Path.Combine(destination, filename), mode, appVersion).ConfigureAwait(false);
  391. }
  392. }
  393. private async Task DumpFile(PackageCreator packageCreator, string resourceVirtualPath, string destinationFilePath, string mode, string appVersion)
  394. {
  395. using (var stream = await packageCreator.GetResource(resourceVirtualPath, mode, null, appVersion).ConfigureAwait(false))
  396. using (var fs = new FileStream(destinationFilePath, FileMode.Create, FileAccess.Write, FileShare.Read))
  397. {
  398. await stream.CopyToAsync(fs).ConfigureAwait(false);
  399. }
  400. }
  401. private void CopyDirectory(string source, string destination)
  402. {
  403. Directory.CreateDirectory(destination);
  404. // Now Create all of the directories
  405. foreach (var dirPath in _fileSystem.GetDirectories(source, true))
  406. {
  407. Directory.CreateDirectory(dirPath.FullName.Replace(source, destination, StringComparison.Ordinal));
  408. }
  409. // Copy all the files & Replaces any files with the same name
  410. foreach (var newPath in _fileSystem.GetFiles(source, true))
  411. {
  412. File.Copy(newPath.FullName, newPath.FullName.Replace(source, destination, StringComparison.Ordinal), true);
  413. }
  414. }
  415. }
  416. }