Поделиться через

Пример начала работы

В примере GettingStarted показано, как реализовать типичную службу и типичный клиент с помощью Windows Communication Foundation (WCF). Этот пример является основой для всех остальных базовых образцов технологий.

Замечание

Процедура установки и инструкции по сборке для этого примера находятся в конце этого раздела.

Служба описывает операции, выполняемые в контракте службы, который он предоставляет публично как метаданные. Служба также содержит код для реализации операций.

Клиент содержит определение контракта службы и класса прокси для доступа к службе. Код прокси-сервера создается из метаданных службы с помощью средства служебной программы метаданных ServiceModel (Svcutil.exe).

В Windows Vista служба размещена в службе активации Windows (WAS). В Windows XP и Windows Server 2003 он размещается службами IIS и ASP.NET. Размещение службы в службах IIS или WAS позволяет автоматически активировать её при первом обращении к ней.

Замечание

Если вы предпочитаете начать с примера, в котором служба размещена в консольном приложении вместо IIS, см. пример автономного размещения.

Служба и клиент указывают сведения о доступе в параметрах файла конфигурации, которые обеспечивают гибкость во время развертывания. Сюда входит определение конечной точки, указывающее адрес, привязку и контракт. Привязка определяет параметры транспорта и безопасности, описывающие, как осуществляется доступ к службе.

Служба настраивает поведение во время выполнения для публикации метаданных.

Служба реализует контракт, определяющий шаблон связи с запросом и ответом. Контракт определяется интерфейсом ICalculator , который предоставляет математические операции (добавление, вычитание, умножение и деление). Клиент делает запросы к заданной математической операции, а служба отвечает результатом. Служба реализует контракт ICalculator, определенный в следующем коде.

' Define a service contract.
    <ServiceContract(Namespace:="http://Microsoft.Samples.GettingStarted")>
     Public Interface ICalculator
        <OperationContract()>
        Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()>
        Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()>
        Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double
        <OperationContract()>
        Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double
    End Interface

// Define a service contract.
[ServiceContract(Namespace="http://Microsoft.ServiceModel.Samples")]
public interface ICalculator
{
    [OperationContract]
    double Add(double n1, double n2);
    [OperationContract]
    double Subtract(double n1, double n2);
    [OperationContract]
    double Multiply(double n1, double n2);
    [OperationContract]
    double Divide(double n1, double n2);
}

Реализация службы вычисляет и возвращает соответствующий результат, как показано в следующем примере кода.

