Erweiterte Filter

Artikel
12/07/2010

In diesem Beispiel wird ein Windows Communication Foundation (WCF)-Routingdienst veranschaulicht. Der Routingdienst ist eine WCF-Komponente, die das Integrieren eines inhaltsbasierten Routers in die Anwendung vereinfacht. In diesem Beispiel wird das standardmäßige WCF-Rechnerbeispiel für die Kommunikation über den Routingdienst angepasst. In diesem Beispiel wird gezeigt, wie die inhaltsbasierte Routinglogik durch die Verwendung von Nachrichtenfiltern und Nachrichtenfiltertabellen definiert wird.

Hinweis:
Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren. `<Installationslaufwerk>:\WF_WCF_Samples` Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4 auf, um alle Windows Communication Foundation (WCF)- und WF-Beispiele herunterzuladen. Dieses Beispiel befindet sich im folgenden Verzeichnis. `<Installationslaufwerk>:\WF_WCF_Samples\WCF\Basic\RoutingServices\AdvancedFilters`

Hinweis:

Die Beispiele sind möglicherweise bereits auf dem Computer installiert. Überprüfen Sie das folgende (standardmäßige) Verzeichnis, bevor Sie fortfahren.

<Installationslaufwerk>:\WF_WCF_Samples

Wenn dieses Verzeichnis nicht vorhanden ist, rufen Sie Windows Communication Foundation (WCF) and Windows Workflow Foundation (WF) Samples for .NET Framework 4 auf, um alle Windows Communication Foundation (WCF)- und WF-Beispiele herunterzuladen. Dieses Beispiel befindet sich im folgenden Verzeichnis.

<Installationslaufwerk>:\WF_WCF_Samples\WCF\Basic\RoutingServices\AdvancedFilters

Beispieldetails

In der folgenden Tabelle werden die Nachrichtenfilter angezeigt, die der Nachrichtenfiltertabelle des Routingdiensts hinzugefügt werden.

Filter	Regel	Priorität
If (hat Header)	Rundung	2
If (angezeigt an Ep2)	Regulär	1
If (angezeigt mit Address2)	Rundung	1
If (RoundRobin1)	Regulär	0
If (RoundRobin2)	Rundung	0

Die Nachrichtenfilter und Nachrichtenfiltertabellen können entweder durch Code oder in der Anwendungskonfigurationsdatei erstellt und konfiguriert werden. Für dieses Beispiel finden Sie die durch Code definierten Nachrichtenfilter und Nachrichtenfiltertabellen in der Datei RoutingService\routing.cs bzw. die in der Anwendungskonfigurationsdatei definierten Nachrichtenfilter und Nachrichtenfiltertabellen in der Datei RoutingService\App.config. In den folgenden Absätzen wird beschrieben, wie die Nachrichtenfilter und Nachrichtenfiltertabellen für dieses Beispiel durch Code erstellt werden.

Zuerst sucht ein XPathMessageFilter nach dem benutzerdefinierten Header. Beachten Sie, dass WSHttpBinding zu einer Umschlagversion führt, die SOAP 1.2 verwendet, sodass die XPath-Anweisung für die Verwendung des SOAP 1.2-Namespace definiert wird. Der standardmäßige Namespace-Manager für XPathMessageFilter definiert bereits ein Präfix für den SOAP 1.2-Namespace, /s12, das verwendet werden kann. Der standardmäßige Namespace-Manager verfügt jedoch nicht über den benutzerdefinierten Namespace, mit dem der Client den tatsächlichen Headerwert definiert, sodass dieses Präfix definiert werden muss. Der Filter ergibt für jede Nachricht, die mit diesem Header angezeigt wird, eine Übereinstimmung.

XPathMessageContext namespaceManager = new XPathMessageContext();
namespaceManager.AddNamespace("custom", "http://my.custom.namespace/");

XPathMessageFilter xpathFilter = new XPathMessageFilter("/s12:Envelope/s12:Header/custom:RoundingCalculator = 1", namespaceManager);

Der zweite Filter ist ein EndpointNameMessageFilter, der für jede Nachricht eine Übereinstimmung ergibt, die am calculatorEndpoint empfangen wurde. Der Endpunktname wird definiert, wenn ein Dienstendpunktobjekt erstellt wird.

EndpointNameMessageFilter endpointNameFilter = new EndpointNameMessageFilter("calculatorEndpoint");

