Services de Web de XML

Dans cette section nous cr�erons un service simple de Web. En travaillant avec le Web entretient les namespaces qui sont exig�s sont r�capitul�s comme suit :

System.Web.Services :

Le namespace consiste un ensemble minimal et complet de types requis pour �tablir un service de Web

System.Web.Services.Description :

Ceci nous permet d'agir l'un sur l'autre avec WSDL programmatically

System.Web.Services.Discovery :

Ces types permettent � un consommateur de d�couvrir les services de Web install�s sur une machine donn�e

System.Web.Services.Protocols :

Ce namespace d�finit un certain nombre de types qui repr�sente des protocoles d'invocation (HTTP-GET, HTTP-POST et SAVON)

Le namespace de System.Web.Services

Le namespace de System.Web.Services est le namespace que nous employons normalement dans la plupart des projets pendant que les types que nous avons besoin sont d�j� d�finis dans ce namespace. Suivre les membres du namespace de System.Web.Services :

WebMethodAttribute : Ajoutant un <WebMethod () > l'attribut � une m�thode dans un service de Web rend la m�thode accessible � partir d'un client � distance par le HTTP. Cet attribut expose la fonctionnalit� de la m�thode � laquelle elle est appliqu�e au monde ext�rieur.

WebService : Ceci d�finit la classe basse facultative pour des services de Web.

WebServiceAttribute : L'attribut de WebService peut �tre employ� pour ajouter l'information � un service de Web qui peut la d�crire est fonctionnalit�.

WebServiceBindingAttribute : D�clare un protocole obligatoire qu'une m�thode donn�e de service de Web met en application.

Codage d'un service d'�chantillon

Nous cr�erons maintenant un service d'�chantillon. Ceci un service simple qui convertit une distance donn�e des kilom�tres en milles et vice-versa. Commencer le studio visuel .NET et ouvrir un nouveau projet � partir du projet de File->New->. Dans le type projets de base visuels choisis de projets de carreau et dans les calibres choisir le service de Web d'asp .NET, appeler ce service comme ConvertUnits et cliquer BIEN. Le nouveau dialogue de projet ressemble � l'image ci-dessous

Par d�faut, les projets de service de Web cr�ent automatiquement un nouvel annuaire virtuel sous IIS et stockeront nos dossiers l�. Commuter � la vue de code du service de Web pour vous porter au code derri�re le dossier qui est un dossier avec la prolongation de .asmx.vb. Si vous notez la fen�tre d'explorateur de solution vous trouverez quatre dossiers qui sont les Global.asax, Service1.asmx, ConvertUnits.vsdisco et le dossier de Web.config. Le dossier de Global.asax nous permet de r�pondre aux �v�nements de global-niveau, le dossier de Web.config nous permet de configurer declaratively notre nouveau service de Web, le dossier de .asmx est un dossier de service de Web qui d�finissent les m�thodes de service et le dossier de .vsdisco est un dossier de d�couverte qui contient une description de XML des services de Web � un URL donn�.

Par d�faut le code derri�re le dossier ressemble � ceci quand vous l'ouvrez :

Imports System.Web.Services
<WebService(Namespace := "http://tempuri.org/")> _
Public Class Service2
Inherits System.Web.Services.WebService
#Region " Web Services Designer Generated Code "
' WEB SERVICE EXAMPLE
' The HelloWorld() example service returns the string Hello World.
' To build, uncomment the following lines then save and build the project.
' To test this web service, ensure that the .asmx file is the start page
' and press F5.
''<WebMethod()> Public Function HelloWorld() As String
' HelloWorld = "Hello World"
' End Function
End Class

Nous construirons sur le code mentionn� ci-dessus derri�re le dossier. Nous mettrons en application une certaine fonctionnalit� simple ajoutant nos propres m�thodes. Le service que nous �tablirons convertira la distance exprim�e en kilom�tres aux milles et vice-versa. Le code pour celui ressemble � ceci :

Imports System
Imports System.Web.Services

<WebService(Namespace := "http://tempuri.org/")> _
Public Class Service1 Inherits System.Web.Services.WebService

#Region " Web Services Designer Generated Code "

#End Region

<WebMethod()> Public Function ConvertUnits(ByVal EnterUnit As Decimal, _
ByVal FromUnits As String, ByVal ToUnits As String)
'ConvertUnits function with three arguments
Select Case FromUnits.ToUpper.Chars(0)
'making a selection with Select Case
Case "K"
'for converting distance from kilometers to miles
Select Case ToUnits.ToUpper.Chars(0)
Case "K"
Return EnterUnit
'if both FromUnits and ToUnits are same, returns the entered distance
Case "M"
Return EnterUnit / 1.4
'converts distance from kilometers to miles, assuming 1 mile=1.4 kilometer
Case Else
'to throw exception
End Select

Case "M"
'for converting distance from miles to kilometers
Select Case ToUnits.ToUpper.Chars(0)
Case "M"
Return EnterUnit
Case "K"
Return EnterUnit * 1.4
'converts distance from miles to kilometers
Case Else
'to throw exception
End Select
End Select
End Function

