OpenTween/ImageCache.cs

   1 // OpenTween - Client of Twitter
   2 // Copyright (c) 2013 kim_upsilon (@kim_upsilon) <https://upsilo.net/~upsilon/>
   3 // All rights reserved.
   4 //
   5 // This file is part of OpenTween.
   6 //
   7 // This program is free software; you can redistribute it and/or modify it
   8 // under the terms of the GNU General Public License as published by the Free
   9 // Software Foundation; either version 3 of the License, or (at your option)
  10 // any later version.
  11 //
  12 // This program is distributed in the hope that it will be useful, but
  13 // WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  14 // or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
  15 // for more details.
  16 //
  17 // You should have received a copy of the GNU General Public License along
  18 // with this program. If not, see <http://www.gnu.org/licenses/>, or write to
  19 // the Free Software Foundation, Inc., 51 Franklin Street - Fifth Floor,
  20 // Boston, MA 02110-1301, USA.
  21
  22 using System;
  23 using System.Collections.Generic;
  24 using System.Linq;
  25 using System.Text;
  26 using System.Threading.Tasks;
  27 using System.Net;
  28 using System.Threading;
  29 using System.Xml.Serialization;
  30 using System.Net.Http;
  31 using OpenTween.Connection;
  32
  33 namespace OpenTween
  34 {
  35     public class ImageCache : IDisposable
  36     {
  37         /// <summary>
  38         /// キャッシュとして URL と取得した画像を対に保持する辞書
  39         /// </summary>
  40         internal LRUCacheDictionary<string, Task<MemoryImage>> innerDictionary;
  41
  42         /// <summary>
  43         /// 非同期タスクをキャンセルするためのトークンのもと
  44         /// </summary>
  45         private CancellationTokenSource cancelTokenSource;
  46
  47         /// <summary>
  48         /// innerDictionary の排他制御のためのロックオブジェクト
  49         /// </summary>
  50         private readonly object lockObject = new object();
  51
  52         /// <summary>
  53         /// オブジェクトが破棄された否か
  54         /// </summary>
  55         private bool disposed = false;
  56
  57         public ImageCache()
  58         {
  59             this.innerDictionary = new LRUCacheDictionary<string, Task<MemoryImage>>(trimLimit: 300, autoTrimCount: 100);
  60             this.innerDictionary.CacheRemoved += (s, e) => {
  61                 // まだ参照されている場合もあるのでDisposeはファイナライザ任せ
  62                 this.CacheRemoveCount++;
  63             };
  64
  65             this.cancelTokenSource = new CancellationTokenSource();
  66         }
  67
  68         /// <summary>
  69         /// 保持しているキャッシュの件数
  70         /// </summary>
  71         public long CacheCount
  72             => this.innerDictionary.Count;
  73
  74         /// <summary>
  75         /// 破棄されたキャッシュの件数
  76         /// </summary>
  77         public int CacheRemoveCount { get; private set; }
  78
  79         /// <summary>
  80         /// 指定された URL にある画像を非同期に取得するメソッド
  81         /// </summary>
  82         /// <param name="address">取得先の URL</param>
  83         /// <param name="force">キャッシュを使用せずに取得する場合は true</param>
  84         /// <returns>非同期に画像を取得するタスク</returns>
  85         public Task<MemoryImage> DownloadImageAsync(string address, bool force = false)
  86         {
  87             var cancelToken = this.cancelTokenSource.Token;
  88
  89             return Task.Run(() =>
  90             {
  91                 lock (this.lockObject)
  92                 {
  93                     innerDictionary.TryGetValue(address, out var cachedImageTask);
  94
  95                     if (cachedImageTask != null)
  96                     {
  97                         if (force)
  98                         {
  99                             this.innerDictionary.Remove(address);
 100                             cachedImageTask = null;
 101                         }
 102                         else
 103                             return cachedImageTask;
 104                     }
 105
 106                     cancelToken.ThrowIfCancellationRequested();
 107
 108                     var imageTask = this.FetchImageAsync(address, cancelToken);
 109                     this.innerDictionary[address] = imageTask;
 110
 111                     return imageTask;
 112                 }
 113             }, cancelToken);
 114         }
 115
 116         private async Task<MemoryImage> FetchImageAsync(string uri, CancellationToken cancelToken)
 117         {
 118             using var response = await Networking.Http.GetAsync(uri, cancelToken)
 119                 .ConfigureAwait(false);
 120
 121             response.EnsureSuccessStatusCode();
 122
 123             using var imageStream = await response.Content.ReadAsStreamAsync()
 124                 .ConfigureAwait(false);
 125
 126             return await MemoryImage.CopyFromStreamAsync(imageStream)
 127                 .ConfigureAwait(false);
 128         }
 129
 130         public MemoryImage TryGetFromCache(string address)
 131         {
 132             lock (this.lockObject)
 133             {
 134                 if (!this.innerDictionary.TryGetValue(address, out var imageTask) ||
 135                     imageTask.Status != TaskStatus.RanToCompletion)
 136                     return null;
 137
 138                 return imageTask.Result;
 139             }
 140         }
 141
 142         public void CancelAsync()
 143         {
 144             lock (this.lockObject)
 145             {
 146                 var oldTokenSource = this.cancelTokenSource;
 147                 this.cancelTokenSource = new CancellationTokenSource();
 148
 149                 oldTokenSource.Cancel();
 150                 oldTokenSource.Dispose();
 151             }
 152         }
 153
 154         protected virtual void Dispose(bool disposing)
 155         {
 156             if (this.disposed) return;
 157
 158             if (disposing)
 159             {
 160                 this.CancelAsync();
 161
 162                 lock (this.lockObject)
 163                 {
 164                     foreach (var (_, task) in this.innerDictionary)
 165                     {
 166                         if (task.Status == TaskStatus.RanToCompletion)
 167                             task.Result?.Dispose();
 168                     }
 169
 170                     this.innerDictionary.Clear();
 171                     this.cancelTokenSource.Dispose();
 172                 }
 173             }
 174
 175             this.disposed = true;
 176         }
 177
 178         public void Dispose()
 179         {
 180             this.Dispose(true);
 181             GC.SuppressFinalize(this);
 182         }
 183
 184         ~ImageCache()
 185             => this.Dispose(false);
 186     }
 187 }