Der dritte Filter ist ein PrefixEndpointAddressMessageFilter. Dieser Filter ergibt für jede Nachricht eine Übereinstimmung, die an einem Endpunkt mit einer Adresse angezeigt wurde, die mit dem angegebenen Adresspräfix (oder dem Anfang) übereinstimmt. In diesem Beispiel wird das Adresspräfix als "https://localhost/routingservice/router/rounding/" definiert. Dies bedeutet, dass dieser Filter für alle eingehenden Nachrichten, die an "https://localhost/routingservice/router/rounding/*" adressiert sind, eine Übereinstimmung ergibt. In diesem Fall sind es Nachrichten, die am Rundungsrechnerendpunkt mit der Adresse "https://localhost/routingservice/router/rounding/calculator" angezeigt werden.

PrefixEndpointAddressMessageFilter prefixAddressFilter = new PrefixEndpointAddressMessageFilter(new EndpointAddress("https://localhost/routingservice/router/rounding/"));

Die letzten beiden Nachrichtenfilter sind benutzerdefinierte MessageFilter. In diesem Beispiel wird ein "RoundRobin"-Nachrichtenfilter verwendet. Dieser Nachrichtenfilter wird in der bereitgestellten Datei RoutingService\RoundRobinMessageFilter.cs erstellt. Wenn diese Filter für dieselbe Gruppe festgelegt werden, melden sie abwechselnd, dass sie mit der Nachricht übereinstimmen und dass sie nicht mit der Nachricht übereinstimmen, sodass zu jedem gegebenen Zeitpunkt nur ein Filter true zurückgibt.

RoundRobinMessageFilter roundRobinFilter1 = new RoundRobinMessageFilter("group1");

RoundRobinMessageFilter roundRobinFilter2 = new RoundRobinMessageFilter("group1");

Als Nächstes werden diese Nachrichten zu einer MessageFilterTable hinzugefügt. Dadurch werden Prioritäten festgelegt, die die Reihenfolge beeinflussen, in der die Filter in der Nachrichtenfiltertabelle ausgeführt werden. Je höher die Priorität, desto früher wird der Filter ausgeführt; je niedriger die Priorität, desto später wird ein Filter ausgeführt. So wird ein Filter mit Priorität 2 vor einem Filter mit Priorität 1 ausgeführt. Wenn keine Priorität angegeben wird, wird die Standardprioritätsstufe 0 verwendet. In einer Nachrichtenfiltertabelle werden alle Filter einer bestimmten Prioritätsstufe ausgeführt, bevor zur nächst niedrigeren Prioritätsstufe übergegangen wird. Wenn eine Übereinstimmung gefunden wird, fährt die Nachrichtenfiltertabelle nicht auf der nächst niedrigeren Prioritätsstufe mit der Suche nach Übereinstimmungen fort.

Hinweis:
In diesem Beispiel wird zwar die Verwendung von Nachrichtenfilterprioritäten gezeigt, im Allgemeinen empfiehlt es sich jedoch, die Filter so zu entwerfen und zu konfigurieren, dass sie keine Prioritäten benötigen, um ordnungsgemäß zu funktionieren, weil dadurch eine höhere Leistung und Anwendbarkeit erzielt wird.

Der erste hinzuzufügende Filter ist der XPath-Filter, und seine Priorität ist auf 2 festgelegt. Dies ist der erste Nachrichtenfilter, der ausgeführt wird. Wenn er den benutzerdefinierten Header findet, wird die Nachricht unabhängig von den möglichen Ergebnissen der anderen Filter an den Rundungsrechnerendpunkt weitergeleitet.

Zwei Filter werden mit Priorität 1 hinzugefügt. Diese werden wiederum nur ausgeführt, wenn der XPath-Filter mit Priorität 2 für die Nachricht keine Übereinstimmung ergibt. Diese beiden Filter zeigen zwei verschiedene Möglichkeiten, um zu bestimmen, wo die Nachricht adressiert wurde, als sie angezeigt wurde. Da die beiden Filter effektiv überprüfen, ob die Nachricht an einem der beiden Endpunkte eingegangen ist, können sie mit derselben Prioritätsstufe ausgeführt werden, da sie nicht beide gleichzeitig true zurückgegeben.

Führen Sie schließlich die RoundRobin-Nachrichtenfilter auf der Prioritätsstufe 0 (der niedrigsten Priorität) aus. Da die Filter mit demselben Gruppennamen konfiguriert sind, ergibt immer nur einer eine Übereinstimmung. Da alle Nachrichten mit dem benutzerdefinierten Header und alle Nachrichten, die an die bestimmten virtualisierten Endpunkte adressiert sind, weitergeleitet wurden, werden nur die Nachrichten von RoundRobin-Nachrichtenfiltern verarbeitet, die an den Standardrouterendpunkt ohne den benutzerdefinierten Header adressiert waren. Da für diese Nachrichten bei jedem Aufruf ein Wechsel stattfindet, wird die Hälfte der Vorgänge an den regulären Rechnerendpunkt und die andere Hälfte an den Rundungsrechnerendpunkt geleitet.

