Данная статья представляет собой авторский перевод статьи MSDN "Windows Communication Foundation Architecture Overview". Оригинал статьи расположен по адресу http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dnlong/html/wcfarch.asp Все права на данную статью принадлежат Microsoft Corporation

Рис. 2. Класс EndpointAddress содержит URI, Identity и коллекцию AddressHeaders.

Привязки
Привязка имеет имя, пространство имен, а также коллекцию компонуемых элементов привязки (BindingElement) (рис. 3). Имя и пространство имен привязки уникально идентифицируют ее а пределах сервиса. Каждый элемент привязки описывает как конечная точка общается с вешним миром. Рис. 3. Класс Binding и его члены.
Например, на рисунке 4 показана коллекция из трех элементов привязки. Наличие каждого из этих элементов привязки описывает конкретный аспект взаимодействия в конечной точкой. TcpTransportBindingElement показывает что конечная точка будет взаимодействовать с внешним миром, используя TCP в качестве транспортного протокола. ReliableSessionBindingElement говорит о том, что конечная точка использует гарантированную доставку сообщений. SecurityBindingElement указывает на то, что конечная точка использует механизм защиты на уровне сообщений SOAP. Каждый элемент привязки обычно имеет свойства которые более конкретно описывают как взаимодействует конечная точка с внешним миром. Например, ReliableSessionBindingElement имеет свойство Assurances, которое определяет уровень требований по гарантированной доставке каждого сообщения, такой как негарантированная доставка (none), не менее одного раза, не более одного раза, только один раз.

Рис. 7. Объектная модель ChannelDescription

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

Сообщение
Сообщение WCF это единица обмена данных между клиентом и конечной точкой сервиса. По своей сути Message WCF являeтся представлением сообщений SOAP InfoSet. Отметим что сообщения не имеют жесткой привязки к формату текстового представления XML. Вместо этого, в зависимости от используемого механизма кодировки, сообщение может быть сериализовано в двоичный формат WCF, текстовый XML, или любой другой формат специальный формат.

Каналы
Каналы представляют собой базовую абстракцию для механизма передачи сообщений в и приема сообщений из конечной точки. Вообще говоря, существует две категории каналов: первая, это транспортные каналы, которые принимают или передают бинарные потоки, используя для этого транспортные протоколы, такие как TCP, UDP или MSMQ. Вторая категория, это каналы протокола, которые реализуют базирующиеся на SOAP протоколы обработки и модификации сообщений. Например, канал безопасности (security channel) обеспечивает обработку специальных заголовков SOAP сообщений, а также может модифицировать тело сообщения, шифруя его. Каналы компонуются таким образом, чтобы обеспечить последовательную обработку сообщения несколькими каналами.

EndpointListener
Класс EndpointListener реализует конечную точку (ServiceEndpoint) во время исполнения. Свойства EndpointAddress, Contract, и Binding класса ServiceEndpoint (определяющие где, что и каким образом), соотносятся с такими свойствами EndpointListener-а, как адрес, диспетчер и фильтры сообщений и стек каналов соответственно. EndpointListener содержит стек каналов, который отвечает за отправку и прием сообщений.

ServiceHost и ChannelFactory
Среда исполнения WCF обычно создается при вызове метода ServiceHost.Open. ServiceHost (рис. 8) управляет созданием описателя сервиса (ServiceDescription) на основе типа реализующего сервис и заполнением коллекции конечных точек (ServiceEndpoint) определенных в коде и/или в конфигурационном файле. Затем ServiceHost использует полученный таким образом ServiceDescription при создании стека каналов в каждом из EndpointListener, которые создаются для каждой конечной точки (ServiceEndpoint) описателя сервиса (ServiceDescription).

Рис. 8. Объектная модель ServiceHost
Подобным образом на клиентской стороне, клиентская среда исполнения создается посредством класса ChannelFactory, который является клиентским эквивалентом класса ServiceHost.
ChannelFactory управляет созданием описателя канала (ChannelDescription), используя для этого тип, реализующий клиентский контракт, привязку и адрес конечной точки. Созданный описатель канала (ChannelDescription) используется для построения стека каналов.
В отличие от среды исполнения сервиса, клиентская среда исполнения не содержит EndpointListener-ов, потому что клиент всегда сам инициирует соединение с сервисом и ему не нужно «прослушивать» входящие соединения.

Примеры кода

Эта секция представляет примеры кода, которые иллюстрируют как создаются сервисы и клиенты. Данные примеры предназначены для иллюстрации основных концепций, а не для обучения приемам программирования в WCF.
Определение и реализация контракта
Как упоминалось выше, простейшим способом определить контракт является создание интерфейса или класса, помеченного атрибутом ServiceContractAttribute, позволяющее системе легко создать на его основе описатель контракта (ContractDescription).
Когда мы используем класс или интерфейс для определения контракта, каждый метод, который является членом контракта должен быть помечен атрибутом OperationContractAttribute. Например:

using System.ServiceModel;

//конракт WCF определен с использованием интерфейса
[ServiceContract]
public interface IMath
{
[OperationContract]
int Add(int x, int y);
}

//этот класс сервиса реализует интерфейс
public class MathService : IMath
{
public int Add(int x, int y)
{ return x + y; }
}

public class WCFServiceApp
{
public void
DefineEndpointImperatively()
{
//создаем хост для сервиса MathService
ServiceHost sh = new
ServiceHost(typeof(MathService));

//используем метод AddEndpoint для
//создания конечной точки
ServiceEndpoint и включения ее
//в описание
сервиса ServiceDescription
sh.AddServiceEndpoint(
typeof(IMath), //тип,
реализующий контракт
new WSHttpBinding(), //одна из стандартных привязок
"http://localhost/MathService/Ep1"); //адрес конечной точки

//создаем и открываем среду исполнения сервиса
sh.Open();

}

public void DefineEndpointInConfig()
{
создаем хост для сервиса
MathService
ServiceHost sh = new ServiceHost (typeof(MathService));

//создаем и открываем среду исполнения сервиса
sh.Open();

}
}

<configuration xmlns="http://schemas.microsoft.com/.NetConfiguration/v2.0">
<system.servicemodel>
<services>

<service type="MathService">

<endpoint contract="IMath" binding="wsHttpBinding" address="http://localhost/MathService/Ep1">
</service>
</services>
</system.servicemodel>
</configuration>

 

 

using System.ServiceModel;
//этот контракт сгенерирован утилитой svcutil.exe
//из метаданных сервиса
public interface IMath
{
[OperationContract]
public int Add(int x, int y)
{ return x + y; }
}


//этот класс сгенерирован утилитой svcutil.exe
//из
метаданных сервиса
//сгенерированный config не показан здесь
public
class MathProxy : IMath
{
...
}

public class WCFClientApp
{
public void SendMessageToEndpoint()
{
//используем прокси
класс, который бвл
//создан утилитой svcutil.exe на основе метаданных
сервиса
MathProxy proxy = new MathProxy();

int result =
proxy.Add(35, 7);
}
public void SendMessageToEndpointUsingChannel()
{
//используем ChannelFactory чтобы создать канал
//вы должны
указать адрес, привязку и
//тип, реализующий контракт (IMath)
ChannelFactory factory=new ChannelFactory(
new
WSHttpBinding(),
new EndpointAddress("http://localhost/MathService/Ep1"));
IMath channel=factory.CreateChannel();
int result=channel.Add(35,7);
factory.Close();

}
}