Для примера рассмотрим web службу с помощью которой будем переводить курс из какой либо валюты на рубли, при этом курс вводит сам пользователь. В реальных условиях процесс перевода можно выразить как «СУММА * КУРС», то есть произведение суммы на курс дает нам искомое значение.
При создании новой web службы в Visual Studio 7.0 (или.Net), программисту предоставляется шаблонный код web службы, для того, что бы не переписывать однотипный служебный код по нескольку раз. Это сильно упрощает работу и позволяет сосредоточить внимание на алгоритме и структуре программы.
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Diagnostics;
using System.Web;
using System.Web.Services;
namespace myWebService
{
/// <summary>
/// Summary description for Service1.
/// </summary>
[WebService(Namespace="http://localhost/myWebServices")]
public class Service1: System.Web.Services.WebService
{
public Service1()
{
//CODEGEN: This call is required by the ASP.NET Web Services Designer
InitializeComponent();
}
#region Component Designer generated code
//Required by the Web Services Designer
private IContainer components = null;
/// <summary>
/// Required method for Designer support - do not modify
/// the contents of this method with the code editor.
/// </summary>
private void InitializeComponent()
{
}
/// <summary>
/// Clean up any resources being used.
/// </summary>
protected override void Dispose(bool disposing)
{
if(disposing && components!= null)
{
components.Dispose();
}
base.Dispose(disposing);
}
#endregion
// 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, press F5
// [WebMethod]
// public string HelloWorld()
// {
// return "Hello World";
// }
}
}
Разработчики позаботились о начинающих программистах и сразу создали функцию возвращающую фразу «Hello world». Нам необходимо создать свою функцию которая будет выполнять действие которое нам необходимо, а именно перевод валют.
При создании проекта уже создался файл service1.asmx…. в нем нам предстоит написать код
Добавим к существующему коду функцию convertRub2Euro которой будем передавать два параметра: первый
тип: число с плавающей точкой
назначение: Сумма
курс: нужный курс
Функция возвращает строковое значение.
На рисунке 3-3 приведен текст функции
Рисунок 3‑3
Теперь запустите проект нажав кнопку на панели инструментов. Запуститься браузер с страницей на которой будут отображены функции, доступные для использования. Директива “[WebMthod]” перед кодом функции указывает компилятору на то что эта функция будет вызываться другими приложениями.
Рисунок 3‑4
Нажав на Service Description. можно посмотреть в XML формате как и какие методы поддерживает наша web служба. Ниже приведен увиденный результат:
<?xml version="1.0" encoding="utf-8"?>
- <wsdl:definitions xmlns:soap=" http://schemas.xmlsoap.org/wsdl/soap/ " xmlns:tm=" http://microsoft.com/wsdl/mime/textMatching/ " xmlns:soapenc=" http://schemas.xmlsoap.org/soap/encoding/ " xmlns:mime=" http://schemas.xmlsoap.org/wsdl/mime/ " xmlns:tns=" http://localhost/myWebServices " xmlns:s=" http://www.w3.org/2001/XMLSchema " xmlns:soap12=" http://schemas.xmlsoap.org/wsdl/soap12/ " xmlns:http=" http://schemas.xmlsoap.org/wsdl/http/ " targetNamespace=" http://localhost/myWebServices " xmlns:wsdl=" http://schemas.xmlsoap.org/wsdl/ ">
- <wsdl:types>
- <s:schema elementFormDefault=" qualified " targetNamespace=" http://localhost/myWebServices ">
- <s:element name=" convertRub2Euro ">
- <s:complexType>
- <s:sequence>
<s:element minOccurs=" 1 " maxOccurs=" 1 " name=" num " type=" s:double " />
<s:element minOccurs=" 1 " maxOccurs=" 1 " name=" kurs " type=" s:double " />
</s:sequence>
</s:complexType>
</s:element>
- <s:element name=" convertRub2EuroResponse ">
- <s:complexType>
- <s:sequence>
<s:element minOccurs=" 0 " maxOccurs=" 1 " name=" convertRub2EuroResult " type=" s:string " />
</s:sequence>
</s:complexType>
</s:element>
</s:schema>
</wsdl:types>
- <wsdl:message name=" convertRub2EuroSoapIn ">
<wsdl:part name=" parameters " element=" tns:convertRub2Euro " />
</wsdl:message>
- <wsdl:message name=" convertRub2EuroSoapOut ">
<wsdl:part name=" parameters " element=" tns:convertRub2EuroResponse " />
</wsdl:message>
- <wsdl:portType name=" Service1Soap ">
- <wsdl:operation name=" convertRub2Euro ">
<wsdl:input message=" tns:convertRub2EuroSoapIn " />
<wsdl:output message=" tns:convertRub2EuroSoapOut " />
</wsdl:operation>
</wsdl:portType>
- <wsdl:binding name=" Service1Soap " type=" tns:Service1Soap ">
<soap:binding transport=" http://schemas.xmlsoap.org/soap/http " style=" document " />
- <wsdl:operation name=" convertRub2Euro ">
<soap:operation soapAction=" http://localhost/myWebServices/convertRub2Euro " style=" document " />
- <wsdl:input>
<soap:body use=" literal " />
</wsdl:input>
- <wsdl:output>
<soap:body use=" literal " />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
- <wsdl:binding name=" Service1Soap12 " type=" tns:Service1Soap ">
<soap12:binding transport=" http://schemas.xmlsoap.org/soap/http " style=" document " />
- <wsdl:operation name=" convertRub2Euro ">
<soap12:operation soapAction=" http://localhost/myWebServices/convertRub2Euro " style=" document " />
- <wsdl:input>
<soap12:body use=" literal " />
</wsdl:input>
- <wsdl:output>
<soap12:body use=" literal " />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
- <wsdl:service name=" Service1 ">
- <wsdl:port name=" Service1Soap " binding=" tns:Service1Soap ">
<soap:address location=" http://localhost/myWebService/Service1.asmx " />
</wsdl:port>
- <wsdl:port name=" Service1Soap12 " binding=" tns:Service1Soap12 ">
<soap12:address location=" http://localhost/myWebService/Service1.asmx " />
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Примитивная web – служба готова к использованию. Нажав на название функции, откроется следующая страница в которой помимо технической информации о службе присутствуют поля для ввода входных параметров созданной функции
Service1
Click here for a complete list of operations.