Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
O exemplo de Configuração demonstra o uso de um arquivo de configuração para tornar um serviço detectável.
Configuração de Serviço
O arquivo de configuração neste exemplo demonstra dois recursos:
Tornando o serviço detectável por meio de um padrão UdpDiscoveryEndpoint.
Ajustando informações relacionadas à descoberta para o ponto de extremidade do aplicativo do serviço e ajustando algumas das configurações relacionadas à descoberta no ponto de extremidade padrão.
Para habilitar a descoberta, algumas alterações devem ser feitas no arquivo de configuração do aplicativo para o serviço:
Um ponto de extremidade de descoberta deve ser adicionado ao elemento
<service>. Este é um endpoint padrão UdpDiscoveryEndpoint. Esse é um ponto de extremidade do sistema que o runtime associa ao serviço de descoberta. O serviço de descoberta escuta mensagens neste ponto de extremidade.Um
<serviceDiscovery>comportamento é adicionado à<serviceBehaviors>seção. Isso permite que o serviço seja descoberto em tempo de execução e usa o ponto de extremidade de descoberta mencionado anteriormente para escutar mensagens de descobertaProbeeResolve. Com essas duas inclusões, o serviço é detectável no endpoint de descoberta especificado.
O trecho de configuração a seguir mostra um serviço com um ponto de extremidade de aplicativo definido e um ponto de extremidade de descoberta.
<services>
<service name="Microsoft.Samples.Discovery.CalculatorService"
behaviorConfiguration="calculatorServiceBehavior">
<endpoint address=""
binding="wsHttpBinding"
contract="Microsoft.Samples.Discovery.ICalculatorService"
behaviorConfiguration="endpointBehaviorConfiguration" />
<endpoint name="udpDiscovery"
kind="udpDiscoveryEndpoint"
endpointConfiguration="adhocDiscoveryEndpointConfiguration"/> </service>
</services>
Para aproveitar os anúncios, você precisará adicionar um ponto de extremidade de comunicado. Para fazer isso, modifique o arquivo de configuração conforme mostrado no código a seguir.
<serviceDiscovery>
<announcementEndpoints>
<endpoint kind="udpAnnouncementEndpoint"/>
</announcementEndpoints>
</serviceDiscovery>
Adicionar um ponto de extremidade de comunicado ao comportamento do serviço de descoberta cria um cliente de comunicado padrão para o serviço. Isso garante que o serviço enviará um comunicado online e offline quando o serviço for aberto e fechado, respectivamente.
Esse arquivo de configuração vai além apenas dessas etapas simples modificando comportamentos adicionais. É possível controlar informações relacionadas à descoberta usando pontos de extremidade específicos. Ou seja, um usuário pode controlar se um ponto de extremidade pode ser descoberto e o usuário também pode marcar esse ponto de extremidade com Scopes metadados XML personalizados. Para fazer isso, o usuário deve adicionar uma propriedade behaviorConfiguration ao ponto de extremidade do aplicativo. Nesse caso, a propriedade a seguir é adicionada ao endpoint do aplicativo.
behaviorConfiguration="endpointBehaviorConfiguration"
Agora, por meio do elemento de configuração de comportamento, você pode controlar atributos relacionados à descoberta. Nesse caso, dois escopos são adicionados ao endpoint do aplicativo.
<endpointBehaviors>
<behavior name="endpointBehaviorConfiguration">
<endpointDiscovery>
<scopes>
<add scope="http://www.example.com/calculator"/>
<add scope="ldap:///ou=engineering,o=examplecom,c=us"/>
</scopes>
</endpointDiscovery>
</behavior>
</endpointBehaviors>
Para obter mais informações sobre escopos, consulte Discovery Find e FindCriteria.
Você também pode controlar detalhes específicos do ponto de extremidade de descoberta. Isso é feito por meio do StandardEndpointsSection. Neste exemplo, a versão do protocolo usada é modificada, além de adicionar um maxResponseDelay atributo, conforme mostrado no exemplo de código a seguir.
<standardEndpoints>
<udpDiscoveryEndpoint>
<standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11" maxResponseDelay="00:00:00.600" />
</udpDiscoveryEndpoint>
</standardEndpoints>
Veja a seguir o arquivo de configuração completo usado neste exemplo:
<configuration>
<system.serviceModel>
<services>
<service name="Microsoft.Samples.Discovery.CalculatorService"
behaviorConfiguration="calculatorServiceBehavior">
<endpoint address=""
binding="wsHttpBinding"
contract="Microsoft.Samples.Discovery.ICalculatorService"
behaviorConfiguration="endpointBehaviorConfiguration" />
<!-- Define the discovery endpoint -->
<endpoint name="udpDiscovery" kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration"/> </service>
</services>
<behaviors>
<serviceBehaviors>
<behavior name="calculatorServiceBehavior">
<!-- Add an announcement endpoint -->
<serviceDiscovery>
<announcementEndpoints>
<endpoint kind="udpAnnouncementEndpoint"/>
</announcementEndpoints>
</serviceDiscovery>
</behavior>
</serviceBehaviors>
<endpointBehaviors>
<behavior name="endpointBehaviorConfiguration">
<!-- Add scopes used to identify the service -->
<endpointDiscovery>
<scopes>
<add scope="http://www.example.com/calculator"/>
<add scope="ldap:///ou=engineering,o=examplecom,c=us"/>
</scopes>
</endpointDiscovery>
</behavior>
</endpointBehaviors>
</behaviors>
<standardEndpoints>
<udpDiscoveryEndpoint>
<!-- Configure the UDP discovery endpoint -->
<standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11" maxResponseDelay="00:00:00.600" />
</udpDiscoveryEndpoint>
</standardEndpoints>
</system.serviceModel>
</configuration>
Configuração do cliente
No arquivo de configuração do aplicativo para o cliente, um standardEndpoint de tipo dynamicEndpoint é usado para utilizar a descoberta, conforme mostrado no snippet de configuração a seguir.
<client>
<!-- Create an endpoint, make kind="dynamicEndpoint" and use the endpointConfiguration to change settings of DynamicEndpoint -->
<endpoint name="calculatorEndpoint"
binding="wsHttpBinding"
contract="ICalculatorService"
kind ="dynamicEndpoint"
endpointConfiguration="dynamicEndpointConfiguration">
</endpoint>
</client>
Quando um cliente está usando um dynamicEndpoint, o runtime executa a descoberta automaticamente. Várias configurações são usadas durante o processo de descoberta, como as definidas na seção discoveryClientSettings, que especifica o tipo de ponto de acesso de descoberta a ser usado.
<endpoint kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration" />
Os critérios de localização usados para pesquisar serviços:
<!-- Add Scopes, ScopeMatchBy, Extensions and termination criteria in FindCriteria -->
<findCriteria scopeMatchBy="http://schemas.microsoft.com/ws/2008/06/discovery/rfc" duration="00:00:10" maxResults="1">
<scopes>
<add scope="http://www.microsoft.com/building42/floor1"/>
</scopes>
<!-- These extensions are sent from the client to the service as part of the probe message -->
<extensions>
<CustomMetadata>This is custom metadata that is sent to the service along with the client's find request.</CustomMetadata>
</extensions>
</findCriteria>
Este exemplo estende esse recurso e modifica o FindCriteria usado pelo cliente, bem como algumas propriedades do padrão updDiscoveryEndpoint usado para descoberta. Os FindCriteria são modificados para usar um escopo e algoritmo scopeMatchBy específico, bem como critérios de encerramento personalizados. Além disso, o exemplo também mostra como um cliente pode enviar elementos XML usando Probe mensagens. Por fim, algumas alterações são feitas no UdpDiscoveryEndpoint, como a versão do protocolo utilizado e as configurações específicas do UDP, conforme mostrado no arquivo de configuração a seguir.
<udpDiscoveryEndpoint>
<!-- Specify the discovery protocol version and UDP transport settings. -->
<standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11">
<transportSettings duplicateMessageHistoryLength="2048"
maxPendingMessageCount="5"
maxReceivedMessageSize="8192"
maxBufferPoolSize="262144"/>
</standardEndpoint>
</udpDiscoveryEndpoint>
Veja a seguir a configuração completa do cliente usada no exemplo.
<configuration>
<system.serviceModel>
<client>
<!-- Create an endpoint, make kind="dynamicEndpoint" and use the endpointConfiguration to change settings of DynamicEndpoint -->
<endpoint name="calculatorEndpoint"
binding="wsHttpBinding"
contract="ICalculatorService"
kind ="dynamicEndpoint"
endpointConfiguration="dynamicEndpointConfiguration">
</endpoint>
</client>
<standardEndpoints>
<dynamicEndpoint>
<standardEndpoint name="dynamicEndpointConfiguration">
<discoveryClientSettings>
<!-- Controls where the discovery happens. In this case, Probe message is sent over UdpDiscoveryEndpoint. -->
<endpoint kind="udpDiscoveryEndpoint" endpointConfiguration="adhocDiscoveryEndpointConfiguration" />
<!-- Add Scopes, ScopeMatchBy, Extensions and termination criteria in FindCriteria -->
<findCriteria scopeMatchBy="http://schemas.microsoft.com/ws/2008/06/discovery/rfc" duration="00:00:10" maxResults="1">
<scopes>
<add scope="http://www.microsoft.com/building42/floor1"/>
</scopes>
<!-- These extensions are sent from the client to the service as part of the probe message -->
<extensions>
<CustomMetadata>This is custom metadata that is sent to the service along with the client's find request.</CustomMetadata>
</extensions>
</findCriteria>
</discoveryClientSettings>
</standardEndpoint>
</dynamicEndpoint>
<udpDiscoveryEndpoint>
<!-- Specify the discovery protocol version and UDP transport settings. -->
<standardEndpoint name="adhocDiscoveryEndpointConfiguration" discoveryVersion="WSDiscovery11">
<transportSettings duplicateMessageHistoryLength="2048"
maxPendingMessageCount="5"
maxReceivedMessageSize="8192"
maxBufferPoolSize="262144"/>
</standardEndpoint>
</udpDiscoveryEndpoint>
</standardEndpoints>
</system.serviceModel>
</configuration>
Para usar este exemplo
Este exemplo utiliza endpoints HTTP e, para executar este exemplo, as ACLs de URL corretas devem ser adicionadas. Para obter mais informações, consulte Configurando HTTP e HTTPS. Executar o comando a seguir em um privilégio elevado deverá adicionar as ACLs apropriadas. Talvez você queira substituir o Domínio e o Nome de Usuário pelos argumentos a seguir se o comando não funcionar como está.
netsh http add urlacl url=http://+:8000/ user=%DOMAIN%\%UserName%Crie a solução.
Execute o executável do serviço no diretório de build.
Execute o executável do cliente. Observe que o cliente é capaz de localizar o serviço.