ASP .NET & Web Service: Introduzione Andrea Saltarello Microsoft .NET MVP UGIdotNET – http://www.ugidotnet.org

Prerequisiti Abbiamo bisogno di: Il framework .NET  (v1.x) Un ambiente di sviluppo Visual Studio .NET Microsoft Web Matrix Notepad (?) Un web server ASP .NET enabled IIS5+ Cassini (è il web server di Web Matrix)

Funzionalità dei Web Services Programmable logic accessible by standard Web protocols Permettono alle applicazioni di inviare e ricevere informazioni tramite Internet Indipendenti da linguaggi, protocolli e piattaforme Architettura stateless Possono funzionare in modo asincrono Basati su standard W3c in evoluzione

ASP .NET e i Web Services Il motore dei Web Service nel mondo .NET è ASP .NET I Web Service sono contenuti da applicazioni web “normali” Web Form e Web Service possono coesistere nella stessa applicazione Session, Application & C. vengono condivise

Creare un XML Web Service Creare/aggiungere un nuovo XML Web Service mediante Visual Studio .NET Definire le funzioni WebMethod Compilare il progetto web Effettuare un test mediante browser 1 2 3 4

Aggiungere il WS a VS 

Aggiungere il WS a VS 

Struttura di un Web Service Visual Studio .NET crea 2 file: File .asmx File .cs (o .vb)

Struttura di un Web Service Il file ASMX: Permette al web server di “girare” la richiesta http a ASP .NET Contiene la direttiva WebService <%@ WebService Language="vb" Codebehind=“Math.asmx.vb" Class=“MyWebCast.Math" %> <%@ WebService Language=“cs" Codebehind=“Math.asmx.cs" Class="MyWebCast.Math" %>

Struttura di un Web Service Il file .cs (o .vb): Contiene la classe che implementa il Web Service Class Service1 <WebMethod()> Public Function function1() As type ‘corpo della funzione End Function End Class class Service1 { [WebMethod()] public type function1() //corpo della funzione }

Definire i Web Method La classe che implementa il Web Service Può derivare System.Web.Services.WebService (ne riparleremo…) Espone i servizi sotto forma di metodi pubblici decorati con l’attributo WebMethod (è obbligatorio). Questi metodi: Sono chiamati “metodi web” (web methods) Possono accettare come parametri e restituire solo istanze di tipi serializzabili Contengono l’effettiva implementazione del servizio

Definire i Web Method

Provare il Web Service Il runtime di ASP .NET pubblica automaticamente una welcome page per il WS. La welcome page: Può essere personalizzata Visualizza (mediante Reflection) tutti i metodi web disponibili Permette di provare (solo in locale) i metodi web

Provare il Web Service

Provare il Web Service

demo

Usare Web Service: la classe proxy Si presenta come la classe "originale", ma non contiene logica applicativa Usa SOAP per interagire con il Web Service Implementa anche i membri per l’uso asincrono del WS Creata a partire dal file WSDL Web Form Internet XML Web Service Proxy

Creare la classe proxy VS .NET crea la classe proxy partendo dal documento WSDL (Web Services Definition Language) Il documento WSDL Contiene l’elenco dei web method e dei tipi in input/output E’ prodotto da ASP .NET Raggiungibile con l’url: http://miosito/mioservizio.asmx?WSDL E’ linkato dalla welcome page

Provare il Web Service

Il documento WSDL

Creare la classe proxy Creare una Web reference per il Web Service Creare una istanza della classe proxy Chiamare i metodi web del Web Service Eseguire l’applicazione consumer 1 2 3 4 Sub Button1_Click(s As Object, e As EventArgs)... Dim MyMath As New spc.halo.mswebcast.Math() Dim r As Integer = MyMath.Sum(8, 54) End Sub

Creare una Web Reference

Creare una Web Reference

Creare una Web Reference

demo

L’attributo WebService Non è obbligatorio (ma noi lo applichiamo ) Permette di specificare il target namespace (importante!) Permette di specificare una descrizione per il Web Service

Proprietà di WebServiceAttribute Descrizione Description Permette di specificare la descrizione del Web Service da inserire nel documento WSDL e nella pagina di presentazione prodotta da ASP .NET Name Permette di definire per il Web Service un nome differente da quello fornito alla classe che lo implementa Namespace Permette di definire il target namespace utilizzato dal Web service

Provare il Web Service

Impostare il Namespace Impostare il namespace rende non ambigui i tipi di dato veicolati dal web service Per ottenere questo: Il nome del namespace non deve essere ambiguo Tipicamente si usa un nome di dominio DNS come parte del namespace

Impostare il Namespace <WebService(Namespace:=“http://miosito/NS/”)> _ Class Service1 <WebMethod()> _ Public Function function1() As type ‘corpo della funzione End Function End Class [WebService(Namespace=“http://miosito/NS/”)] class Service1 { [WebMethod()] public type function1() //corpo della funzione }

demo

L’attributo WebMethod E’ obbligatorio Permette di specificare una descrizione per il metodo web

Proprietà di WebMethodAttribute Descrizione BufferResponse Permette di abilitare/disabilitare il buffering. Se impostata a true¸ ASP .NET comporrà l’intero pacchetto HTTP di risposta in un buffer prima di inviarlo al client CacheDuration Permette di specificare il tempo, in secondi, di permanenza in cache della risposta generata per il metodo web. Description Permette di specificare la descrizione del metodo web da inserire nel documento WSDL e nella pagina di presentazione del Web Service.

Proprietà di WebMethodAttribute Descrizione EnableSession Se impostato a true, permette al metodo web di avvalersi dei servizi di gestione delle sessioni forniti da ASP .NET MessageName Permette di impostare un alias per il nome del metodo web TransactionOption Permette al metodo web di partecipare ad una transazione nel ruolo di oggetto root della stessa.

demo

Link Web: http://msdn.microsoft.com/webservices/ http://www.ugidotnet.org/webservices.cnt Newsgroup: (news.microsoft.com) nntp://microsoft.public.it.dotnet.framework.webservices nntp://microsoft.public.it.dotnet.soap

Prossimi appuntamenti Consumare Web Services 20 Febbraio 2004 (14:30-16:00) Advanced Web Services 27 Febbraio 2004 (14:30-16:00) http://www.microsoft.com/italy/msdn/webcast/default.asp

© 2003-2004 Microsoft Corporation. All rights reserved. This presentation is for informational purposes only. Microsoft makes no warranties, express or implied, in this summary.