End Class

Apr�s avoir fini avec le code le courir en choisissant Debug->Start � partir du menu principal ou en serrant F5 sur le clavier. Par d�faut notre navigateur fonctionne comme client exp�dient et montre une vue de HTML du march� de m�thodes avec le <WebMethod () > attribut. Cliquer ici pour regarder la page que le premier charge quand vous courez ce service.�Cliquer sur le lien ConvertUnits. Cliquer sur le lien vous porte � une page qui fournit les types de bo�te � textes qui nous permettent d'�crire quelques valeurs dans eux. �crire une certaine valeur dans le domaine d'EnterUnit et dans le domaine de FromUnits �crire ou M ou K et dans le ToUnits class� �crivent K ou M. Si vous souhaitez convertir 1000 kilom�tres en milles puis vous devez �crire 1000 dans le domaine d'EnterUnit, K dans le FromUnits et M dans le ToUnits. Une fois que vous �tes faits avec lui, le clic appellent. Ceci appellera la m�thode que nous avons �crite en code et le r�sultat sera retourn� par l'interm�diaire d'un attribut de XML. Clic ici pour courir le service maintenant. C'est tout qu'il prend pour cr�er un service simple de Web.

Service 2 d'�chantillon

Dans cette section nous cr�erons un service de Web de calculatrice que les travaux semblables � une calculatrice et effectue des op�rations comme ajouter, soustraient, multiplient, se divisent et nous consommerons ce service de Web avec une application de base visuelle de Windows. Pour commencer, ouvrir un nouveau projet et un Web choisi d'asp .NET service ou ajouter un nouveau service de Web au projet existant de service de Web d'asp .NET droit-en cliquant l'explorateur de nom de projet en solution et en choisissant le service de Web d'Add->Add. Nommer ce projet comme calculatrice, ouvrir le code derri�re le dossier et commencer � �crire le code suivant.

Imports System
Imports System.Web.Services

<WebService(Namespace := "http://tempuri.org/")> _
Public Class Service1
Inherits System.Web.Services.WebService

#Region " Web Services Designer Generated Code "

#End Region

<WebMethod(Description:="Click to Add numbers")> Public Function Add_
(ByVal x As Integer, ByVal y As Integer) As Integer
'this method adds two numbers by accepting the input from the user
'Description property allows to document the functionality of the Web method.
Return x + y
End Function

<WebMethod(Description:="Click to Subtract numbers")> Public Function Subtract_
(ByVal x As Integer,ByVal y As Integer) As Integer
'this method subtracts by accepting the input from the user
Return x - y
End Function

<WebMethod(Description:="Click to Multiply numbers")> Public Function Multiply_
(ByVal x As Integer,ByVal y As Integer) As Integer
'this method multiplies two numbers by accepting the input from the user
Return x * y
End Function

<WebMethod(Description:="Click to Divide numbers")> Public Function Divide_
(ByVal x As Integer,ByVal y As Integer) As Integer
'this method divides two numbers by accepting the input from the user
If (y = 0) Then
Throw New Exception("Can't divide by zero")
'if number entered is 0 throws an exception
End If
Return x / y
End Function

End Class

Une fois que quand vous finissez avec le code courir le service en choisissant Debug->Start � partir du menu principal ou en serrant F5 sur le clavier. Le service qui charge peut �tre regard� en cliquant ici. Vous pouvez regarder toutes m�thodes que nous avons cr��es en code avec la description de m�thode � cette page. En outre vous pouvez �crire quelques valeurs dans les bo�tes � textes et examiner le service. Nous consommerons ce service sous une forme de Windows.

Consommation de ce service de Web

Ouvrir un nouveau projet de base visuel et choisir l'application de Windows � partir du calibre. De la bo�te � outils ajouter un bouton � la forme. Notre intention ici est de consommer le service de Web que nous avons cr�� avec cette application de Windows. Quand nous cliquons le bouton il appellera la m�thode que nous indiquons dans lui est �v�nement de clic et renverra le r�sultat calcul� dans un MessageBox.

Ajouter la r�f�rence de service de Web � l'application de Windows

Nous pouvons ajouter une r�f�rence au service de Web dans deux mani�res, avec l'explorateur de solution et � l'aide de l'outil de WSDL. Dans le clic de droit d'explorateur de solution sur des r�f�rences et choisi ajouter la r�f�rence de Web. Cela ouvrent un calibre semblable � l'image ci-dessous.

Dans le type de barre d'adresse l'URL du service de calculatrice que nous avons cr��. Puisqu'il est dans le r�pertoire racine d'IIS vous devez dactylographier le suivant adressez : http://localhost/Calculator/Service1.asmx. Il devrait ressembler � l'image ci-dessous.

Apr�s que le service de calculatrice soit charg�, le clic ajoutent la r�f�rence. Cela ajoute une r�f�rence au service de calculatrice.