' Service class which implements the service contract.
Public Class CalculatorService
Implements ICalculator
Public Function Add(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Add
Return n1 + n2
End Function

Public Function Subtract(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Subtract
Return n1 - n2
End Function

Public Function Multiply(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Multiply
Return n1 * n2
End Function

Public Function Divide(ByVal n1 As Double, ByVal n2 As Double) As Double Implements ICalculator.Divide
Return n1 / n2
End Function
End Class

// Service class that implements the service contract.
public class CalculatorService : ICalculator
{
    public double Add(double n1, double n2)
    {
        return n1 + n2;
    }
    public double Subtract(double n1, double n2)
    {
        return n1 - n2;
    }
    public double Multiply(double n1, double n2)
    {
        return n1 * n2;
    }
    public double Divide(double n1, double n2)
    {
        return n1 / n2;
    }
}

Служба предоставляет конечную точку для взаимодействия со службой, определенной с помощью файла конфигурации (Web.config), как показано в следующем примере конфигурации.

<services>
    <service
        name="Microsoft.ServiceModel.Samples.CalculatorService"
        behaviorConfiguration="CalculatorServiceBehavior">
        <!-- ICalculator is exposed at the base address provided by
         host: http://localhost/servicemodelsamples/service.svc.  -->
       <endpoint address=""
              binding="wsHttpBinding"
              contract="Microsoft.ServiceModel.Samples.ICalculator" />
       ...
    </service>
</services>

Служба предоставляет точку доступа по базовому адресу, определенному хостом IIS или WAS. Привязка настраивается с использованием стандарта WSHttpBinding, который обеспечивает HTTP-связь и поддержки стандартных протоколов веб-служб для адресации и безопасности. Контракт — это ICalculator, реализуемый службой.

Сервис доступен по адресу http://localhost/servicemodelsamples/service.svc клиенту на том же компьютере. Для клиентов на удаленных компьютерах для доступа к службе необходимо указать полное доменное имя вместо localhost.

Платформа по умолчанию не предоставляет метаданные. Таким образом, служба включает ServiceMetadataBehavior и открывает конечную точку обмена метаданными (MEX) по адресу http://localhost/servicemodelsamples/service.svc/mex. В следующей конфигурации показано следующее.

<system.serviceModel>
  <services>
    <service
        name="Microsoft.ServiceModel.Samples.CalculatorService"
        behaviorConfiguration="CalculatorServiceBehavior">
      ...
      <!-- the mex endpoint is exposed at
       http://localhost/servicemodelsamples/service.svc/mex -->
      <endpoint address="mex"
                binding="mexHttpBinding"
                contract="IMetadataExchange" />
    </service>
  </services>

  <!--For debugging purposes set the includeExceptionDetailInFaults
   attribute to true-->
  <behaviors>
    <serviceBehaviors>
      <behavior name="CalculatorServiceBehavior">
        <serviceMetadata httpGetEnabled="True"/>
        <serviceDebug includeExceptionDetailInFaults="False" />
      </behavior>
    </serviceBehaviors>
  </behaviors>
</system.serviceModel>

Клиент взаимодействует с использованием заданного типа контракта с помощью класса клиента, созданного средством служебной программы метаданных ServiceModel (Svcutil.exe). Этот созданный клиент содержится в файле generatedClient.cs или generatedClient.vb. Эта программа извлекает метаданные для данной службы и создает клиент для взаимодействия с клиентским приложением с использованием заданного типа контракта. Размещенная служба должна быть доступна для создания клиентского кода, так как служба используется для получения обновленных метаданных.

Выполните следующую команду из командной строки ПАКЕТА SDK в клиентском каталоге, чтобы создать типизированный прокси-сервер:

svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /out:generatedClient.cs

Чтобы создать клиент в Visual Basic, введите следующее из командной строки пакета SDK:

Svcutil.exe /n:"http://Microsoft.ServiceModel.Samples,Microsoft.ServiceModel.Samples" http://localhost/servicemodelsamples/service.svc/mex /l:vb /out:generatedClient.vb

С помощью созданного клиента клиент может получить доступ к заданной конечной точке службы, настроив соответствующий адрес и привязку. Как и служба, клиент использует файл конфигурации (App.config) для указания конечной точки, с которой он хочет взаимодействовать. Конфигурация конечной точки клиента состоит из абсолютного адреса конечной точки службы, привязки и контракта, как показано в следующем примере.

<client>
     <endpoint
         address="http://localhost/servicemodelsamples/service.svc"
         binding="wsHttpBinding"
         contract=" Microsoft.ServiceModel.Samples.ICalculator" />
</client>

Реализация клиента создает экземпляр клиента и использует типизированный интерфейс для начала взаимодействия со службой, как показано в следующем примере кода.

' Create a client
Dim client As New CalculatorClient()

' Call the Add service operation.
            Dim value1 = 100.0R
            Dim value2 = 15.99R
            Dim result = client.Add(value1, value2)
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result)

' Call the Subtract service operation.
value1 = 145.00R
value2 = 76.54R
result = client.Subtract(value1, value2)
Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result)

' Call the Multiply service operation.
value1 = 9.00R
value2 = 81.25R
result = client.Multiply(value1, value2)
Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result)

' Call the Divide service operation.
value1 = 22.00R
value2 = 7.00R
result = client.Divide(value1, value2)
Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result)

'Closing the client gracefully closes the connection and cleans up resources

// Create a client.
CalculatorClient client = new CalculatorClient();

// Call the Add service operation.
double value1 = 100.00D;
double value2 = 15.99D;
double result = client.Add(value1, value2);
Console.WriteLine("Add({0},{1}) = {2}", value1, value2, result);

// Call the Subtract service operation.
value1 = 145.00D;
value2 = 76.54D;
result = client.Subtract(value1, value2);
Console.WriteLine("Subtract({0},{1}) = {2}", value1, value2, result);

// Call the Multiply service operation.
value1 = 9.00D;
value2 = 81.25D;
result = client.Multiply(value1, value2);
Console.WriteLine("Multiply({0},{1}) = {2}", value1, value2, result);

// Call the Divide service operation.
value1 = 22.00D;
value2 = 7.00D;
result = client.Divide(value1, value2);
Console.WriteLine("Divide({0},{1}) = {2}", value1, value2, result);

//Closing the client releases all communication resources.
client.Close();

При запуске примера запросы и ответы операции отображаются в окне консоли клиента. Нажмите клавишу ВВОД в окне клиента, чтобы завершить работу клиента.

Add(100,15.99) = 115.99
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714

Press <ENTER> to terminate client.

В примере "Начало работы" показан стандартный способ создания службы и клиента. Другая базовая сборка основывается на этом примере, чтобы продемонстрировать конкретные возможности продукта.

Настройка, сборка и запуск примера

  1. Убедитесь, что вы выполнили процедуру настройки One-Time для образцов Windows Communication Foundation.

  2. Чтобы создать версию решения на C# или Visual Basic .NET, следуйте инструкциям по сборке примеров Windows Communication Foundation .

  3. Чтобы запустить пример в конфигурации с одним или несколькими компьютерами, следуйте инструкциям в разделе "Примеры Windows Communication Foundation".

См. также