Xuan.UWP.Framework(2)

时间:2023-03-09 05:01:04
Xuan.UWP.Framework(2)

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

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

Xuan.UWP.Framework(2)

可以看到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 > ) {
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 > ) {
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。

Xuan.UWP.Framework(2)

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