Condividi tramite


Filtri

Il sistema di filtraggio di Windows Communication Foundation (WCF) è in grado di utilizzare filtri dichiarativi per individuare messaggi e prendere decisioni operative. È possibile utilizzare filtri per determinare come comportarsi con un messaggio, esaminando parte di esso. Un processo di accodamento, ad esempio, può utilizzare una query XPath 1.0 per controllare l'elemento prioritario di un'intestazione nota e determinare se spostare un messaggio all'inizio della coda.

Il sistema di filtraggio è composto di un insieme di classi che possono determinare in modo efficiente i filtri di un insieme di filtri che sono true per un particolare messaggio WCF.

Il sistema di filtraggio è un componente principale della messaggistica di WCF ed è progettato per essere estremamente veloce. Ogni implementazione di filtri è stata ottimizzata per un particolare tipo di corrispondenza con messaggi WCF.

Il sistema di filtraggio non è thread-safe. L'applicazione deve gestire qualsiasi semantica di blocco. Supporta, ad ogni modo, più reader e un solo writer.

Utilizzo di filtri

Il filtraggio viene eseguito dopo la ricezione di un messaggio e fa parte del processo di invio del messaggio al componente dell'applicazione corretto. La progettazione del sistema di filtraggio risponde ai requisiti di numerosi sottosistemi WCF, inclusi messaggistica, routing, protezione, gestione degli eventi e gestione del sistema.

Filtri

Il motore di filtraggio dispone di due componenti primari, filtri e tabelle dei filtri. Un filtro prende decisioni booleane su un messaggio in base alle condizioni logiche specificate dall'utente. I filtri implementano la classe MessageFilter.

I metodi Match vengono utilizzati per determinare se un messaggio soddisfa un filtro. Uno dei metodi controlla l'intestazione del messaggio, ma non può controllare il corpo del messaggio. L'altro metodo utilizza un buffer dei messaggi come parametro di input e può controllare il corpo del messaggio.

I filtri generalmente non vengono controllati individualmente ma come parte di una tabella dei filtri che è una classe generica creata dal metodo CreateFilterTable.

Ogni filtro è specifico per un particolare tipo di condizione booleana. Dopo aver creato un filtro, è impossibile modificare i criteri che utilizza. Per modificarli, creare un nuovo filtro ed eliminare quello esistente.

Filtri per azioni

ActionMessageFilter contiene un elenco di stringhe di azione. Se qualcuna delle azioni nell'elenco dei filtri corrisponde all'intestazione Action nel messaggio o nel buffer dei messaggi, il metodo Match restituisce true. Se l'elenco è vuoto, il filtro viene considerato a corrispondenza totale, dando luogo a una corrispondenza per qualsiasi messaggio o buffer dei messaggi e Match restituisce true. Se nessuna delle azioni nell'elenco dei filtri corrisponde all'intestazione Action nel messaggio o nel buffer dei messaggi, il metodo Match restituisce false. Se non c'è alcuna azione nel messaggio e l'elenco dei filtri non è vuoto, Match restituisce false.

Filtri per indirizzi endpoint

EndpointAddressMessageFilter filtra messaggi e buffer dei messaggi in base a un indirizzo endpoint, come rappresentato nell'insieme delle intestazioni. Affinché un messaggio superi tale filtro, devono essere soddisfatte le condizioni seguenti:

  • L'URI (Uniform Resource Identifier) dell'indirizzo del filtro deve essere lo stesso di quello presente nell'intestazione To del messaggio.
  • Ogni parametro dell'endpoint nell'indirizzo del filtro (insieme address.Headers) deve trovare un'intestazione nel messaggio sulla quale eseguire il mapping. La corrispondenza rimane impostata su true anche in presenza di intestazioni aggiuntive nel messaggio o nel buffer dei messaggi.

Filtri per indirizzi endpoint di prefisso

  1. Le funzioni PrefixEndpointAddressMessageFilter così come il filtro EndpointAddressMessageFilter escludono che vi possa essere corrispondenza con un prefisso dell'URI del messaggio. Un filtro che specifica, ad esempio, che l'indirizzo http://www.adatum.com corrisponde a messaggi indirizzati a http://www.adatum.com/userA.

Filtri per messaggi XPath

XPathMessageFilter utilizza un'espressione XPath per determinare se un documento XML contiene elementi specifici, attributi, testo o altri costrutti sintattici XML. Il filtro è ottimizzato per essere estremamente efficiente per un sottoinsieme esatto di XPath. XPath (XML Path Language) viene descritto in Specifica di W3C XML Path Language 1.0 (il contenuto potrebbe essere in inglese).

In genere, un'applicazione utilizza XPathMessageFilter in un endpoint per eseguire una query sul contenuto di un messaggio SOAP e quindi agisce appropriatamente in base ai risultati della query. Un processo di accodamento, ad esempio, può utilizzare una query XPath per controllare l'elemento prioritario di un'intestazione nota per decidere se spostare un messaggio all'inizio della coda.

