Xuan.UWP.Framework(2)

  上一章主要介绍了Xuan.UWP.Framework.ImageLib的基本用法，这一章具体来看些Xuan.UWP.Framework.ImageLib的使用。

  一、首先看下Xuan.UWP.Framework.ImageLib中最主要的class之一的ImageLoader。

可以看到ImageLoader采用单例模式，外部提供的方法为CaheImageAsync,GetImageStreamAsync和GetStorageFileFromCache三个方法。第一个方法CaheImageAsync是提供了外部StorageFile 缓存共同管理。GetImageStreamAsync提供了获取下载图片的Stream，GetStorageFileFromCache可以通过url来获得缓存的图片用于图片处理或者分享等等。

例如：

  using (var stream = await ImageLib.ImageLoader.GetInstance.GetImageStreamAsync(@"http://ecx.images-amazon.com/images/I/512Pd6birKL.jpg",
                null, new System.Threading.CancellationToken())) {
                if (stream != null && stream.Size > 0) {
                    var bit = new BitmapImage();
                    await bit.SetSourceAsync(stream);
                    img.Source = bit;
                }
            }

源码中 GetImageStreamAsync 使用了几个关键的方法GetStreamFromUriAsync和GetStreamFromCacheOrNetAsync 

 protected virtual async Task<IRandomAccessStream> GetStreamFromUriAsync(Uri uri, CancellationToken cancellationToken) {
            switch (uri.Scheme) {
                case "ms-appx":
                case "ms-appdata": {
                        var file = await StorageFile.GetFileFromApplicationUriAsync(uri);
                        return await file.OpenAsync(FileAccessMode.Read).AsTask(cancellationToken).ConfigureAwait(false);
                    }
                case "ms-resource": {
                        var rm = ResourceManager.Current;
                        var context = ResourceContext.GetForCurrentView();
                        var candidate = rm.MainResourceMap.GetValue(uri.LocalPath, context);
                        if (candidate != null && candidate.IsMatch) {
                            var file = await candidate.GetValueAsFileAsync();
                            return await file.OpenAsync(FileAccessMode.Read).AsTask(cancellationToken).ConfigureAwait(false);
                        }
                        throw new Exception("Resource not found");
                    }
                default: {
                        return null;
                    }
            }
        }

 protected virtual async Task<IRandomAccessStream> GetStreamFromCacheOrNetAsync(string url, DisplayImageOptions options) {
            IRandomAccessStream randomStream = null;
            randomStream = await GetStreamFromCacheAsync(url).ConfigureAwait(false);
            if (randomStream == null) {
                randomStream = await GetStreamFromNetAsync(url).ConfigureAwait(false);
                if (options.CacheOnStorage && randomStream != null && randomStream.Size > 0) {
                    await _config.StorageCache.SaveAsync(url, randomStream).ConfigureAwait(false);
                }
            }
            return randomStream;
        }

其中GetStreamFromUriAsync很简单通过uri的scheme来判断如果是本地资源文件将直接读取，如果是网络图片将使用GetStreamFromCacheOrNetAsync进行加载。如果存在本地缓存，将直接读取本地缓存，如果本地不存再缓存则将下载图片并缓存图片。GetStreamFromCacheOrNetAsync中的具体内容将放到下一章来介绍。 

ImageLoader还包含了SourceProperty类型为DependencyProperty依赖属性这里可以认为是Image的附加属性。方便再Xaml中使用。

 xmlns:imageloader="using:Xuan.UWP.Framework.ImageLib" 

    <DataTemplate x:Key="SimpleImageDataTemplate">
            <Grid> 
                <Image imageloader:ImageLoader.Source="{Binding Url}" Width="200" Height="200"/>
            </Grid>
        </DataTemplate>

   <Image x:Name="img" imageloader:ImageLoader.Source="https://ss0.bdstatic.com/5aV1bjqh_Q23odCf/static/superman/img/logo/bd_logo1_31bdc765.png"/>

二、ImageLoader再使用前需要配置ImageLoaderConfiguration 目前ImageLoaderConfiguration最终要的当属StorageCache，StorageCache可以自行实现抽象类StorageCacheBase。也可以使用默认实现StorageCache。

StorageCache 需要配置缓存的目录，以及文件名称的加密和缓存的时间。

    public App() {
            this.InitializeComponent();
            this.Suspending += OnSuspending;
            var configuration = new ImageLib.Config.ImageLoaderConfiguration.Builder()
                                 .StorageCache(new ImageLib.Cache.StorageCache(ApplicationData.Current.LocalCacheFolder,
                                 "test", new ImageLib.Cache.SHA1CacheGenerator(), 0))
                                 .Build();
            ImageLib.ImageLoader.GetInstance.InitConfig(configuration);
        }

  Github : https://github.com/skyyuxuan/Xuan.UWP.Framework