ASP.NET & Web Service: Introduzione Andrea Saltarello Microsoft.NET MVP UGIdotNET – .

ASP .NET & Web ASP .NET & Web Service: IntroduzioneService: Introduzione

Andrea SaltarelloAndrea SaltarelloMicrosoft .NET MVPMicrosoft .NET MVPUGIdotNET – http://www.ugidotnet.orgUGIdotNET – http://www.ugidotnet.org

2

PrerequisitiPrerequisiti

Abbiamo bisogno di:Abbiamo bisogno di:

Il framework .NET Il framework .NET (v1.x) (v1.x)

Un ambiente di sviluppoUn ambiente di sviluppoVisual Studio .NETVisual Studio .NET

Microsoft Web MatrixMicrosoft Web Matrix

Notepad (?)Notepad (?)

Un web server ASP .NET enabledUn web server ASP .NET enabledIIS5+IIS5+

Cassini (è il web server di Web Matrix)Cassini (è il web server di Web Matrix)

3

Funzionalità dei Web ServicesFunzionalità dei Web Services

Programmable logic accessible by standard Web protocolsProgrammable logic accessible by standard Web protocolsPermettono alle applicazioni di inviare e ricevere informazioni tramite InternetPermettono alle applicazioni di inviare e ricevere informazioni tramite Internet

Indipendenti da linguaggi, protocolli e piattaformeIndipendenti da linguaggi, protocolli e piattaforme

Architettura statelessArchitettura stateless

Possono funzionare in modo asincronoPossono funzionare in modo asincrono

Basati su standard W3c in evoluzioneBasati su standard W3c in evoluzione

4

ASP .NET e i Web ServicesASP .NET e i Web Services

Il Il motoremotore dei Web Service nel mondo .NET è dei Web Service nel mondo .NET è ASP .NETASP .NET

I Web Service sono contenuti da applicazioni web I Web Service sono contenuti da applicazioni web “normali”“normali”

Web Form e Web Service possono coesistere nella Web Form e Web Service possono coesistere nella stessa applicazionestessa applicazione

SessionSession, , ApplicationApplication & C.& C. vengono condivise vengono condivise

5

Creare un XML Web ServiceCreare un XML Web Service

1.1. Creare/aggiungere un nuovo XML Creare/aggiungere un nuovo XML Web Service mediante Visual Web Service mediante Visual Studio .NETStudio .NET

2.2. Definire le funzioni Definire le funzioni WebMethodWebMethod

3.3. Compilare il progetto webCompilare il progetto web

4.4. Effettuare un test mediante browserEffettuare un test mediante browser

1111

2222

3333

4444

6

Aggiungere il WS a VS Aggiungere il WS a VS

7

Aggiungere il WS a VS Aggiungere il WS a VS

8

Struttura di un Web ServiceStruttura di un Web Service

Visual Studio .NET crea 2 file:Visual Studio .NET crea 2 file:

File File .asmx.asmx

File File .cs .cs (o(o .vb .vb))

9


Il file ASMX:Il file ASMX:

Permette al web server di “girare” la Permette al web server di “girare” la richiesta http a ASP .NETrichiesta http a ASP .NET

Contiene la direttiva Contiene la direttiva WebServiceWebService

<%@ WebService Language="vb" <%@ WebService Language="vb" Codebehind=“Math.asmx.vb" Class=“MyWebCast.Math" %>Codebehind=“Math.asmx.vb" Class=“MyWebCast.Math" %>

<%@ WebService Language="vb" <%@ WebService Language="vb" Codebehind=“Math.asmx.vb" Class=“MyWebCast.Math" %>Codebehind=“Math.asmx.vb" Class=“MyWebCast.Math" %>

<%@ WebService Language=“cs" <%@ WebService Language=“cs" Codebehind=“Math.asmx.cs" Class="MyWebCast.Math" %>Codebehind=“Math.asmx.cs" Class="MyWebCast.Math" %>

<%@ WebService Language=“cs" <%@ WebService Language=“cs" Codebehind=“Math.asmx.cs" Class="MyWebCast.Math" %>Codebehind=“Math.asmx.cs" Class="MyWebCast.Math" %>

10


Class Class Service1Service1 <WebMethod()> Public Function <WebMethod()> Public Function function1function1() As type() As type

‘ ‘corpo della funzionecorpo della funzione End FunctionEnd FunctionEnd ClassEnd Class

Class Class Service1Service1 <WebMethod()> Public Function <WebMethod()> Public Function function1function1() As type() As type

‘ ‘corpo della funzionecorpo della funzione End FunctionEnd FunctionEnd ClassEnd Class

Il file Il file .cs.cs (o (o .vb.vb):):

Contiene la classe che implementa il Web Contiene la classe che implementa il Web ServiceService