Tabelle dei filtri

Le tabelle dei filtri vengono utilizzate per archiviare coppie di chiave-valore, dove un filtro corrisponde alla chiave e alcuni dati associati corrispondono al valore. I dati filtro possono essere utilizzati per indicare quali azioni intraprendere se un messaggio corrisponde a un filtro e il tipo di dati filtro è il parametro generico per la classe di tabella dei filtri. I dati filtro possono essere costituiti da regole di routing, stato di protezione della sessione, listener su un canale e così via. I dati possono essere utilizzati dove si rende necessario il controllo del flusso di dati.

Le tabelle dei filtri implementano l'interfaccia generica IMessageFilterTable.

Le tabelle dei filtri dispongono di diversi metodi in grado di creare una corrispondenza tra un messaggio e tutti i filtri nella tabella e di restituire un insieme non ordinato di dati o di filtri corrispondenti. Alcuni dei metodi di corrispondenza sono a corrispondenza multipla e restituiscono tutti gli elementi corrispondenti. Altri, che sono a corrispondenza singola, restituiscono un solo elemento e generano un'eccezione MultipleFilterMatchesException se vi è corrispondenza con più di un filtro.

Tabelle dei filtri per messaggi

MessageFilterTable è l'implementazione più generica di IMessageFilterTable. Nella tabella è possibile archiviare filtri di tutti i tipi.

È possibile assegnare priorità numeriche ai filtri, dove la priorità più elevata è indicata dal numero più elevato. Più tipi di filtri possono avere la stessa priorità. Un particolare tipo di filtro può apparire in più di un livello di priorità.

La corrispondenza viene eseguita iniziando dalla priorità più elevata e, dopo aver trovato i filtri corrispondenti con una priorità specificata, non verranno esaminati altri filtri con priorità più basse. Se, pertanto, si sta utilizzando un metodo di corrispondenza a filtro singolo e più di un filtro corrisponde a un messaggio, ma ognuno ha una priorità diversa, non verrà generata alcuna eccezione e verrà restituito il filtro con la priorità più elevata. Allo stesso modo, un metodo di corrispondenza a più filtri restituisce solo i filtri corrispondenti con la priorità più elevata.

Tabelle dei filtri per messaggi XPath

XPathMessageFilterTable è ottimizzato per filtri XPath dichiarativi, pertanto la chiave tabella è XPathMessageFilter.

La classe XPathMessageFilterTable ottimizza la corrispondenza per un sottoinsieme di XPath che tratta la maggior parte degli scenari di messaggistica e supporta inoltre la grammatica di XPath 1.0 completa. Sono stati ottimizzati algoritmi per una corrispondenza parallela efficiente.

In questa tabella esistono diversi metodi Match specializzati che operano su XPathNavigator e su SeekableXPathNavigator. SeekableXPathNavigator estende la classe XPathNavigator aggiungendo una proprietà CurrentPosition. Questa proprietà consente di salvare e caricare velocemente le posizioni all'interno del documento XML, senza dovere clonare il navigatore, occupando molta memoria necessaria a XPathNavigator per eseguire questa operazione. Il motore XPath di WCF deve registrare frequentemente la posizione del cursore durante l'esecuzione di query sui documenti XML, pertanto SeekableXPathNavigator rappresenta un'ottimizzazione importante per l'elaborazione del messaggio.

Scenari utente

È possibile utilizzare i filtri in qualsiasi momento per inviare un messaggio a moduli di elaborazione differenti in base ai dati contenuti nel messaggio. Due scenari tipici sono il routing di un messaggio basato sul codice di azione e il demultiplexing di un flusso di messaggi basato sull'indirizzo endpoint dei messaggi.

Routing

Il listener di un endpoint è in ascolto di messaggi che dispongono di uno o più codici di azione nell'intestazione SOAP del messaggio. L'implementazione avviene tramite la creazione di ActionMessageFilter con il passaggio al costruttore di una matrice che contiene i codici di azione. Questo filtro viene utilizzato per registrare in ListenerFactory, in tal modo solo i messaggi la cui azione corrisponde a una di quelle presenti nel filtro raggiungono quel particolare endpoint.

Demultiplexing

Quando più endpoint eseguono il fan-out dallo stesso ServiceListener dalla rete, l'unico modo per eseguire demultiplexing sui messaggi e per sapere se appartengono a un certo indirizzo endpoint è utilizzare EndpointAddressMessageFilter. In tal modo vengono selezionati i messaggi prossimi agli endpoint registrati eseguendo una ricerca sulle informazioni archiviate nelle intestazioni. In questi filtri, solo i messaggi che passano dispongono di tutte le intestazioni necessarie che corrispondono a entrambi:

  • L'URI in EndpointAddress.
  • Il resto dei parametri dell'endpoint in EndpointAddress come specificato in EndpointAddressMessageFilter.

Vedere anche

Altre risorse

Trasferimento dati e serializzazione