Pour utiliser l'outil de WSDL pour ajouter une r�f�rence � ce service de Web, le message de sollicitation de commande visuel ouvert du studio .NET, changent la chemise dans le message de sollicitation de commande en endroit o� vous avez cr�� la calculatrice et dactylographiez ce qui suit :

WSDL ��http://localhost/Calculator/Service1.asmx�� /l : VB. Apr�s que vous finissiez de dactylographier la commande, en solution l'explorateur, droit-cliquent la calculatrice, choisie ajouter et puis cliquer ajoutent l'article existant. Localiser Service1.vb, et puis cliquer pour le choisir. Cliquer ouvert.

Appeler le service de la forme de Windows

Ouvrir Form1 et placer le code suivant. Se rappeler que nous appelons une m�thode quand le bouton dans cette application est cliqu�. Nous devons cr�er un exemple du localhost de classe de procuration. Service1 et appellent la fonction, passant un argument de corde. Le code pour celui ressemble � ceci :

Public Class Form1
Inherits System.Windows.Forms.Form

#Region " Windows Form Designer generated code "

#End Region

Dim myService As localhost.Service1 = New localhost.Service1()
'creating an instance

Private Sub Form1_Load(ByVal sender As System.Object, ByVal e As_
System.EventArgs) Handles MyBase.Load

End Sub

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As_
System.EventArgs) Handles Button1.Click
MessageBox.Show("Sum is " & myService.Add(10, 20))
'calling the Add method in the Web Service returning the result in a messagebox
End Sub

End Class

Une fois que vous finissez avec l'application, courir la forme et cliquer sur le bouton. La somme de deux nombres sera montr�e dans un MessageBox. Nous avons non seulement cr�� un service de Web mais avons �galement consomm� le service dans l'autre application.

Service 3 d'�chantillon

Dans cette section nous �tablirons un service plus int�ressant de Web qui renvoie un ensemble de donn�es de l'AGITATION .NET, contenant l'ensemble complet des disques d'une table. Nous cr�erons notre propre table de base de donn�es et acc�derons aux donn�es de la table avec ce service de Web. Commencer, ouvrir le Microsoft Access et cr�er une nouvelle base de donn�es a appel� Currency. Cr�er une nouvelle table Table1 et ajouter trois colonnes appel�es, code de pays, nom de pays et devise. �crire quelques valeurs dans la table et les cl�turer. Ouvrir le studio visuel .NET et choisir le service de Web d'asp .NET � partir du type calibre de projets. Tra�ner un raccordement d'OleDb de l'�tiquette de donn�es dans la bo�te � outils et en utilisant la fen�tre de propri�t�s construire une corde de raccordement qui relie � la devise la base de donn�es que nous avons cr��e. Commuter � la vue de code et commencer � �crire le code suivant.

Imports System
Imports System.Web.Services
Imports System.Data.OleDb
'import this namespace as we are working with an OleDb source

<WebService(Namespace := "http://tempuri.org/")> _

Public Class Service1 Inherits System.Web.Services.WebService

#Region " Web Services Designer Generated Code "

#End Region

<WebMethod()> Public Function GetData() As DataSet
'WebMethod name is GetData,generate data set
Dim da as OleDbDataAdapter=new OleDbDataAdapter("Select * From Table1",_
OleDbConnection1)
'dataadapter
Dim ds As DataSet=new DataSet()
'declaring a new DataSet
da.Fill(ds, "Table1")
'filling dataadapter
Return ds
'returning dataset
End Function
End Class

Consommation du service

Une fois que vous finissez avec coder le service de Web nous devons consommer ce service. Pour faire cela, ouvrir une nouvelle application de Windows et de la drague de bo�te � outils un DataGrid et un bouton. Notre intention ici est de charger les donn�es de Table1 dans la base de donn�es de devise dans le DataGrid quand nous cliquons le bouton. Maintenant, ajouter une r�f�rence de Web au service de Web en choisissant Reference->Add WebReference dans la fen�tre d'explorateur de solution. �crire l'URL du service dans la barre d'adresse et le clic ��ajoutent la r�f�rence��. Cela ajoute une r�f�rence au service de Web. Maintenant double-cliquer sur le bouton et �crire le code suivant.

Public Class Form1 Inherits System.Windows.Forms.Form

#Region " Windows Form Designer generated code "

#End Region

Private Sub Button1_Click(ByVal sender As System.Object, ByVal e_
As System.EventArgs)Handles Button1.Click
Dim myService As New localhost.Service1()
'an instance of the Web service
Dim ds1 As DataSet = myService.GetData
DataGrid1.DataSource = ds1.Tables("Table1")
'filling the datagrid with table
End Sub
End Class

Une fois que vous finissez avec le code, courir l'application de Windows et cliquer sur le bouton. Les donn�es que vous avez saisies dans Table1 de la base de donn�es de devise seront montr�es dans le datagrid. La diff�rence, nous acc�dons aux donn�es avec un service de Web. D'image les affichages ci-dessous cela.