Transfert de fichiers en utilisant un Web Service avec la technologie MTOM et WSE 3.0

Transcription

1 Transfert de fichiers en utilisant un Web Service avec la technologie MTOM et WSE 3.0 par Jean-Alain Baeyens (autres articles) Date de publication : 17/01/2008 Dernière mise à jour : Si vous utilisez une architecture utilisant la tecnologie web service, vous aurez peut être besoin de transférer des fichiers au travers de ces web services (upload, download, transfert d'une image vers l'interface graphique...). Un moyen très simple pour y parvenir est l'utilisation de MTOM (Message Transmission Optimization Mechanism).

2 I - Introduction II - Configuration II-A - Vous utilisez Visual Studio II-A-1 - Projet Web service. II-A-2 - Projet client II-B - Vous n'utilisez pas Visual Studio II-B-1 - Le Web Service II-B-2 - Le client III - Le web service IV - Le client V-A - Limitation VI - Conclusion - 2 -

3 I - Introduction Récemment, j'ai du étudier la possibilité de transférer un document Word vers un web service. Le web service prend alors en charge le stockage du document. Un document Word 2003 n'étant pas sérialisable, mes investigations m'ont mené vers WSE (Web service extension). Si WSE 1.0 et WSE 2.0 offraient déjà des possibilités en utilisant la technologie DIME et les attachements (class DIMEAttachment), WSE 3.0 offre la possibilité d'utiliser le nouveau standard MTOM. Avec WSE et MTOM, le transfert d'un fichier binaire au travers d'un web service devient un jeu d'enfant. Dans ce tutoriel nous verrons comment réaliser un upload. Vous serez ensuite capable d'adapter cette technologie à vos besoins. Si vous désirez plus d'informations sur la norme MTOM, je vous suggére de consulter le site du W3C

4 II - Configuration Après avoir créé votre projet Web qui va héberger votre web service ainsi que votre projet client, vous allez devoir configurer les projets pour que le web service et le client utilisent les messages SOAP utilisant MTOM. II-A - Vous utilisez Visual Studio II-A-1 - Projet Web service. Le web service doit être configuré pour accepter les messages SOAP utilisant MTOM. La configuration se fait au travers de la fenêtre de paramètres de WSE 3.0 de votre projet. Faites comme suit: Faites comme suit: 1 Cliquez avec le bouton droit sur le nom du projet 2 Ouvrez la fenêtre "WSE settings 3.0" 3 Choisissez la tabulation "Messaging" 4 Choisissez "Optional" ou "Always"pour le mode MTOM 5 Cliquez sur "Ok" pour valider Si vous choisissez "Always", tous les web services définis dans ce projet devront obligatoirement recevoir des messages SOAP utilisant MTOM. II-A-2 - Projet client Le client doit être configuré pour envoyer au web service des messages SOAP utilisant MTOM. La configuration se fait au travers de la fenêtre de paramètres de WSE 3.0 de votre projet. Faites comme suit: Faites comme suit: 1 Cliquez avec le bouton droit sur le nom du projet 2 Ouvrez la fenêtre "WSE settings 3.0" 3 Choisissez la tabulation "Messaging" 4 Choisissez "On" comme "Client Mode" 5 Cliquez sur "Ok" pour valider II-B - Vous n'utilisez pas Visual Studio Dans ce cas, il vous suffit d'éditer les fichiers de configuration. N'oubliez pas d'ajouter dans vos projets une référence à Microsoft.Web.Services3 II-B-1 - Le Web Service Mettez à jour votre fichier Web.Config, avec le code ci-dessous. Web.Config <configsections> - 4 -

