Alors que nous venons de passer (pour les abonnés MSDN!) en version RTM de Windows 8 et VS2012, nous n’avons pas encore de SDK Azure pour le Windows Runtime, en particulier pour l’accès au Blob storage. Actuellement pour y accéder et gérer le contenu nous pouvons utiliser les services REST de l’Azure Storage.
Dans cet article nous aborderons les sujets suivants :
- Accès aux services REST de l’Azure Storage via la classe HttpClient et authentification des requêtes via les API Windows.Security.Cryptography
- Utilisation des contrôles FileOpenPicker et FileSavePicker
- Mise en place des contrats File Open Picker, File Save Picker et Cached File Updater
Vous pouvez télécharger le code source au format VS2012 RTM ici : AzureStorageExplorerApp.zip
Pour le repasser en VS2012 RC, je pense qu’il vous suffit d’éditer en XML le manifeste et de modifier les attributs OSMinVersion et OSMaxVersion à 6.2.0.
Pour l’exécuter il vous faudra éditer les constantes AccountStorageName et AccountKey de la classe App avec un compte de stockage Azure valide. Ci-dessous un visuel de l’application :
Accès aux services REST Azure
Pour accéder à un compte Windows Azure via les services REST, nous avons besoin d’une connexion internet bien sûr, d’un compte azure et de sa clé.
En terme d’API, nous utilisons la classe HttpClient pour envoyer nos requêtes. Et en fonction de l’opération, nous utilisons les méthodes suivantes :
- Lister les éléments : GetStringAsync(Uri),
- Télécharger un blob : GetStreamAsync(Uri)
- Envoyer un blob : PutAsync(Uri), DeleteAsync(Uri)
Les entêtes Http
Toutes ces opérations nécessitent les entêtes Http suivantes :
- x-ms-date : Date au format UTC
- x-ms-version : numéro de version des services REST Azure
- Authorization : clé signé d’authentification
Dans le cadre d’un envoi de blob il en faudra 3 supplémentaires :
- x-ms-blob-type : type de blob à télécharger, “BlockBlob” ou “PageBlob”
- Accept-Charset : identifie l’encodage
- Content-Lenght : précise la taille du blob à envoyer
Et si nous envoyons un Page Blob alors il faut encore des informations supplémentaires sur sa taille et l’identification du numéro de page que l’on envoie :
- x-ms-blob-content-lenght : représente la taille maximale d’une page de blob
- x-ms-blob-sequence-number : numéro de séquence de la page utilisé par le développeur pour envoyer ses pages au service
D’autres entêtes peuvent être ajoutées mais sont optionnelles. Vous retrouverez tous les détails dans la documentation officielle des services REST Azure .
Le code ci-dessous illustre la construction d’une requête Http permettant de lister les containeurs d’un compte de stockage Azure :
- // Compte de stockage Azure
- var accountStorageName = « win8sample » ;
- var accountKey = « XXXXXXXXXXXXXXXXXXXXXXX » ;
- var now = DateTime .UtcNow;
- // Uri pour lister les containeurs
- Uri uri = new Uri ( « http:// » + storageAccountName + « .blob.core.windows.net/?comp=list » );
- var httpClient = new HttpClient ();
- // Ajout des Entetes Http
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- // Cration de la signature et ajout de l’entete d’authentification
- var signature = RequestHeadersHelper .GetSignature( « GET » , now, httpClient, uri, storageAccountName, storageKey);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- // Appel du service REST et recuperation du resultat sous forme de string
- var response = await httpClient.GetStringAsync(uri);
Authentification de la requête
L’entête Authorization permet de signer la requête. Dans notre cas elle est construite de la manière suivante : [Type de clé] [Compte de stockage]:[Signature]
Cette entête peut se construire différemment selon la version des services REST que nous utilisons (x-ms-version). Dans notre cas nous spécifions que nous utilisons la méthode SharedKey pour la signature.
Cette méthode consiste à créer une chaine de caractères représentant la signature de la requête. Une fois cette signature obtenue, il suffit de l’encoder avec l’algorithme HMAC-SHA256. La valeur de hachage ainsi obtenu représente la signature à ajouter dans l’entête d’authentification.
La signature se compose ainsi :
- string stringToSign = VERB + « \n » +
- Content- Encoding + « \n »
- Content-Language + « \n »
- Content-Length + « \n »
- Content-MD5 + « \n » +
- Content- Type + « \n » +
- Date + « \n » +
- If-Modified-Since + « \n »
- If-Match + « \n »
- If-None-Match + « \n »
- If-Unmodified-Since + « \n »
- Range + « \n »
- CanonicalizedHeaders +
- CanonicalizedResource;
Dans notre exemple, la signature de la requête permettant de lister les containeurs du compte Azure blaut est la suivante :
- string signature = « GET\n\n\n\n\n\n\n\n\n\n\n\nx-ms-date:Sun, 19 Aug 2012 16:43:57 GMT\nx-ms-version:2009-09-19\n/blaut/\ncomp:list » ;
Une fois que nous avons cette signature il nous faut l’encoder via l’algorithme HMAC-SHA256, que nous obtenons via la classe MacAlgorithmProvider dans l’espace de nom Windows.Security.Cryptography.Core :
- MacAlgorithmProvider hmacSha256 = MacAlgorithmProvider .OpenAlgorithm( MacAlgorithmNames .HmacSha256);
Nous avons besoin d’une clé de chiffrement de type CryptographicKey pour chiffrer la signature. Pour obtenir cette clé, il faut récupérer sous forme binaire la clé du compte de stockage Azure puis appeler la méthode CreateKey de l’algorithme de hachage :
- // Dcodage de la cl de stockage Azure
- IBuffer storageKeyBuffer = CryptographicBuffer .DecodeFromBase64String(storageKey);
- // Cration d’une cl de chiffrement partir de la cl de stockage Azure
- CryptographicKey cryptoKey = hmacSha256.CreateKey(storageKeyBuffer);
Il ne reste plus qu’à convertir la signature en binaire pour pouvoir la signer avec la clé. Puis convertir le binaire résultant en chaine de caractères Base64 :
- // Conversion de la signature en binaire
- IBuffer signatureBuffer = CryptographicBuffer .ConvertStringToBinary(signature, BinaryStringEncoding .Utf8);
- // Chiffrement de la signature
- IBuffer hashResult = CryptographicEngine .Sign(cryptoKey, signatureBuffer);
- // Recuperation de la valeur de hachage sous forme d’une string en Base64
- return CryptographicBuffer .EncodeToBase64String(hashResult);
AzureBlobStorageRestServices
Ci-dessous le code complet de la classe permettant d’accéder à son compte de stockage Azure : lister les containeurs, lister les blobs, ajouter, télécharger ou supprimer un blob :
- public static class AzureBlobStorageRestServices
- {
- public async static Task < string > ListContainersAsync( string storageAccountName, string storageKey)
- {
- var now = DateTime .UtcNow;
- // Uri pour lister les containeurs
- Uri uri = new Uri ( « http:// » + storageAccountName + « .blob.core.windows.net/?comp=list » );
- var httpClient = new HttpClient ();
- // Ajout des Entetes Http
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- // Cration de la signature et ajout de l’entete d’authentification
- var signature = AzureBlobStorageRestServices .GetSignature( « GET » , now, httpClient, uri, storageAccountName, storageKey);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- // Appel du service REST et recuperation du resultat sous forme de string
- var response = await httpClient.GetStringAsync(uri);
- return response;
- }
- public async static Task < string > ListBlobsAsync( string containerName, string storageAccountName, string storageKey)
- {
- var now = DateTime .UtcNow;
- // Uri pour lister les blobs d’un containeur
- Uri uri = new Uri ( « http:// » + storageAccountName + « .blob.core.windows.net/ » + containerName + « ?restype=container&comp=list » );
- var httpClient = new HttpClient ();
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- var signature = AzureBlobStorageRestServices .GetSignature( « GET » , now, httpClient, uri, storageAccountName, storageKey);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- var message = await httpClient.GetStringAsync(uri);
- return message;
- }
- public async static Task < Stream > GetBlobAsync( string blobUri, string storageAccountName, string storageKey)
- {
- Uri uri = new Uri (blobUri);
- var now = DateTime .UtcNow;
- var httpClient = new HttpClient ();
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- var signature = AzureBlobStorageRestServices .GetSignature( « GET » , now, httpClient, uri, storageAccountName, storageKey);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- var stream = await httpClient.GetStreamAsync(blobUri);
- return stream;
- }
- public async static Task PutBlobAsync( Stream stream, string blobUri, string storageAccountName, string storageKey)
- {
- Uri uri = new Uri (blobUri);
- var now = DateTime .UtcNow;
- HttpClient httpClient = new HttpClient ();
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- httpClient.DefaultRequestHeaders.Add( « x-ms-blob-type » , « BlockBlob » );
- httpClient.DefaultRequestHeaders.Add( « Accept-Charset » , « UTF-8 » );
- httpClient.DefaultRequestHeaders.TryAddWithoutValidation( « Content-Length » , stream.Length.ToString());
- var signature = GetSignature( « PUT » , now, httpClient, uri, storageAccountName, storageKey, stream.Length);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- System.Net.Http. StreamContent content = new StreamContent (stream);
- var response = await httpClient.PutAsync(blobUri.ToString(), content);
- if (response.StatusCode != System.Net. HttpStatusCode .Created)
- throw new Exception ( « Unable to upload blob » );
- }
- public async static Task DeleteBlobAsync( string blobUri, string storageAccountName, string storageKey)
- {
- var now = DateTime .UtcNow;
- var uri = new Uri (blobUri);
- HttpClient httpClient = new HttpClient ();
- httpClient.DefaultRequestHeaders.Add( « x-ms-date » , now.ToString( « R » , System.Globalization. CultureInfo .InvariantCulture));
- httpClient.DefaultRequestHeaders.Add( « x-ms-version » , « 2009-09-19 » );
- var signature = AzureBlobStorageRestServices .GetSignature( « DELETE » , now, httpClient, uri, storageAccountName, storageKey, 0);
- httpClient.DefaultRequestHeaders.Add( « Authorization » , « SharedKey » + storageAccountName + « : » + signature);
- var response = await httpClient.DeleteAsync(blobUri);
- if (response.StatusCode != System.Net. HttpStatusCode .Accepted)
- throw new Exception ( « Uanble to delete blob » );
- }
- private static string GetSignature( string method, DateTime now, HttpClient httpClient, Uri uri, string storageAccountName, string storageKey, long contentLenght = 0)
- {
- string messageSignature = String .Format( « {0}\n\n\n{1}\n\n\n\n\n\n\n\n\n{2}{3} » ,
- method,
- (method == « GET » || method == « HEAD » ) ? String .Empty : contentLenght.ToString(),
- GetCanonicalizedHeaders(httpClient),
- GetCanonicalizedResource(uri, storageAccountName));
- // Rcupration de l’algorithme HMAC-SHA256
- MacAlgorithmProvider hmacSha256 = MacAlgorithmProvider .OpenAlgorithm( MacAlgorithmNames .HmacSha256);
- // Dcodage de la cl de stockage Azure
- IBuffer storageKeyBuffer = CryptographicBuffer .DecodeFromBase64String(storageKey);
- // Cration d’une cl de chiffrement partir de la cl de stockage Azure
- CryptographicKey cryptoKey = hmacSha256.CreateKey(storageKeyBuffer);
- // Conversion de la signature en binaire
- IBuffer signatureBuffer = CryptographicBuffer .ConvertStringToBinary(messageSignature, BinaryStringEncoding .Utf8);
- // Chiffrement de la signature
- IBuffer hashResult = CryptographicEngine .Sign(cryptoKey, signatureBuffer);
- // Recuperation de la valeur de hachage sous forme d’une string en Base64
- return CryptographicBuffer .EncodeToBase64String(hashResult);
- }
- private static string GetCanonicalizedHeaders( HttpClient httpClient)
- {
- List < string > headerNameList = new List < string >();
- StringBuilder sb = new StringBuilder ();
- foreach ( var heeader in httpClient.DefaultRequestHeaders)
- {
- if (heeader.Key.ToLowerInvariant().StartsWith( « x-ms-« , StringComparison .Ordinal))
- {
- headerNameList.Add(heeader.Key.ToLowerInvariant());
- }
- }
- headerNameList.Sort();
- foreach ( string headerName in headerNameList)
- {
- StringBuilder builder = new StringBuilder (headerName);
- string separator = « : » ;
- foreach ( string headerValue in GetHeaderValues(httpClient.DefaultRequestHeaders, headerName))
- {
- string trimmedValue = headerValue.Replace( « \r\n » , String .Empty);
- builder.Append(separator);
- builder.Append(trimmedValue);
- separator = « , » ;
- }
- sb.Append(builder.ToString());
- sb.Append( « \n » );
- }
- return sb.ToString();
- }
- private static List < string > GetHeaderValues( HttpRequestHeaders headers, string headerName)
- {
- List < string > list = new List < string >();
- IEnumerable < string > values = headers.GetValues(headerName);
- if (values != null )
- {
- foreach ( string str in values)
- {
- list.Add(str.TrimStart( null ));
- }
- }
- return list;
- }
- private static string GetCanonicalizedResource( Uri address, string accountName)
- {
- StringBuilder str = new StringBuilder ();
- StringBuilder builder = new StringBuilder ( « / » );
- builder.Append(accountName);
- builder.Append(address.AbsolutePath);
- str.Append(builder.ToString());
- var param = address.Query;
- if ( string .IsNullOrEmpty(param))
- return str.ToString();
- param = param.Replace( « ? » , « » );
- //List<KeyValuePair<string, string>> values2 = new List<KeyValuePair<string, string>>();
- Dictionary < string , string > values2 = new Dictionary < string , string >();
- foreach ( string str2 in param.Split( ‘&’ ))
- {
- List < string > list = new List < string >() { str2.Split( ‘=’ ).Last() };
- list.Sort();
- StringBuilder builder2 = new StringBuilder ();
- foreach ( object obj2 in list)
- {
- if (builder2.Length > 0)
- {
- builder2.Append( « , » );
- }
- builder2.Append(obj2.ToString());
- }
- values2.Add((str2 == null ) ? str2 : str2.ToLowerInvariant().Split( ‘=’ ).First(), builder2.ToString());
- }
- List < string > list2 = new List < string >(values2.Select(v => v.Key));
- list2.Sort();
- foreach ( string str3 in list2)
- {
- StringBuilder builder3 = new StringBuilder ( string .Empty);
- builder3.Append(str3);
- builder3.Append( « : » );
- builder3.Append(values2[str3]);
- str.Append( « \n » );
- str.Append(builder3.ToString());
- }
- return str.ToString();
- }
- }
Cette classe n’est pas complète et ne prend pas en charge toutes les fonctionnalités des services REST, mais elle représente un bon point de départ…
File Pickers UI
Windows 8 met à disposition les classes FileOpenPicker et FileSavePicker. Ces classes permettent depuis une application d’afficher une interface demandant à l’utilisateur de sélectionner un ou plusieurs fichiers dans la cas du FileOpenPicker, et de sélectionner une destination dans le cas du FileSavePicker.
Ces classes sont disponibles dans l’espace de nom Windows.Storage.Pickers.
Envoi de fichiers vers Azure avec le FileOpenPicker
Dans notre application, nous utilisons le FileOpenPicker pour donner la possibilité à l’utilisateur d’envoyer l’un de ses fichiers vers son compte Azure.
La classe FileOpenPicker permet de demander à l’utilisateur de sélectionner un ou plusieurs fichiers. On doit obligatoirement préciser le type de fichier à sélectionner via la propriété FileTypeFilter. Pour supporter tous les types de fichiers, il faut préciser le filtre “*”.
On peut personnaliser le libellé du bouton de validation du picker via la propriété CommitButtonText et on peut également préciser le répertoire de départ via la propriété SuggestedStartLocation.
Pour déclencher l’affichage du picker il faut appeler la méthode PickSingleFileAsync() ou PickMultipleFilesAsync() qui nous retournera les fichiers sélectionnés sous la forme d’objet StorageFile :
- private async void Upload_Click( object sender, RoutedEventArgs e)
- {
- FileOpenPicker fileOpenPicker = new FileOpenPicker ();
- fileOpenPicker.FileTypeFilter.Add( « * » );
- fileOpenPicker.CommitButtonText = « Upload » ;
- fileOpenPicker.SuggestedStartLocation = PickerLocationId .PicturesLibrary;
- var files = await fileOpenPicker.PickMultipleFilesAsync();
- if (files == null )
- return ;
- var container = DataContext as StorageItem ;
- foreach ( var file in files)
- {
- // Envoi dans l’Azure Storage
- }
- }
Le résultat de l’appel à la méthode PickMultipleFilesAsync :
Téléchargement de fichiers depuis Azure avec le FileSavePicker
Dans notre application le contrôle FileSavePicker est utilisé pour donner la possibilité à l’utilisateur de télécharger vers la destination de son choix un fichier provenant de son compte Azure.
L’utilisation de la classe FileSavePicker nécessite au minimum de spécifier les types de fichiers via la propriété FileTypeChoices.
Comme pour le FileOpenPicker, nous pouvons personnaliser le bouton de validation via la propriété CommitButtonText et spécifier un chemin de départ via la propriété SuggestedStartLocation.
Et enfin nous pouvons suggérer un nom de fichier de destination via la propriété SuggestedFileName :
- private async void Download()
- {
- FileSavePicker savePicker = new FileSavePicker ();
- savePicker.SuggestedFileName = blob.Name;
- savePicker.CommitButtonText = « Download » ;
- savePicker.SuggestedStartLocation = PickerLocationId .PicturesLibrary;
- savePicker.FileTypeChoices.Add( Path .GetExtension(blob.Name), new List < string >() { Path .GetExtension(blob.Name) });
- var storageFile = await savePicker.PickSaveFileAsync();
- if (storageFile != null )
- {
- // Telechargement du fichier Azure vers le storageFile
- }
- }
L’appel à la méthode PickSaveFileAsync() déclenche l’affichage du picker et nous renvoie un objet StorageFile dans lequel il ne reste plus qu’à écrire nos données :
Les contrats File Picker
Pour terminer cet article nous allons implémenter les contrats File Open Picker et File Save Picker. Ces contrats permettent à une application de devenir fournisseur de fichiers dans le cas du File Open Picker Contract et espace de stockage dans le cas du File Save Picker Contract. L’application Skydrive en est un exemple.
File Open Picker Contract
Le contrat File Open Picker est utilisé lorsque l’on veut que notre application devienne fournisseur de fichiers.
Par exemple, lors de la rédaction d’un nouveau mail depuis l’application Courrier, à l’ajout de pièces jointes, l’utilisateur aura la possibilité de sélectionner l’application Azure Explorer pour y sélectionner des fichiers provenant de son compte Azure.
La 1ère étape consiste à déclarer ce contrat dans le manifeste de l’application :
Il faut développer une vue permettant à l’utilisateur de sélectionner un fichier. Cette vue sera activée par la classe App en implémentant la méthode OnFileOpenPickerActivated :
- protected override void OnFileOpenPickerActivated( FileOpenPickerActivatedEventArgs args)
- {
- FileOpenPickerPage page = new FileOpenPickerPage ();
- page.Activate(args);
- }
Dans la méthode Activate de la vue, nous récupérons une instance du contrôle FileOpenPickerUI.
On peut personnaliser le titre de la fenêtre via sa propriété Title, récupérer les types de fichier supportés via sa propriété AllowedFileTypes, ou encore être notifier lorsque l’utilisateur supprime un fichier par l’évènement FileRemoved :
- public void Activate( FileOpenPickerActivatedEventArgs args)
- {
- fileOpenPickerUI = args.FileOpenPickerUI;
- fileOpenPickerUI.Title = storageAccountName + » Azure Storage » ;
- fileOpenPickerUI.FileRemoved += fileOpenPickerUI_FileRemoved;
- Window .Current.Content = this ;
- this .OnNavigatedTo( null );
- Window .Current.Activate();
- }
On utilise ensuite la méthode Add(string, IStorageFile) pour ajouter des fichiers à la sélection de l’utilisateur :
- private async void GridView_ItemClick( object sender, ItemClickEventArgs e)
- {
- StorageItem item = e.ClickedItem as StorageItem ;
- var blob = await dataSource.DownloadBlob(( Blob )item);
- fileOpenPickerUI.AddFile(item.Name, blob);
- }
Pour tester il suffit de lancer l’application Skydrive, de cliquer sur télécharger et dans le FileOpenPicker sélectionner l’application Azure Explorer :
File Save Picker et Cached File Updater Contract
Le contrat File Save Picker est utilisé pour que l’application propose aux autres un espace de stockage. Lors de l’enregistrement d’un fichier via la fenêtre d’enregistrement (FileSavePicker), l’utilisateur peut sélectionner une destination local dans le système de fichiers, ou sélectionner une application qui implémente ce contrat.
Lorsqu’une application va nous demander une destination pour sauvegarder un fichier, nous devrons lui fournir un objet de type StorageFile dans lequel elle écrira les données. Nous allons créer un fichier dans le stockage local de notre application, puis, une fois les données écrites, nous l’enverrons vers Azure.
Dans ce scénario, nous avons besoin d’être notifié lorsque l’application appelante aura terminé d’écrire le fichier. Pour recevoir cette notification nous utiliserons le contrat Cached File Updater.
1ère étape, déclarer les contrats File Save Picker et Cached File Updater dans le manifeste :
Dans la classe App on implémente les méthodes d’activation de nos vues :
- protected override void OnFileSavePickerActivated( FileSavePickerActivatedEventArgs args)
- {
- FileSavePickerPage page = new FileSavePickerPage ();
- page.Activate(args);
- }
- protected override void OnCachedFileUpdaterActivated( CachedFileUpdaterActivatedEventArgs args)
- {
- CachedFilePage page = new CachedFilePage ();
- page.Activate(args);
- }
Du côté de la vue qui implémente le Save File Picker, on récupère l’instance du FileSavePickerUI et on s’abonne à l’évènement TargetFileRequested :
- private FileSavePickerUI fileSavePickerUI = null ;
- public void Activate( FileSavePickerActivatedEventArgs args)
- {
- // cache FileOpenPickerUI
- fileSavePickerUI = args.FileSavePickerUI;
- fileSavePickerUI.TargetFileRequested += fileSavePickerUI_TargetFileRequested;
- Window .Current.Content = this ;
- this .OnNavigatedTo( null );
- Window .Current.Activate();
- }
L’évènement TargetFileRequested est levé lorsque l’utilisateur valide la destination de son fichier. A ce moment là nous devons fournir à l’application appelante un objet StorageFile. Pour donner ce fichier, l’évènement nous envoie un argument de type TargetFileRequestedEventArs. Cet objet possède une propriété Request de type TargetFileRequest, qui lui même a un membre TargetFile de type StorageFile.
L’objet TargetFileRequest possède également une méthode, GetDeferral(), qui nous permet de récupérer un objet de type TargetFileRequestDeferral. Cet objet permet à notre application de s’exécuter de manière asynchrone et elle devra appeler la méthode Complete() pour indiquer à l’application appelante qu’elle a terminé :
- var deferral = args.Request.GetDeferral();
- var storageFile = await ApplicationData .Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption .ReplaceExisting);
- args.Request.TargetFile = storageFile;
- deferral.Complete();
Dans notre cas, nous créons le fichier dans le répertoire local de notre application et nous voulons être notifié lorsque l’application appelante aura écrit les données dans ce fichier, afin de l’envoyer sur Azure. Il faut utiliser la classe CachedFileUpdater et la méthode SetUpdateInformation afin de paramétrer notre notification. Voici le code complet :
- async void fileSavePickerUI_TargetFileRequested( FileSavePickerUI sender, TargetFileRequestedEventArgs args)
- {
- StorageItem storageItem = null ;
- await Dispatcher.RunAsync(Windows.UI.Core. CoreDispatcherPriority .Normal, async () =>
- {
- storageItem = DataContext as StorageItem ;
- });
- var deferral = args.Request.GetDeferral();
- var storageFile = await ApplicationData .Current.LocalFolder.CreateFileAsync(sender.FileName, CreationCollisionOption .ReplaceExisting);
- CachedFileUpdater .SetUpdateInformation(storageFile, storageItem.Uri, ReadActivationMode .NotNeeded, WriteActivationMode .AfterWrite, CachedFileOptions .DenyAccessWhenOffline);
- args.Request.TargetFile = storageFile;
- deferral.Complete();
- }
Du côté de la vue CachedFilePage, à l’activation de notre page, nous devons récupérer l’objet CachedFileUpdaterUI et s’abonner là l’évènement FileUpdateRequested. Cet évènement sera levé lorsque l’application appelante aura terminé l’écriture du fichier local :
- CachedFileUpdaterUI cachedFileUpdaterUI;
- internal void Activate(Windows.ApplicationModel.Activation. CachedFileUpdaterActivatedEventArgs args)
- {
- cachedFileUpdaterUI = args.CachedFileUpdaterUI;
- cachedFileUpdaterUI.FileUpdateRequested += cachedFileUpdaterUI_FileUpdateRequested;
- Window .Current.Activate();
- }
Et pour terminer il ne reste plus qu’à télécharger le fichier local vers Azure :
- async void cachedFileUpdaterUI_FileUpdateRequested( CachedFileUpdaterUI sender, FileUpdateRequestedEventArgs args)
- {
- var deferral = args.Request.GetDeferral();
- var request = args.Request;
- var name = request.File.Name;
- var file = await ApplicationData .Current.LocalFolder.GetFileAsync(name);
- var uri = request.ContentId;
- Uri blobUri = new Uri (uri + « / » + file.Name);
- var dataSource = new AzureStorageDataSource (storageAccountName, storageKey);
- await dataSource.UploadBlob(uri, file.Name, file);
- deferral.Complete();
- }
Conclusion
En l’absence de SDK Azure pour Windows 8 ou tout autre technologie, nous pouvons utiliser les services REST pour accéder aux services de stockage. Le code est bien sur un peu plus long à écrire que si nous avions un SDK, mais je ne doute pas que les équipes de développement Azure en fourniront un rapidement.
Nous ne sommes pas entré dans le détail des services REST de l’Azure Storage, mais nous pouvons bien évidemment faire plus : créer/supprimer un containeur, spécifier des permissions, récupérer les métadatas… Pour aller plus loin, je vous invite à consulter la documentation des services REST de l’Azure Storage.
Pour les contrats File Picker et Cached File Updater, je vous conseille cet article MSDN et les différentes ressources qui gravitent autour (Quickstart, Guidelines, Samples).
Concernant le File Save Picker Contract, je n’ai pas trouvé d’autre manière de l’implémenter, conjointement avec le Cached File Updater pour télécharger le fichier sur Azure. Pourtant, lorsque l’on utilise le File Save Picker de l’application Skydrive, on dirait bien que le fichier est téléchargé directement dans le Cloud, de manière synchrone, avant que le picker ne se referme. Si vous avez des pistes à ce sujet, n’hésitez pas!
Ce jeudi 10 janvier, Microsoft organise le premier après midi du développement autour des données sur les plateformes Windows 8 et Windows Phone 8.
Let There Be Code 