Sdílet prostřednictvím

<msmqIntegration>

  • Článek

Určuje přenos MSMQ pro vlastní vazbu.

<Konfigurace>
  <System.servicemodel>
    <Vazby>
      <vlastní vazby>
        <Vazba>
          <msmqIntegration>

Syntax

<msmqIntegration customDeadLetterQueue="Uri"
                 deadLetterQueue="Custom/None/System"
                 durable="Boolean"
                 exactlyOnce="Boolean"
                 manualAddressing="Boolean"
                 maxBufferPoolSize="Integer"
                 maxImmediateRetries="Integer"
                 maxReceivedMessageSize="Integer"
                 maxRetryCycles="Integer"
                 rejectAfterLastRetry="Boolean"
                 retryCycleDelay="TimeSpan"
                 serializationFormat="XML/Binary/ActiveX/ByteArray/Stream"
                 timeToLive="TimeSpan"
                 useSourceJournal="Boolean"
                 useMsmqTracing="Boolean">
  <msmqTransportSecurity>
  </msmqTransportSecurity>
</msmqIntegration>

Typ

Type

Atributy a elementy

Následující části popisují atributy, podřízené prvky a nadřazené prvky.

Atributy

Atribut Popis
vlastníDeadLetterQueue Identifikátor URI, který označuje umístění fronty nedoručených zpráv pro jednotlivé aplikace, kam se přenesou zprávy, jejichž platnost vypršela nebo se nepodařilo doručit do aplikace.

Pro zprávy, které vyžadují záruky ExactlyOnce (tj. exactlyOnce je nastavena na true), je tento atribut výchozí pro frontu nedoručených zpráv v rámci celého systému v MSMQ.

Pro zprávy, které nevyžadují žádné záruky (to znamená, exactlyOnce že je nastavená na false), je tento atribut ve výchozím nastavení nastavený na null.

Hodnota musí používat schéma net.msmq. Výchozí formát je null.

Pokud deadLetterQueue je nastavená hodnota nebo NoneSystem, musí být tento atribut nastaven na nullhodnotu . Pokud tento atribut není null, deadLetterQueue musí být nastavený na Custom.
Deadletterqueue Určuje typ fronty nedoručených zpráv, která se má použít.

Mezi platné hodnoty patří:

– Vlastní: Vlastní fronta mrtvých zpráv.
– Žádné: Nebude použita žádná fronta deadletterů.
- Systém: Použijte systémovou frontu mrtvých zpráv.

Tento atribut je typu DeadLetterQueue.
Trvanlivé Logická hodnota, která určuje, zda zprávy zpracovávané touto vazbou jsou trvalé nebo nestálé. Výchozí formát je true.

Odolná zpráva přežije chybové ukončení správce fronty, zatímco nestálá zpráva ne. Nestálé zprávy jsou užitečné, když aplikace vyžadují nižší latenci a můžou tolerovat občasné ztráty zpráv.

Pokud exactlyOnce je nastavená hodnota true, musí být zprávy odolné.
Exactlyonce Logická hodnota, která určuje, jestli zprávy zpracované touto vazbou budou přijaty přesně jednou. Výchozí formát je true.

Zpráva může být odeslána s zárukami nebo bez. Záruka umožňuje aplikaci zajistit, že odeslaná zpráva dorazila do fronty přijímajících zpráv, nebo pokud ne, aplikace to může zjistit čtením fronty nedoručených zpráv.

exactlyOnce, pokud je nastavená na truehodnotu , znamená to, že služba MSMQ zajistí, že se odeslaná zpráva doručí do fronty přijímajících zpráv pouze jednou a pouze jednou. Pokud se doručení nezdaří, odešle se zpráva do fronty nedoručených zpráv.

Zprávy odeslané nastavením exactlyOnce na true musí být odeslány pouze do transakční fronty.
ruční adresování Logická hodnota, která uživateli umožňuje převzít kontrolu nad adresování zpráv. Tato vlastnost se obvykle používá ve scénářích směrovačů, kdy aplikace určí, na který z několika cílů se má zpráva odeslat.

Pokud je nastavená na true, kanál předpokládá, že zpráva už byla vyřešena, a nepřidá k ní žádné další informace. Uživatel pak může adresovat každou zprávu zvlášť.

Pokud je nastavená hodnota false, výchozí mechanismus adresování WCF (Windows Communication Foundation) automaticky vytvoří adresy pro všechny zprávy.

Výchozí formát je false.
Maxbufferpoolsize Kladné celé číslo, které určuje maximální velikost fondu vyrovnávacích pamětí. Výchozí hodnota je 524288.

Mnoho částí WCF používá vyrovnávací paměti. Vytváření a ničení vyrovnávacích pamětí při každém jejich použití je nákladné a uvolňování paměti pro vyrovnávací paměti je také nákladné. Pomocí fondů vyrovnávacích pamětí můžete z fondu vzít vyrovnávací paměť, použít ji a po dokončení ji vrátit do fondu. Tím se vyhnete režijní režii při vytváření a ničení vyrovnávacích pamětí.
maxImmediateRetries Celé číslo, které určuje maximální počet okamžitých opakovaných pokusů o zprávu, která je načtena z fronty aplikace. Výchozí hodnota je 5.