So verwenden Sie dieses Beispiel

Öffnen Sie AdvancedFilters.sln in Visual Studio 2010.
Wählen Sie im Menü Ansicht die Option Projektmappen-Explorer aus, um Projektmappen-Explorer zu öffnen.
Drücken Sie F5 oder F6 in Visual Studio.
1. Wenn die notwendigen Projekte automatisch gestartet werden sollen, wenn Sie auf F5 drücken, klicken Sie mit der rechten Maustaste auf die Projektmappe, und wählen Sie Eigenschaften aus. Wählen Sie im linken Bereich unter Allgemeine Eigenschaften den Knoten Startprojekt aus. Aktivieren Sie das Optionsfeld Mehrere Startprojekte, und legen Sie für alle Projekte die Aktion Start fest.
2. Wenn Sie das Projekt mit F6 erstellen, müssen Sie die folgenden Anwendungen starten:
  1. Rechnerclient (./CalculatorClient/bin/client.exe)
  2. Rechnerdienst (./CalculatorService/bin/service.exe)
  3. Routingrechnerdienst (./RoundingCalcService/bin/service.exe)
  4. Routingdienst (./RoutingService/bin/RoutingService.exe)
Drücken Sie im Konsolenfenster des Rechnerclients die EINGABETASTE, um den Client zu starten. Der Client gibt eine Liste mit Zielendpunkten zur Auswahl zurück.
Wählen Sie einen Zielendpunkt aus, indem Sie den entsprechenden Buchstaben eingeben und die EINGABETASTE drücken.
Als Nächstes fordert Sie der Client auf, einzugeben, ob ein benutzerdefinierter Header hinzugefügt werden soll. Drücken Sie Y für Ja oder N für Nein, und drücken Sie dann die EINGABETASTE.
Abhängig von der getroffenen Auswahl werden unterschiedliche Ausgaben angezeigt.
1. Die folgende Ausgabe wird zurückgegeben, wenn Sie einen benutzerdefinierten Header zu den Nachrichten hinzugefügt haben.
```
Add(100,15.99) = 116
Subtract(145,76.54) = 68.5
Multiply(9,81.25) = 731.3
Divide(22,7) = 3.1
```
2. Die folgende Ausgabe wird zurückgegeben, wenn Sie den Rundungsrechnerendpunkt ohne benutzerdefinierten Header ausgewählt haben.
```
Add(100,15.99) = 116
Subtract(145,76.54) = 68.5
Multiply(9,81.25) = 731.3
Divide(22,7) = 3.1
```
3. Die folgende Ausgabe wird zurückgegeben, wenn Sie den regulären Rechnerendpunkt ohne benutzerdefinierten Header ausgewählt haben.
```
Add(100,15.99) = 115.99
Subtract(145,76.54) = 68. 46
Multiply(9,81.25) = 731.25
Divide(22,7) = 3.14285714285714
```
4. Die folgende Ausgabe wird zurückgegeben, wenn Sie den Standardrouterendpunkt ohne benutzerdefinierten Header ausgewählt haben.
```
Add(100,15.99) = 116
Subtract(145,76.54) = 68.46
Multiply(9,81.25) = 731.3
Divide(22,7) = 3.14285714285714
```
Vom Rechnerdienst und Rundungsrechnerdienst wird außerdem ein Protokoll der Vorgänge gedruckt, die in den jeweiligen Konsolenfenstern aufgerufen werden.
Geben Sie zum Beenden im Clientkonsolenfenster quit ein, und drücken Sie die EINGABETASTE.
Drücken Sie die EINGABETASTE in den Dienstkonsolenfenstern, um die Dienste zu beenden.

Konfigurierbar über Code oder App.config

Das Beispiel wird so konfiguriert geliefert, dass die Datei App.config das Verhalten des Routers definiert. Sie können außerdem den Namen der Datei RoutingService\App.config ändern, damit er nicht erkannt wird, und die Auskommentierung des Methodenaufrufs von ConfigureRouterViaCode() in RoutingService\routing.cs aufheben. Beide Methoden führen zum gleichen Routerverhalten.

Szenario

In diesem Beispiel wird der Router als inhaltsbasierter Router dargestellt, der ermöglicht, dass mehrere Typen oder Implementierungen von Diensten über einen Endpunkt verfügbar gemacht werden.

Reales Szenario

Contoso möchte sämtliche Dienste virtualisieren, um nur einen Endpunkt öffentlich verfügbar zu machen, über den Zugriff auf mehrere verschiedene Dienste gewährt wird. In diesem Fall werden die inhaltsbasierten Routingfunktionen des Routingdiensts verwendet, um zu bestimmen, wohin die eingehenden Anforderungen gesendet werden sollen.