class class Service1Service1{{ [WebMethod()][WebMethod()] public public typetype function1function1()() {{

//corpo della funzione//corpo della funzione }}}}

class class Service1Service1{{ [WebMethod()][WebMethod()] public public typetype function1function1()() {{


11

Definire i Web MethodDefinire i Web Method

La classe che implementa il Web ServiceLa classe che implementa il Web Service

Può derivare Può derivare System.Web.Services.WebServiceSystem.Web.Services.WebService (ne (ne riparleremo…)riparleremo…)

Espone i servizi sotto forma di metodi Espone i servizi sotto forma di metodi pubblicipubblici decorati con l’attributo decorati con l’attributo WebMethodWebMethod (è (è obbligatorio). Questi metodi:obbligatorio). Questi metodi:

Sono chiamati “metodi web” (Sono chiamati “metodi web” (web methodsweb methods))

Possono accettare come parametri e restituire solo Possono accettare come parametri e restituire solo istanze di tipi serializzabiliistanze di tipi serializzabili

Contengono l’effettiva implementazione del servizioContengono l’effettiva implementazione del servizio

12

Definire i Web MethodDefinire i Web Method

13

Provare il Web ServiceProvare il Web Service

Il runtime di ASP .NET pubblica automaticamente Il runtime di ASP .NET pubblica automaticamente una una welcome pagewelcome page per il WS. La welcome page: per il WS. La welcome page:

Può essere personalizzataPuò essere personalizzata

Visualizza (mediante Visualizza (mediante ReflectionReflection) tutti i metodi web ) tutti i metodi web disponibilidisponibili

Permette di provare (solo in locale) i metodi webPermette di provare (solo in locale) i metodi web

14


15


16

demo

17

Usare Web Service: la classe proxyUsare Web Service: la classe proxy

Si presenta come la classe "originale", ma non contiene Si presenta come la classe "originale", ma non contiene logica applicativalogica applicativa

Usa SOAP per interagire con il Web ServiceUsa SOAP per interagire con il Web Service

Implementa anche i membri per l’uso asincrono del WSImplementa anche i membri per l’uso asincrono del WS

Creata a partire dal file Creata a partire dal file WSDLWSDL

InternetInternet XML WebService

XML WebService

ProxyProxy

WebForm

18

Creare la classe proxyCreare la classe proxy

VS .NET crea la classe proxy partendo dal VS .NET crea la classe proxy partendo dal documento documento WSDL WSDL ((Web Services Definition Web Services Definition LanguageLanguage))

Il documento WSDLIl documento WSDLContiene l’elenco dei Contiene l’elenco dei web methodweb method e dei tipi in e dei tipi in input/outputinput/output

E’ prodotto da ASP .NETE’ prodotto da ASP .NET

Raggiungibile con l’url: Raggiungibile con l’url: http://miosito/mioservizio.asmx?http://miosito/mioservizio.asmx?WSDLWSDL

E’ linkato dalla welcome pageE’ linkato dalla welcome page

19


20

Il documento WSDLIl documento WSDL

21

Creare la classe proxyCreare la classe proxy

1.1. Creare una Web reference per il Web Creare una Web reference per il Web ServiceService

2.2. Creare una istanza della classe proxyCreare una istanza della classe proxy

3.3. Chiamare i metodi web del Web ServiceChiamare i metodi web del Web Service

4.4. Eseguire l’applicazione consumerEseguire l’applicazione consumer

Sub Button1_Click(s As Object, e As EventArgs)...Sub Button1_Click(s As Object, e As EventArgs)...Dim MyMath As New spc.halo.mswebcast.Math()Dim MyMath As New spc.halo.mswebcast.Math()Dim r As Integer = MyMath.Sum(8, 54)Dim r As Integer = MyMath.Sum(8, 54)

End SubEnd Sub

Sub Button1_Click(s As Object, e As EventArgs)...Sub Button1_Click(s As Object, e As EventArgs)...Dim MyMath As New spc.halo.mswebcast.Math()Dim MyMath As New spc.halo.mswebcast.Math()Dim r As Integer = MyMath.Sum(8, 54)Dim r As Integer = MyMath.Sum(8, 54)

End SubEnd Sub

1111

2222

3333

4444

22

Creare una Web ReferenceCreare una Web Reference

23


24


25

demo

26

L’attributo WebServiceL’attributo WebService

L’attributo L’attributo WebServiceWebService::NonNon è obbligatorio (ma noi lo applichiamo è obbligatorio (ma noi lo applichiamo ))

Permette di specificare il Permette di specificare il target namespace target namespace (importante!)(importante!)

Permette di specificare una descrizione per il Permette di specificare una descrizione per il Web ServiceWeb Service

27

Proprietà di WebServiceAttributeProprietà di WebServiceAttribute

ProprietàProprietà DescrizioneDescrizioneDescriptionDescription Permette di specificare la descrizione Permette di specificare la descrizione

del Web Service da inserire nel del Web Service da inserire nel documento WSDL e nella pagina di documento WSDL e nella pagina di presentazione prodotta da ASP .NETpresentazione prodotta da ASP .NET

NameName Permette di definire per il Web Service Permette di definire per il Web Service un nome differente da quello fornito un nome differente da quello fornito alla classe che lo implementaalla classe che lo implementa

NamespaceNamespace Permette di definire il target Permette di definire il target namespace utilizzato dal Web servicenamespace utilizzato dal Web service

28


29

Impostare il NamespaceImpostare il Namespace

Impostare il namespace rende non ambigui i Impostare il namespace rende non ambigui i tipi di dato veicolati dal web servicetipi di dato veicolati dal web service

Per ottenere questo:Per ottenere questo:

Il nome del namespace non deve essere Il nome del namespace non deve essere ambiguoambiguo

Tipicamente si usa un nome di Tipicamente si usa un nome di dominio dominio DNSDNS come parte del namespace come parte del namespace

30

Impostare il NamespaceImpostare il Namespace

<WebService(Namespace:=“http://miosito/NS/”)> _<WebService(Namespace:=“http://miosito/NS/”)> _Class Class Service1Service1 <WebMethod()> _<WebMethod()> _

Public Function Public Function function1function1() As type() As type ‘ ‘corpo della funzionecorpo della funzione

End FunctionEnd FunctionEnd ClassEnd Class

<WebService(Namespace:=“http://miosito/NS/”)> _<WebService(Namespace:=“http://miosito/NS/”)> _Class Class Service1Service1 <WebMethod()> _<WebMethod()> _

Public Function Public Function function1function1() As type() As type ‘ ‘corpo della funzionecorpo della funzione

End FunctionEnd FunctionEnd ClassEnd Class

[WebService(Namespace=“http://miosito/NS/”)][WebService(Namespace=“http://miosito/NS/”)]class class Service1Service1{{ [WebMethod()][WebMethod()] public public typetype function1function1()() {{


[WebService(Namespace=“http://miosito/NS/”)][WebService(Namespace=“http://miosito/NS/”)]class class Service1Service1{{ [WebMethod()][WebMethod()] public public typetype function1function1()() {{


31

demo

32

L’attributo WebMethodL’attributo WebMethod

L’attributo L’attributo WebMethodWebMethod::E’ E’ obbligatorioobbligatorio

Permette di specificare una descrizione per il Permette di specificare una descrizione per il metodo webmetodo web

33

Proprietà di WebMethodAttributeProprietà di WebMethodAttribute

ProprietàProprietà DescrizioneDescrizioneBufferResponseBufferResponse Permette di abilitare/disabilitare il Permette di abilitare/disabilitare il

buffering. Se impostata a true¸ buffering. Se impostata a true¸ ASP .NET comporrà l’intero pacchetto ASP .NET comporrà l’intero pacchetto HTTP di risposta in un buffer prima di HTTP di risposta in un buffer prima di inviarlo al clientinviarlo al client

CacheDurationCacheDuration Permette di specificare il tempo, in Permette di specificare il tempo, in secondi, di permanenza in cache della secondi, di permanenza in cache della risposta generata per il metodo web.risposta generata per il metodo web.

DescriptionDescription Permette di specificare la descrizione Permette di specificare la descrizione del metodo web da inserire nel del metodo web da inserire nel documento WSDL e nella pagina di documento WSDL e nella pagina di presentazione del Web Service.presentazione del Web Service.

34

Proprietà di WebMethodAttributeProprietà di WebMethodAttribute

ProprietàProprietà DescrizioneDescrizioneEnableSessionEnableSession Se impostato a Se impostato a truetrue, permette al , permette al

metodo web di avvalersi dei servizi di metodo web di avvalersi dei servizi di gestione delle sessioni forniti da gestione delle sessioni forniti da ASP .NETASP .NET

MessageNameMessageName Permette di impostare un alias per il Permette di impostare un alias per il nome del metodo webnome del metodo web

TransactionOptionTransactionOption Permette al metodo web di partecipare Permette al metodo web di partecipare ad una transazione nel ruolo di oggetto ad una transazione nel ruolo di oggetto root della stessa.root della stessa.

35

demo

36

LinkLink

Web:Web:

http://msdn.microsoft.com/webservices/http://msdn.microsoft.com/webservices/

http://www.ugidotnet.org/webservices.cnthttp://www.ugidotnet.org/webservices.cnt

NewsgroupNewsgroup: (news.microsoft.com): (news.microsoft.com)

nntp://microsoft.public.it.dotnet.framework.nntp://microsoft.public.it.dotnet.framework.webserviceswebservices

nntp://nntp://microsoft.public.it.dotnet.soapmicrosoft.public.it.dotnet.soap

37

Prossimi appuntamentiProssimi appuntamenti

Consumare Web ServicesConsumare Web Services

20 Febbraio 2004 (14:30-16:00)20 Febbraio 2004 (14:30-16:00)

Advanced Web ServicesAdvanced Web Services

27 Febbraio 2004 (14:30-16:00)27 Febbraio 2004 (14:30-16:00)

http://www.microsoft.com/italy/msdn/webcast/default.asphttp://www.microsoft.com/italy/msdn/webcast/default.asp

ASP.NET & Web Service: Introduzione Andrea Saltarello Microsoft.NET MVP UGIdotNET – .

Documents

Transcript of ASP.NET & Web Service: Introduzione Andrea Saltarello Microsoft.NET MVP UGIdotNET – .