5 Web.Config <section name="microsoft.web.services3" type="microsoft.web.services3.configuration.webservicesconfiguration, Microsoft.Web.Services3, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" /> </configsections> <system.web> <webservices> <soapextensionimportertypes> <add type="microsoft.web.services3.description.wseextensionimporter, Microsoft.Web.Services3, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" /> <soapextensionimportertypes> </webservices> </system.web> <microsoft.web.services3> <messaging> <mtom servermode="always" /> </messaging> </microsoft.web.services3> II-B-2 - Le client Dans le fichier de configuration de l'application cliente, Web.Config ou App.Config selon le type, ajoutez le code suivant: <configuration> <configsections> <section name="microsoft.web.services3" type="microsoft.web.services3.configuration.webservicesconfiguration, Microsoft.Web.Services3, Version= , Culture=neutral, PublicKeyToken=31bf3856ad364e35" /id="ii-b-3"> </configsections> <microsoft.web.services3> <messaging> <mtom ClientMode="On" /> </messaging> </microsoft.web.services3> </configuration> - 5 -

6 III - Le web service Comme vous allez pouvoir vous en rendre compte, le code côté serveur est on ne peut plus simple. Une fois votre classe WebService créée de façon tout à fait classique, il ne vous reste qu'à ajouter la méthode permettant le téléchargement. Cette classe doit recevoir en paramètre un array de Byte. Dans l'exemple ci-dessous, elle recevra également le nom du fichier. De fait, aucun code particulier n'est nécessaire. La méthode ayant reçu l'array de Byte n'a plus qu'à utiliser un FileStream pour l'écrire sur le serveur. VB.NET <WebMethod()> Public Sub LoadDocument(ByVal filename as String, ByVal buffer as Byte()) Dim file as FileStream = New FileStream(filename, FileMode.Create) file.write(buffer, 0, buffer.longlength) file.close() End Sub C# [WebMethod()] public void LoadDocument(string filename, byte[] buffer) { FileStream file = New FileStream(filename, FileMode.Create); file.write(buffer, 0, buffer.longlength); file.close(); } - 6 -

7 IV - Le client Le client n'est pas plus difficile. Après avoir instancié un objet du type du Web service, il n'y a plus qu'à appeler la méthode permettant le téléchargement ("LoadDocument") en utilisant simplement la méthode "ReadAllBytes" de la classe "File" pour lire le fichier et placer son contenu dans un array de byte. VB.NET Dim monws As New MonWebService monws.loaddocument("monfichier.doc", File.ReadAllBytes("c:\sources\MonFichierTmp.doc")) monws.dispose() C# MonWebService monws = New MonWebService(); monws.loaddocument("monfichier.doc", File.ReadAllBytes("c:\sources\MonFichierTmp.doc")); monws.dispose(); - 7 -

8 V-A - Limitation La taille du fichier transmis est limitée à 4 MB. Si vous désirez transmettre de plus gros fichiers, il sera nécessaire de compléter la configuration. D'une part, vous devrez autoriser ASP.NET à transmettre de plus longs messages en ajoutant ou modifiant l'attribut "maxmessagelength" de httpruntime ainsi que vraisemblablement la durée d'exécution. Dans l'exemple qui suit la taille du message est portée à 10MB alors que la durée avant le time out est portée à 3 minutes. <httpruntime maxmessagelength="10240" executiontimeoutinseconds="180"/> Il s'agit de la taille du message, la taille réelle du fichier que vous pourrez télécharger est inférieure à cette taille. D'autre part, vous devrez également agrandir la taille des messages autorisée par WSE. L'exemple ci-dessous supprime simplement cette limite. <microsoft.web.services3> <messaging> <maxmessagelength value="-1" /> </messaging> </microsoft.web.services3> Pour ce dernier, n'oubliez pas d'adapter également le client. Si la taille de vos fichier est importante, il pourrait être judicieux de prévoir un envoi par bloc

9 VI - Conclusion Comme vous avez pu le constater, cette opération est devenue extrèmement simple et ne nécessite aucune expertise particulière. Je vous laisse le soin de réaliser la même opération mais en sens inverse. Vous aurez alors un Web Service capable de faire de l'upload et du Download

10 - 10 -