Pokud dojde k pokusu o maximální počet okamžitých opakování zprávy a aplikace zprávu nespotřebuje, odešle se zpráva do fronty opakování k opakování v určitém časovém okamžiku. Pokud nejsou zadány žádné cykly opakování, jsou zprávy buď odeslány do fronty zpráv s jedem, nebo je odesílateli odesláno záporné potvrzení.
Maxreceivedmessagesize Kladné celé číslo, které určuje maximální velikost zprávy v bajtech včetně záhlaví. Odesílatel zprávy obdrží chybu SOAP, pokud je zpráva pro příjemce příliš velká. Příjemce zprávu zahodí a vytvoří záznam události v protokolu trasování. Výchozí hodnota je 65536.
maxRetryCycles Celé číslo, které určuje maximální počet cyklů opakování pokusu o doručení zpráv do přijímající aplikace. Výchozí formát je MaxValue.

Jeden cyklus opakování se pokusí doručit zprávu do aplikace zadaným počtem pokusů. Počet provedených pokusů je nastaven atributem .maxImmediateRetries Pokud aplikace zprávu po vyčerpání pokusů o doručení nespotřebuje, zpráva se odešle do fronty opakování. Následné cykly opakování se skládají ze zprávy, která se vrátí z fronty opakování do fronty aplikace, aby se po uplynutí zpoždění určeného retryCycleDelay atributem pokusila aplikaci doručit znovu. Atribut maxRetryCycles určuje počet cyklů opakování, které aplikace používá k pokusu o doručení zprávy.
rejectAfterLastRetry Logická hodnota, která určuje, jaká akce se má provést u zprávy, u které se nepodařilo doručit po maximálním počtu pokusů o opakování.

true znamená, že odesílateli je vráceno záporné potvrzení a zpráva je zahozena; false znamená, že zpráva je odeslána do fronty zpráv s jedem. Výchozí formát je false.

Pokud je falsehodnota , přijímající aplikace může číst frontu zpráv s jedem a zpracovávat jedovaté zprávy (to znamená zprávy, u kterých se doručení nezdařilo).

MsMQ 3.0 nepodporuje vrácení záporného potvrzení odesílateli, takže tento atribut bude ignorován v MSMQ 3.0.
retryCycleDelay A TimeSpan určující časové zpoždění mezi cykly opakování při pokusu o doručení zprávy, která nemohla být doručena okamžitě. Výchozí hodnota je 00:10:00.

Jeden cyklus opakování se pokusí doručit zprávu do přijímající aplikace zadaným počtem pokusů. Počet provedených pokusů je určen atributem maxImmediateRetries . Pokud aplikace zprávu po zadaném počtu okamžitých opakování nespotřebuje, zpráva se odešle do fronty opakování. Následné cykly opakování se skládají ze zprávy, která se vrátí z fronty opakování do fronty aplikace, aby se po uplynutí zpoždění určeného retryCycleDelay atributem pokusila aplikaci doručit znovu. Počet cyklů opakování je určen atributem maxRetryCycles .
Serializationformat Určuje formátovací modul, který se používá k serializaci objektů odesílaných jako součást zprávy MSMQ. Platné hodnoty jsou:

- ActiveX: Formátovací modul ActiveX se používá při serializaci objektů COM.
- Binární: Serializuje objekt na binární paket.
- ByteArray: Serializuje objekt do pole bajtů.
– Stream: Serializuje objekt na datový proud.
- Xml: Serializuje objekt na paket XML. Výchozí hodnota je XML.

Tento atribut je typu MsmqMessageSerializationFormat.
timeToLive Určuje TimeSpan , jak dlouho jsou zprávy platné před vypršením jejich platnosti a jsou vloženy do fronty nedoručených zpráv. Výchozí hodnota je 1,00:00:00, což znamená 1 den.

Tento atribut je nastavený tak, aby se zprávy citlivé na čas nestaly zastaralými před zpracováním přijímajícími aplikacemi. Zpráva ve frontě, která není spotřebována přijímající aplikací v zadaném časovém intervalu, má za to, že vypršela. Zprávy s vypršenou platností se odesílají do speciální fronty označované jako fronta nedoručených zpráv. Umístění fronty nedoručených zpráv je nastaveno atributem customDeadLetterQueue nebo na odpovídající výchozí hodnotu na základě záruk.
useMsmqTracing Logická hodnota, která určuje, zda zprávy zpracované touto vazbou mají být trasovány. Výchozí formát je false.

Pokud je trasování povoleno, sestavy zprávy jsou vytvořeny a odeslány do fronty sestav pokaždé, když zpráva opustí nebo přijde do počítače služby Řízení front zpráv.
useSourceJournal Logická hodnota, která určuje, zda kopie zpráv zpracovaných touto vazbou mají být uloženy ve frontě zdrojového deníku. Výchozí formát je false.

Aplikace ve frontě, které chtějí uchovávat záznamy zpráv, které opustily odchozí frontu počítače, mohou zprávy zkopírovat do fronty deníku. Jakmile zpráva opustí odchozí frontu a je přijato potvrzení, že zpráva byla přijata v cílovém počítači, je kopie zprávy uložena ve frontě systémového deníku odesílajícího počítače.

Podřízené elementy

Element Popis
msmqTransportSecurity Určuje nastavení zabezpečení přenosu pro tuto vazbu. Tento prvek je typu MsmqTransportSecurityElement.

Nadřazené elementy

Element Popis
<Vazba> Definuje všechny možnosti vazby vlastní vazby.

Viz také