Общие сведения о создании конечных точек
Вся связь со службой Windows Communication Foundation (WCF) осуществляется через конечные точки службы. Конечные точки обеспечивают доступ клиентов к функциональным возможностям службы WCF. В данном разделе приводится описание структуры конечной точки и способов определения конечной точки в конфигурации и в коде.
Структура конечной точки
Каждая конечная точка содержит адрес, показывающий, где можно найти конечную точку, привязку, показывающую, как клиент может связаться с конечной точкой, и контракт, определяющий доступные методы.
Адрес. Адрес однозначно определяет конечную точку и указывает потенциальным потребителям на место расположения службы. Он представлен в объектной модели WCF адресом EndpointAddress, содержащим универсальный код ресурса (URI) и свойства адреса, включающие идентификацию, некоторые элементы языка описания веб-служб (WSDL) и коллекцию необязательных заголовков. Необязательные заголовки содержат более подробную информацию для идентификации конечной точки и взаимодействия с ней. Дополнительные сведения см. в разделе Задание адреса конечной точки.
Привязка. Привязка задает способ связи клиента с конечной точкой. Привязка задает способ связи конечной точки с внешним миром, включая используемый транспортный протокол (например, TCP или HTTP), используемое кодирование сообщений (например, текстовое или двоичное) и необходимые требования безопасности (например, безопасность сообщений SSL или SOAP). Дополнительные сведения см. в разделе Использование привязок для настройки служб и клиентов.
Контракт службы. Контракт службы показывает, какие функциональные возможности предоставляет клиенту конечная точка. Контракт указывает операции, которые может вызвать клиент, форму сообщения и тип входных параметров или данных, требуемых для вызова операции, а также тип обработки или ответного сообщения, которые может ожидать клиент. Три базовых типа контрактов соответствуют базовым шаблонам обмена сообщениями (MEP): датаграмма (односторонняя связь), запрос-ответ и дуплексная связь (двунаправленная). Контракт службы также может использовать контракты данных и контракты сообщений, чтобы при получении доступа требовались определенные типы данных и форматы сообщений. Дополнительные сведения способах определения контракта службы см. в разделе Создание контрактов служб. Обратите внимание, что клиент также может потребоваться для реализации определяемого службой контракта, называемого контрактом обратного вызова, чтобы получить сообщения от службы в дуплексном шаблоне обмена сообщениями. Дополнительные сведения см. в разделе Дуплексные службы.
Конечную точку службы можно задать императивно с помощью кода или декларативно с помощью конфигурации. Если конечные точки не заданы, то среда выполнения предоставляет конечные точки по умолчанию, добавляя одну конечную точку по умолчанию для каждого базового адреса в каждом контракте службы, реализованном в службе. Как правило, определять конечные точки в коде непрактично, поскольку привязки и адреса для развернутой службы чаще всего отличаются от привязок и адресов, используемых в процессе разработки службы. Обычно более целесообразно задать конечные точки службы в конфигурации, а не в коде. Если не указывать привязку и адрес в коде, их можно изменять без повторной компиляции и повторного развертывания приложения.
Примечание |
---|
При добавлении конечной точки службы, выполняющей олицетворение, необходимо использовать либо один из методов AddServiceEndpoint, либо метод GetContract, чтобы правильно загрузить контракт в новый объект ServiceDescription. |
Определение конечных точек в коде
В следующем примере показано, как задать конечную точку в коде.
Определите контракт для типа IEcho службы, принимающей чужое имя, и выведите на экран ответ «Hello <имя>!»
Реализуйте службу Echo типа, определенного контрактом IEcho.
Задайте адрес конечной точки для службы: https://localhost:8000/Echo.
Настройте службу Echo с помощью привязки WSHttpBinding.
Namespace Echo
{
// Define the contract for the IEcho service
[ServiceContract]
Interface IEcho
{
[OperationContract]
String Hello(string name)
}
// Create an Echo service that implements IEcho contract
Class Echo : IEcho
{
Public string Hello(string name)
{
return "Hello" + name + "!";
}
static void Main ()
{
//Specify the base address for Echo service.
Uri echoUri = new Uri("https://localhost:8000/");
//Create a ServiceHost for the Echo service.
ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);
// Use a predefined WSHttpBinding to configure the service.
WSHttpBinding binding = new WSHttpBinding();
// Add the endpoint for this service to the service host.
serviceHost.AddServiceEndpoint(
typeof(IEcho),
binding,
echoUri
);
// Open the service host to run it.
serviceHost.Open();
}
}
}
' Define the contract for the IEcho service
<ServiceContract()> _
Public Interface IEcho
<OperationContract()> _
Function Hello(ByVal name As String) As String
End Interface
' Create an Echo service that implements IEcho contract
Public Class Echo
Implements IEcho
Public Function Hello(ByVal name As String) As String _
Implements ICalculator.Hello
Dim result As String = "Hello" + name + "!"
Return result
End Function
' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("https://localhost:8000/")
' Create a ServiceHost for the Echo service.
Dim svcHost As ServiceHost = New ServiceHost(GetType(HelloWorld), echoUri)
' Use a predefined WSHttpBinding to configure the service.
Dim binding As New WSHttpBinding()
' Add the endpoint for this service to the service host.
serviceHost.AddServiceEndpoint(GetType(IEcho), binding, echoUri)
' Open the service host to run it.
serviceHost.Open()
Примечание |
---|
Узел службы создается с базовым адресом, а затем остальная часть адреса, относящаяся к базовому адресу, задается как часть конечной точки. Такое секционирование адреса обеспечивает более удобное определение нескольких конечных точек для служб в узле. |
Примечание |
---|
Свойства объекта ServiceDescription в приложении службы нельзя изменять после вызова метода OnOpening для объекта ServiceHostBase. Некоторые члены, такие как свойство Credentials и методы AddServiceEndpoint для объектов ServiceHostBase и ServiceHost, создают исключение, если их изменить на этом этапе. Другие члены можно изменять без появления исключения, но результат при этом будет неопределенным. Аналогично, на стороне клиента нельзя изменять значения ServiceEndpoint после вызова метода OnOpening для объекта ChannelFactory. Если после этого изменить свойство Credentials, создается исключение. Изменение других значений описания клиента происходит без ошибок, но результат изменения в этом случае является неопределенным. Как для службы, так и для клиента, рекомендуется изменять описание до вызова метода Open. |
Определение конечных точек в конфигурации
При создании приложения часто нужно отложить решения для администратора, который выполняет развертывание приложения. Например, часто невозможно узнать заранее, каким будет адрес службы (универсальный код ресурса (URI)). Вместо жестко запрограммированного адреса желательно разрешить администратору ввести его после создания службы. Такая гибкость достигается благодаря конфигурации. Дополнительные сведения см. в разделе Настройка служб.
Примечание |
---|
Используйте средство Служебное средство ServiceModel Metadata Utility Tool (Svcutil.exe) с коммутатором /config:имя_файла[,имя_файла] для быстрого создания файлов конфигурации. |
Использование конечных точек по умолчанию
Если конечные точки не заданы в коде или в конфигурации, то среда выполнения создает конечные точки по умолчанию, добавляя одну конечную точку по умолчанию для каждого базового адреса в каждом контракте службы, реализованном в службе. Базовый адрес можно указывать в коде или в конфигурации, а конечные точки по умолчанию добавляются, когда вызывается метод Open в объекте ServiceHost. Этот пример аналогичен примеру из предыдущего раздела, однако конечные точки не указаны, и поэтому добавляются конечные точки по умолчанию.
Namespace Echo
{
// Define the contract for the IEcho service
[ServiceContract]
Interface IEcho
{
[OperationContract]
String Hello(string name)
}
// Create an Echo service that implements IEcho contract
Class Echo : IEcho
{
Public string Hello(string name)
{
return "Hello" + name + "!";
}
static void Main ()
{
//Specify the base address for Echo service.
Uri echoUri = new Uri("https://localhost:8000/");
//Create a ServiceHost for the Echo service.
ServiceHost serviceHost = new ServiceHost(typeof(Echo),echoUri);
// Open the service host to run it. Default endpoints
// are added when the service is opened.
serviceHost.Open();
}
}
}
' Define the contract for the IEcho service
<ServiceContract()> _
Public Interface IEcho
<OperationContract()> _
Function Hello(ByVal name As String) As String
End Interface
' Create an Echo service that implements IEcho contract
Public Class Echo
Implements IEcho
Public Function Hello(ByVal name As String) As String _
Implements ICalculator.Hello
Dim result As String = "Hello" + name + "!"
Return result
End Function
' Specify the base address for Echo service.
Dim echoUri As Uri = New Uri("https://localhost:8000/")
' Open the service host to run it. Default endpoints
' are added when the service is opened.
serviceHost.Open()
Если конечные точки предоставляются явно, то конечные точки по умолчанию можно добавить, вызвав метод AddDefaultEndpoints в объекте ServiceHost перед вызовом Open. Дополнительные сведения о конечных точках по умолчанию см. в разделах Упрощенная конфигурация и Упрощенная конфигурация служб WCF.