Vlastní upgrady streamů
Přenosy orientované na datové proudy, jako jsou TCP a pojmenované kanály, pracují s nepřetržitým proudem bajtů mezi klientem a serverem. Tento datový proud je realizován objektem Stream . V upgradu datového proudu chce klient přidat do zásobníku kanálu volitelnou vrstvu protokolu a požádá o to druhý konec komunikačního kanálu. Upgrade datového proudu spočívá v nahrazení původního Stream objektu upgradovaným objektem.
Můžete například vytvořit stream komprese přímo nad přenosovým proudem. V tomto případě je původní doprava Stream nahrazena jedním, který zabalí kompresi Stream kolem původní.
Můžete použít více upgradů datových proudů, přičemž každý z nich zabalí předchozí upgrade.
Jak fungují upgrady streamu
Proces upgradu streamu má čtyři komponenty.
Iniciátor streamu upgradu zahájí proces: za běhu může zahájit požadavek na druhý konec jeho připojení k upgradu přenosové vrstvy kanálu.
Akceptátor streamu upgradu provede upgrade: za běhu obdrží požadavek na upgrade z jiného počítače a pokud je to možné, přijme upgrade.
Zprostředkovatel upgradu vytvoří iniciátor v klientovi a acceptor na serveru.
Element vazby upgradu datového proudu se přidá do vazeb ve službě a klientovi a vytvoří zprostředkovatele za běhu.
Všimněte si, že v případě několika upgradů zapouzdřují iniciátor a akceptátor stavové počítače, které vynucují, které přechody upgradu jsou platné pro každou iniciaci.
Implementace upgradu streamu
Windows Communication Foundation (WCF) poskytuje čtyři abstract třídy, které můžete implementovat:
Pokud chcete implementovat vlastní upgrade streamu, postupujte následovně. Tento postup implementuje minimální proces upgradu datového proudu na klientských i serverových počítačích.
Vytvořte třídu, která implementuje StreamUpgradeInitiator.
Přepište metodu InitiateUpgrade , která se má provést v datovém proudu, který se má upgradovat, a vrátit upgradovaný stream. Tato metoda funguje synchronně; existují podobné metody, jak inicializovat upgrade asynchronně.
Přepište metodu GetNextUpgrade a zkontrolujte další upgrady.
Vytvořte třídu, která implementuje StreamUpgradeAcceptor.
Přepište metodu AcceptUpgrade , která se má provést v datovém proudu, který se má upgradovat, a vrátit upgradovaný stream. Tato metoda funguje synchronně; existují podobné metody, jak upgrade přijmout asynchronně.
Přepište metodu CanUpgrade , která určuje, jestli je požadovaný upgrade podporován tímto akceptátorem upgradu v tomto okamžiku v procesu upgradu.
Vytvořte třídu implements StreamUpgradeProvider. CreateUpgradeAcceptor Přepište a CreateUpgradeInitiator metody pro vrácení instancí akceptátoru a iniciátoru definovaného v krocích 2 a 1.
Vytvořte třídu, která implementuje StreamUpgradeBindingElement.
Přepište metodu BuildClientStreamUpgradeProvider na klientovi a metodu BuildServerStreamUpgradeProvider ve službě.
Přepsat metodu BuildChannelFactory na klientovi a metodu BuildChannelListener ve službě přidat element vazby upgradu do BindingParameters.
Přidejte nový element vazby upgradu datového proudu do vazeb na serveru a klientských počítačích.
Upgrady zabezpečení
Přidání upgradu zabezpečení je specializovaná verze obecného procesu upgradu streamu.
WCF již poskytuje dva prvky vazby pro upgrade zabezpečení datových proudů. Konfigurace zabezpečení na úrovni přenosu je zapouzdřena WindowsStreamSecurityBindingElement a SslStreamSecurityBindingElement kterou lze nakonfigurovat a přidat do vlastní vazby. Tyto prvky vazby rozšiřují třídu, která vytváří zprostředkovatele upgradu datového StreamUpgradeBindingElement proudu klienta a serveru. Tyto prvky vazby mají metody, které vytvářejí specializované třídy zprostředkovatele upgradu datového proudu zabezpečení, které nejsou public, takže pro tyto dva případy stačí jen přidat element vazby do vazby.
Pro scénáře zabezpečení, které nejsou splněny výše dvěma prvky vazby, jsou tři třídy související se abstract zabezpečením odvozeny od výše uvedeného iniciátoru, akceptátoru a základní třídy zprostředkovatele:
Proces implementace upgradu datového proudu zabezpečení je stejný jako předtím, s rozdílem, který byste odvozovali z těchto tří tříd. Přepište další vlastnosti v těchto třídách a zadejte informace o zabezpečení modulu runtime.
Více upgradů
Pokud chcete vytvořit další žádosti o upgrade, zopakujte výše uvedený proces: vytvořte další rozšíření StreamUpgradeProvider a prvky vazby. Přidejte do vazby prvky vazby. Další prvky vazby se zpracovávají postupně, počínaje prvním prvkem vazby přidaným do vazby. BuildChannelListener Každý BuildChannelFactory poskytovatel upgradu může určit, jak se má vrstvit na všech předem existujících parametrech vazby upgradu. Potom by měl nahradit existující parametr vazby upgradu novým parametrem vazby složeného upgradu.
Alternativně může jeden poskytovatel upgradu podporovat více upgradů. Můžete například chtít implementovat vlastního poskytovatele upgradu streamu, který podporuje zabezpečení i kompresi. Proveďte následující kroky:
Podtřída StreamSecurityUpgradeProvider pro zápis třídy zprostředkovatele, která vytvoří iniciátor a acceptor.
Podtřídu StreamSecurityUpgradeInitiator nezapomeňte přepsat metodu GetNextUpgrade tak, aby vracela typy obsahu pro stream komprese a zabezpečený datový proud v pořadí.
Podtřída StreamSecurityUpgradeAcceptor , která rozumí vlastním typům obsahu ve své CanUpgrade metodě.
Stream se upgraduje po každém volání GetNextUpgrade a CanUpgrade.