http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/java-broker/book/index.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/java-broker/book/index.html b/content/releases/qpid-0.26/java-broker/book/index.html deleted file mode 100644 index b65dc93..0000000 --- a/content/releases/qpid-0.26/java-broker/book/index.html +++ /dev/null @@ -1,153 +0,0 @@ -<!DOCTYPE html> -<!-- - - - - Licensed to the Apache Software Foundation (ASF) under one - - or more contributor license agreements. See the NOTICE file - - distributed with this work for additional information - - regarding copyright ownership. The ASF licenses this file - - to you under the Apache License, Version 2.0 (the - - "License"); you may not use this file except in compliance - - with the License. You may obtain a copy of the License at - - - - http://www.apache.org/licenses/LICENSE-2.0 - - - - Unless required by applicable law or agreed to in writing, - - software distributed under the License is distributed on an - - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - - KIND, either express or implied. See the License for the - - specific language governing permissions and limitations - - under the License. - - ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> - <head> - <title>AMQP Messaging Broker (Java) - Apache Qpid™</title> - <meta http-equiv="X-UA-Compatible" content="IE=edge"/> - <meta name="viewport" content="width=device-width, initial-scale=1.0"/> - <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> - <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> - <script type="text/javascript">var _deferredFunctions = [];</script> - <script type="text/javascript" src="/deferred.js" defer="defer"></script> - <!--[if lte IE 8]> - <link rel="stylesheet" href="/ie.css" type="text/css"/> - <script type="text/javascript" src="/html5shiv.js"></script> - <![endif]--> - - <!-- Redirects for `go get` and godoc.org --> - <meta name="go-import" - content="qpid.apache.org git https://git-wip-us.apache.org/repos/asf/qpid-proton.git"/> - <meta name="go-source" - content="qpid.apache.org -https://github.com/apache/qpid-proton/blob/go1/README.md -https://github.com/apache/qpid-proton/tree/go1{/dir} -https://github.com/apache/qpid-proton/blob/go1{/dir}/{file}#L{line}"/> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="" alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="" alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/discussion.html">Discussion</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <div class="flex"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Messaging APIs</h3> - - <ul> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/components/jms/index.html">Qpid JMS</a></li> - <li><a href="/components/messaging-api/index.html">Qpid Messaging API</a></li> - </ul> - </section> - - <section> - <h3>Servers and tools</h3> - - <ul> - <li><a href="/components/java-broker/index.html">Broker for Java</a></li> - <li><a href="/components/cpp-broker/index.html">C++ broker</a></li> - <li><a href="/components/dispatch-router/index.html">Dispatch router</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/dashboard.html">Dashboard</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/Index">Wiki</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - </div> - </div> - - <div id="-search" class="panel" style="display: none;"> - <form action="http://www.google.com/search" method="get"> - <input type="hidden" name="sitesearch" value="qpid.apache.org"/> - <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> - <button type="submit">Search</button> - <a href="/search.html">More ways to search</a> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/index.html">Home</a></li><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li>AMQP Messaging Broker (Java)</li></ul> - - <div id="-middle-content"> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">AMQP Messaging Broker (Java)</th></tr><tr><td align="left" width="20%"> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="Java-Broker-Introduction.html">Next</a></td></tr></table><hr /></div><div class="book"><div class="titlepage"><div><div><h1 class="title"><a id="idm140218895509184"></a>AMQP Messaging Broker (Java)</h1></div></div><hr /></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="chapter"><a href="Java-Broker-Introduction.html">1. Introduction</a></span></dt><dt><span class="chapter"><a href="Java-Broker-Installation.html">2. Installation</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Installation.html#Java-Broker-Installation-Introduction">2.1. Introduction</a></span></dt><dt><span class="section"><a href="Jav a-Broker-Installation-Prerequistes.html">2.2. Prerequisites</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Installation-Prerequistes.html#Java-Broker-Installation-Prerequistes-Java">2.2.1. Java Platform</a></span></dt><dt><span class="section"><a href="Java-Broker-Installation-Prerequistes.html#Java-Broker-Installation-Prerequistes-Disk">2.2.2. Disk</a></span></dt><dt><span class="section"><a href="Java-Broker-Installation-Prerequistes.html#Java-Broker-Installation-Prerequistes-Memory">2.2.3. Memory</a></span></dt><dt><span class="section"><a href="Java-Broker-Installation-Prerequistes.html#Java-Broker-Installation-Prerequistes-OperatingSystemAccount">2.2.4. Operating System Account</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Installation-Download.html">2.3. Download</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Installation-Download.html#Java-Broker-Installation-Download-Release">2.3.1. Broker Release</a></s pan></dt><dt><span class="section"><a href="Java-Broker-Installation-Download.html#Java-Broker-Installation-Download-OptionalDependencies">2.3.2. Optional Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Installation-InstallationWindows.html">2.4. Installation on Windows</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Installation-InstallationWindows.html#Java-Broker-Installation-InstallationWindows-SettingQPIDWORK">2.4.1. Setting the working directory</a></span></dt><dt><span class="section"><a href="Java-Broker-Installation-InstallationWindows.html#Java-Broker-Installation-InstallationWindows-OptionalDependencies">2.4.2. Optional Dependencies</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Installation-InstallationUnix.html">2.5. Installation on UNIX platforms</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Installation-InstallationUnix.html#Java-Broker-Installation-Installation Unix-SettingQPIDWORK">2.5.1. Setting the working directory</a></span></dt><dt><span class="section"><a href="Java-Broker-Installation-InstallationUnix.html#Java-Broker-Installation-InstallationUnix-OptionalDependencies">2.5.2. Optional Dependencies</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Java-Broker-Getting-Started.html">3. Getting Started</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Getting-Started.html#Java-Broker-Getting-Started-Introduction">3.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Getting-Started-Starting-Stopping-Windows.html">3.2. Starting/Stopping the broker on Windows</a></span></dt><dt><span class="section"><a href="Java-Broker-Getting-Started-Starting-Stopping-Unix.html">3.3. Starting/Stopping the broker on Unix</a></span></dt><dt><span class="section"><a href="Java-Broker-Getting-Started-LogFile.html">3.4. Log file</a></span></dt><dt><span class="section"><a href="Java-Broker-Ge tting-Started-CommandLine.html">3.5. Using the command line</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Concepts.html">4. Concepts</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Concepts.html#Java-Broker-Concepts-Broker">4.1. Broker</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Virtual-Hosts.html">4.2. Virtual Hosts</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Exchanges.html">4.3. Exchanges</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-Predeclared">4.3.1. Predeclared Exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-Types">4.3.2. Exchange Types</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-BindingArguments">4.3.3. Binding Arguments</a></span></dt><dt><span cla ss="section"><a href="Java-Broker-Concepts-Exchanges.html#Java-Broker-Concepts-Exchanges-UnroutableMessage">4.3.4. Unrouteable Messages</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Concepts-Queues.html">4.4. Queues</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Ports.html">4.5. Ports</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Authentication-Providers.html">4.6. Authentication Providers</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Other-Services.html">4.7. Other Services</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Concepts-Other-Services.html#Java-Broker-Concepts-Access-Control-Providers">4.7.1. Access Control Providers</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Other-Services.html#Java-Broker-Concepts-Group-Providers">4.7.2. Group Providers</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Other-Services.h tml#Java-Broker-Concepts-Keystores">4.7.3. Keystores</a></span></dt><dt><span class="section"><a href="Java-Broker-Concepts-Other-Services.html#Java-Broker-Concepts-Truststores">4.7.4. Truststores</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Java-Broker-Configuring-And-Managing.html">5. Configuring And Managing</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store">5.1. Broker Configuration Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Introduction">5.1.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Location">5.1.2. Configuration Store Location</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Manag ing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Initial-Config-Location">5.1.3. 'Initial Configuration' Location</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Create-Initial-Config">5.1.4. Creating an 'Initial Configuration' JSON File</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Overwrite-Config-Store">5.1.5. Overwriting An Existing Configuration Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Type">5.1.6. Configuration Store Type</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Store-Configuration-Properties">5.1.7. Customising Configuration using Configuration Pr operties</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Configuring-And-Managing-Configuration-Initial-Config-Example">5.1.8. Example of JSON 'Initial Configuration'</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing.html#Java-Broker-Attributes-Configuring">5.1.9. Configuring Broker Attributes</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html">5.2. HTTP Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-HTTP-Management-Introduction">5.2.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-Web-Console">5.2.2. Web Management Console</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And- Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-HTTP-Management-Plugin-Configuration">5.2.3. HTTP Management Plugin Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#Java-Broker-Configuring-And-Managing-REST-API">5.2.4. REST API</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX-Management.html">5.3. JMX Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX-Management.html#Java-Broker-Configuring-And-Managing-JMX-Management-Introduction">5.3.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-JMX-Management.html#Java-Broker-Configuring-And-Managing-JMX-Management-Plugin-Configuration">5.3.2. JMX Management Plugin Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Configuring-And-Managing-Other-Tooling.htm l">5.4. Other Tooling</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Ports.html">6. Broker Ports</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Ports.html#Java-Broker-Ports-Configuring">6.1. Configuring Broker Ports</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Virtual-Hosts.html">7. Virtual Hosts</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Virtual-Hosts.html#Java-Broker-Virtual-Hosts-Configuring-Managing">7.1. Configuring And Managing</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Exchanges.html">8. Exchanges</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Exchanges.html#Java-Broker-Exchanges-Configuring">8.1. Configuring Virtual Host Exchanges</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Queues.html">9. Queues</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues- OtherTypes">9.1. Queue Types</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Introduction">9.1.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Priority">9.1.2. Priority Queues</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Sorted">9.1.3. Sorted Queues</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-LVQ">9.1.4. Last Value Queues (LVQ)</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Create">9.1.5. Creating a Priority, Sorted or LVQ Queue</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-Binding">9.1.6. Binding queues to exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes- Message-Grouping">9.1.7. - Messaging Grouping - </a></span></dt><dt><span class="section"><a href="Java-Broker-Queues.html#Java-Broker-Queues-OtherTypes-SetLowPrefetch">9.1.8. Using low pre-fetch with special queue types</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Java-Broker-Stores.html">10. Virtual Host Message Stores</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores.html#Java-Broker-Stores-Memory-Store">10.1. Memory Message Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-Derby-Store.html">10.2. Derby Message Store</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-SQL-Store.html">10.3. SQL Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-SQL-Store.html#Java-Broker-Stores-JDBC-Store-Driver">10.3.1. JDBC driver</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html">10.4. BDB Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Ja va-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Download">10.4.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store.html#Java-Broker-Stores-BDB-Store-BDBJE-Installation">10.4.2. Oracle BDB JE jar installation</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html">10.5. High Availability BDB Message Store</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Download">10.5.1. Oracle BDB JE download</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-BDBJE-Installation">10.5.2. Oracle BDB JE jar installation</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-HA-BDB-Store.html#Java-Broker-Stores-HA-BDB-Store-Configuration">10.5.3. Configuration</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href= "Java-Broker-Security.html">11. Security</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Authentication-Providers">11.1. Authentication Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-LDAP-Provider">11.1.1. Simple LDAP Authentication Provider</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Kerberos-Provider">11.1.2. Kerberos</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-External-Provider">11.1.3. External (SSL Client Certificates)</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-Anonymous-Provider">11.1.4. Anonymous</a></span></dt><dt><span class="section"><a href="Java-Broker-Security.html#Java-Broker-Security-PlainPasswordFile-Provider">11.1.5. Plain Password File</a></span></dt><dt><span class="section"><a href=" Java-Broker-Security.html#Java-Broker-Security-Base64MD5PasswordFile-Provider">11.1.6. Base64MD5 Password File</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-Group-Providers.html">11.2. Group Providers</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-Group-Providers.html#File-Group-Manager">11.2.1. GroupFile Provider</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-ACLs.html">11.3. Access Control Lists</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WriteACL">11.3.1. - Writing .acl files - </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-Syntax">11.3.2. - Syntax - </a></span></dt><dt><span class="section"><a href="Java-Broker-Security-ACLs.html#Java-Broker-Security-ACLs-WorkedExamples">11.3.3. - Worked Examples - </a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Security-SSL.html">11.4. SSL</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Security-SSL.html#Java-Broker-SSL-Keystore">11.4.1. Keystore Configuration</a></span></dt><dt><span class="section"><a href="Java-Broker-Security-SSL.html#SSL-Truststore-ClientCertificate">11.4.2. Truststore / Client Certificate Authentication</a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Java-Broker-Runtime.html">12. Runtime</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime.html#Java-Broker-Runtime-Log-Files">12.1. Log Files</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Alerts.html">12.2. Alerts</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Disk-Space-Management.html">12.3. Disk Space Management</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Disk-Space-Management.html#Qpid-Produce r-Flow-Control">12.3.1. Producer Flow Control</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html">12.4. Producer Transaction Timeout</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-GeneralInformation">12.4.1. General Information</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Purpose">12.4.2. Purpose</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Scope">12.4.3. Scope</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Effect">12.4.4. Effect</a></span></dt><dt><span class="section"><a href="Java-Broker-Ru ntime-Producer-Transaction-Timeout.html#Java-Broker-Runtime-Producer-Transaction-Timeout-Configuration">12.4.5. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html">12.5. Handing Undeliverable Messages</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Introduction">12.5.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Maximum-Delivery-Count">12.5.2. Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliverable-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Dead-Letter-Queues">12.5.3. Dead Letter Queues (DLQ)</a></span></dt><dt><span class="section"><a href="Java-Broker-Runtime-Handling-Undeliver able-Messages.html#Java-Broker-Runtime-Handling-Undeliverable-Messages-Configuration">12.5.4. Configuration</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html">12.6. Closing client connections on unroutable mandatory messages</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html#Java-Broker-Close-Connection-When-No-Route-Summary">12.6.1. Summary</a></span></dt><dt><span class="section"><a href="Java-Broker-Close-Connection-When-No-Route.html#Java-Broker-Close-Connection-When-No-Route-Configuration">12.6.2. Configuring <span class="emphasis"><em>closeWhenNoRoute</em></span></a></span></dt></dl></dd></dl></dd><dt><span class="chapter"><a href="Java-Broker-High-Availability.html">13. High Availability</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability.html#Java-Broker-High-Availability-GeneralIntroduction">13.1. General Introduction</a></span ></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-OfferingsOfJavaBroker.html">13.2. HA >offerings of the Java Broker</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-TwoNodeCluster.html">13.3. Two Node >Cluster</a></span></dt><dd><dl><dt><span class="section"><a >href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886968336">13.3.1. > Overview</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886785808">13.3.2. > Depictions of cluster operation</a></span></dt></dl></dd><dt><span >class="section"><a >href="Java-Broker-High-Availability-MultiNodeCluster.html">13.4. Multi Node >Cluster</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-Configuration.html">13.5. Configuring a >Virtual Host to be a node</a></span></dt><dd><dl><dt><span class="section"><a >href="Java-Broker-High-Availability-Configuration.html#Java-Broker-High-Availability-Configurat ion_BDBEnvVars">13.5.1. Passing BDB environment and replication configuration options</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html">13.6. Durability Guarantees</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_BDBControls">13.6.1. BDB Durability Controls</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_CoalescingSync">13.6.2. Coalescing-sync</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Default">13.6.3. Default</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DurabilityGuarantee.html#Java-Broker-High-Availability-DurabilityGuarantee_Examples">13.6.4. Examples</a ></span></dt></dl></dd><dt><span class="section"><a >href="Java-Broker-High-Availability-ClientFailover.html">13.7. Client >failover configuration</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-JMXAPI.html">13.8. Qpid JMX API for >HA</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-Monitoring-cluster.html">13.9. Monitoring >cluster</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-DiskSpace.html">13.10. Disk space >requirements</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-Network-Requirements.html">13.11. Network >Requirements</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-Security.html">13.12. >Security</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-Backup.html">13.13. >Backups</a></span></dt><dt><span class="section"><a >href="Java-Broker-High-Availability-MigrationFromNonHA.html">13.14. Migration of a non-HA store to HA</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-DisasterRecovery.html">13.15. Disaster Recovery</a></span></dt><dt><span class="section"><a href="Java-Broker-High-Availability-Performance.html">13.16. Performance</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html">14. Virtual Host XML configuration file</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File.html#Java-Broker-Virtual-Hosts-Configuration-File-Introduction">14.1. Introduction</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Hosts-Configuration-File-ACL.html">14.2. Configuring ACL</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-Memory-Store-Configuration.html">14.3. Configuring MemoryMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store-Configuration.html">14.4. Configuring BDBMessa geStore</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Stores-BDB-Store-Configuration.html#Java-Broker-Stores-BDB-Store-Configuration_BDBEnvVars">14.4.1. Passing BDB environment configuration options</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Stores-BDBHA-Store-Configuration.html">14.5. Configuring BDBHAMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-Derby-Store-Configuration.html">14.6. Configuring DerbyMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Stores-JDBC-Store-Configuration.html">14.7. Configuring JDBCMessageStore</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configuration-Exchange.html">14.8. Configuring Exchanges</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html">14.9. Configuring Queues</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html #Java-Broker-Queues-OtherTypes-CreateUsingConfig-Simple">14.9.1. Simple</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-Priority">14.9.2. Priority</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-Sorted">14.9.3. Sorted</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Queues-OtherTypes-CreateUsingConfig-LVQ">14.9.4. LVQ</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Declare-Queues.html#Java-Broker-Virtual-Host-Configuring-Queue-With-Arguments">14.9.5. Configuring queue with arguments</a></span></dt></dl></dd><dt><span class="section"><a href="Java-Broker-Virtual-Host-Binding-Queue.html">14.10. Queue Binding</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configure-Flow-Control.html">14.1 1. Configuring of Producer Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configure-Disk-Quotas.html">14.12. Configuring of Disk Quota-based Flow Control</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html">14.13. Configuring Transaction Timeouts</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configuring-DLQ.html">14.14. Configuring DLQs/Maximum Delivery Count</a></span></dt><dt><span class="section"><a href="Java-Broker-Virtual-Host-Configuration-File-Example.html">14.15. An example of virtual host configuration file</a></span></dt></dl></dd><dt><span class="chapter"><a href="Java-Broker-Miscellaneous.html">15. Miscellaneous</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification">15.1. JVM Installation verification</a></span></dt><dd><dl><dt><span class="section"><a href="Java-Br oker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification-Windows">15.1.1. Verify JVM on Windows</a></span></dt><dt><span class="section"><a href="Java-Broker-Miscellaneous.html#Java-Broker-Miscellaneous-JVM-Verification-Unix">15.1.2. Verify JVM on Unix</a></span></dt></dl></dd></dl></dd></dl></div><div class="list-of-figures"><p><strong>List of Figures</strong></p><dl><dt>4.1. <a href="Java-Broker-Concepts.html#idm140218887705536">Broker Model</a></dt><dt>4.2. <a href="Java-Broker-Concepts-Virtual-Hosts.html#idm140218887695904">Virtual Host Model</a></dt><dt>4.3. <a href="Java-Broker-Concepts-Exchanges.html#idm140218887586960">Direct exchange</a></dt><dt>4.4. <a href="Java-Broker-Concepts-Exchanges.html#idm140218887575664">Topic exchange - exact match on topic name</a></dt><dt>4.5. <a href="Java-Broker-Concepts-Exchanges.html#idm140218887571168">Topic exchange - matching on hierarchical topic patterns</a></dt><dt>4.6. <a href="Java-Broker-Concepts-Exchanges.html#idm1402188 87562192">Topic exchange - matching on JMS message selector</a></dt><dt>4.7. <a href="Java-Broker-Concepts-Exchanges.html#idm140218887550048">Fanout exchange</a></dt><dt>13.1. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886784272">Key for figures</a></dt><dt>13.2. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886778432">Normal operation of a two-node cluster</a></dt><dt>13.3. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886369904">Failure of master and recovery sequence</a></dt><dt>13.4. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886356864">Failure of replica and subsequent recovery sequence</a></dt><dt>13.5. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886342880">Partition of the network separating master and replica</a></dt><dt>13.6. <a href="Java-Broker-High-Availability-TwoNodeCluster.html#idm140218886328560">Split Brain</a></dt><dt>13.7. <a href="Java-Broker-High -Availability-JMXAPI.html#idm140218886203216">BDBHAMessageStore view from jconsole.</a></dt><dt>13.8. <a href="Java-Broker-High-Availability-Performance.html#idm140218886060608">Test results</a></dt></dl></div><div class="list-of-tables"><p><strong>List of Tables</strong></p><dl><dt>5.1. <a href="Java-Broker-Configuring-And-Managing.html#idm140218887453104">Base Configuration Properties</a></dt><dt>5.2. <a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#idm140218887297152">Rest services</a></dt><dt>9.1. <a href="Java-Broker-Queues.html#idm140218887416528">Queue-declare arguments understood for priority, sorted and LVQ queues</a></dt><dt>9.2. <a href="Java-Broker-Queues.html#idm140218887318048">Queue Declare Message Group Configuration Arguments</a></dt><dt>11.1. <a href="Java-Broker-Security-ACLs.html#table-Java-Broker-Security-ACLs-Syntax_permissions">List of ACL permission</a></dt><dt>11.2. <a href="Java-Broker-Security-ACLs.html#table-Java-Broker-Security-ACLs-Syn tax_actions">List of ACL actions</a></dt><dt>11.3. <a href="Java-Broker-Security-ACLs.html#table-Java-Broker-Security-ACLs-Syntax_objects">List of ACL objects</a></dt><dt>11.4. <a href="Java-Broker-Security-ACLs.html#table-Java-Broker-Security-ACLs-Syntax_properties">List of ACL properties</a></dt><dt>11.5. <a href="Java-Broker-Security-ACLs.html#table-Java-Broker-Security-ACLs-Syntax_javacomponents">List of ACL rules</a></dt><dt>13.1. <a href="Java-Broker-High-Availability-DurabilityGuarantee.html#idm140218886268976">Effect of different durability guarantees</a></dt><dt>13.2. <a href="Java-Broker-High-Availability-JMXAPI.html#idm140218886242832">Mbean <code class="classname">BDBHAMessageStore</code> attributes</a></dt><dt>13.3. <a href="Java-Broker-High-Availability-JMXAPI.html#idm140218886217264">Mbean <code class="classname">BDBHAMessageStore</code> operations</a></dt><dt>13.4. <a href="Java-Broker-High-Availability-Performance.html#idm140218886120960">Number of producers/consume rs in performance tests</a></dt><dt>13.5. <a href="Java-Broker-High-Availability-Performance.html#idm140218886091936">Performance Comparison</a></dt></dl></div><div class="list-of-examples"><p><strong>List of Examples</strong></p><dl><dt>5.1. <a href="Java-Broker-Configuring-And-Managing.html#idm140218887339232">JSON 'Initial configuration' File</a></dt><dt>5.2. <a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#idm140218887206976">Examples of queue creation using curl (authenticating as user admin):</a></dt><dt>5.3. <a href="Java-Broker-Configuring-And-Managing-HTTP-Management.html#idm140218887205456">Example of binding a queue to an exchange using curl</a></dt><dt>9.1. <a href="Java-Broker-Queues.html#idm140218887428752">Creation of an LVQ using the Qpid extension to JMS</a></dt><dt>9.2. <a href="Java-Broker-Queues.html#idm140218887430448">Creation of a sorted queue using JMX</a></dt><dt>9.3. <a href="Java-Broker-Queues.html#idm140218887613904">Binding a queue usin g JMS</a></dt><dt>9.4. <a href="Java-Broker-Queues.html#idm140218887616208">Binding a queue using JMX</a></dt><dt>12.1. <a href="Java-Broker-Close-Connection-When-No-Route.html#idm140218886789520">Disable feature to close connection on unroutable messages with client URL</a></dt><dt>13.1. <a href="Java-Broker-High-Availability-Configuration.html#idm140218886320112">Configuring a VirtualHost to use the BDBHAMessageStore</a></dt><dt>13.2. <a href="Java-Broker-High-Availability-ClientFailover.html#idm140218886247968">Example of connection URL for the HA Cluster</a></dt><dt>13.3. <a href="Java-Broker-High-Availability-JMXAPI.html#idm140218886201712">Example of java code to get the node state value</a></dt><dt>13.4. <a href="Java-Broker-High-Availability-Monitoring-cluster.html#idm140218886189936">Using <code class="classname">DbPing</code> utility for monitoring HA nodes.</a></dt><dt>13.5. <a href="Java-Broker-High-Availability-Backup.html#idm140218886157056">Performing store backup by using <code class="classname">BDBBackup</code> class directly</a></dt><dt>13.6. <a href="Java-Broker-High-Availability-Backup.html#idm140218886153040">Performing store backup by using <code class="classname">backup.sh</code> bash script</a></dt><dt>13.7. <a href="Java-Broker-High-Availability-MigrationFromNonHA.html#idm140218886147008">Enabling replication</a></dt><dt>13.8. <a href="Java-Broker-High-Availability-MigrationFromNonHA.html#idm140218886142544">Example of XML configuration for HA message store</a></dt><dt>13.9. <a href="Java-Broker-High-Availability-DisasterRecovery.html#idm140218886130368">Reseting of replication group with <code class="classname">DbResetRepGroup</code></a></dt><dt>14.1. <a href="Java-Broker-Stores-Memory-Store-Configuration.html#idm140218887780208">Configuring a VirtualHost to use the MemoryMessageStore</a></dt><dt>14.2. <a href="Java-Broker-Stores-BDB-Store-Configuration.html#idm140218887776432">Configuring a VirtualHost to use the BDBMessageStore</a>< /dt><dt>14.3. <a href="Java-Broker-Stores-BDB-Store-Configuration.html#idm140218886567616">Configuring BDB Environment Configuration</a></dt><dt>14.4. <a href="Java-Broker-Stores-Derby-Store-Configuration.html#idm140218886561168">Configuring a VirtualHost to use the DerbyMessageStore</a></dt><dt>14.5. <a href="Java-Broker-Stores-JDBC-Store-Configuration.html#idm140218886557488">Configuring a VirtualHost to use the JDBCMessageStore</a></dt><dt>14.6. <a href="Java-Broker-Virtual-Host-Configuration-Exchange.html#idm140218887116992">Configuring Exchanges on VirtualHost</a></dt><dt>14.7. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218887110816">Configuring a simple queue</a></dt><dt>14.8. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218887107328">Configuring a priority queue</a></dt><dt>14.9. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218887104400">Configuring a priority queue with fewer priorities</a></dt><dt>14.10. <a href="Java-Broker-Vi rtual-Host-Declare-Queues.html#idm140218886396848">Configuring a sorted queue</a></dt><dt>14.11. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218886391936">Configuring a LVQ queue</a></dt><dt>14.12. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218886389616">Configuring a LVQ queue with custom message property name</a></dt><dt>14.13. <a href="Java-Broker-Virtual-Host-Declare-Queues.html#idm140218886384640">Setting arbitrary queue arguments</a></dt><dt>14.14. <a href="Java-Broker-Virtual-Host-Binding-Queue.html#idm140218886622144">Queue Binding Example</a></dt><dt>14.15. <a href="Java-Broker-Virtual-Host-Configure-Flow-Control.html#idm140218886618384">Configuring a queue depth limit</a></dt><dt>14.16. <a href="Java-Broker-Virtual-Host-Configure-Flow-Control.html#idm140218886616608">Configuring of default queue depth limit on virtualhost</a></dt><dt>14.17. <a href="Java-Broker-Virtual-Host-Configure-Disk-Quotas.html#idm140218886612800">Configuring a limit on a store</a></dt><dt>14.18. <a href="Java-Broker-Virtual-Host-Transaction-Timeout-Configuring.html#idm140218886602464">Configuring producer transaction timeout</a></dt><dt>14.19. <a href="Java-Broker-Virtual-Host-Configuring-DLQ.html#idm140218886597152">Enabling DLQs and maximum delivery count at virtualhost and queue level within - virtualhosts.xml</a></dt><dt>14.20. <a href="Java-Broker-Virtual-Host-Configuration-File-Example.html#idm140218886593392">An example of virtual host configuration file</a></dt></dl></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="Java-Broker-Introduction.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%"> </td><td align="center" width="20%"> </td><td align="right" valign="top" width="40%"> Chapter 1. Introduction</td></tr></table></div></div> - - <hr/> - - <ul id="-apache-navigation"> - <li><a href="http://www.apache.org/">Apache</a></li> - <li><a href="http://www.apache.org/licenses/">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li> - <li><a href="/security.html">Security</a></li> - <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="" alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2015 - The Apache Software Foundation; Licensed under - the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache - License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, - Proton, Apache, the Apache feather logo, and the Apache Qpid - project logo are trademarks of The Apache Software - Foundation; All other marks mentioned may be trademarks or - registered trademarks of their respective owners - </p> - </div> - </div> - </div> - </body> -</html>
http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/java-broker/java-broker-book.pdf ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/java-broker/java-broker-book.pdf b/content/releases/qpid-0.26/java-broker/java-broker-book.pdf deleted file mode 100644 index e91e6c8..0000000 Binary files a/content/releases/qpid-0.26/java-broker/java-broker-book.pdf and /dev/null differ http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html deleted file mode 100644 index c004295..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Exceptions.html +++ /dev/null @@ -1,170 +0,0 @@ -<!DOCTYPE html> -<!-- - - - - Licensed to the Apache Software Foundation (ASF) under one - - or more contributor license agreements. See the NOTICE file - - distributed with this work for additional information - - regarding copyright ownership. The ASF licenses this file - - to you under the Apache License, Version 2.0 (the - - "License"); you may not use this file except in compliance - - with the License. You may obtain a copy of the License at - - - - http://www.apache.org/licenses/LICENSE-2.0 - - - - Unless required by applicable law or agreed to in writing, - - software distributed under the License is distributed on an - - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - - KIND, either express or implied. See the License for the - - specific language governing permissions and limitations - - under the License. - - ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> - <head> - <title>Appendix A. Exceptions - Apache Qpid™</title> - <meta http-equiv="X-UA-Compatible" content="IE=edge"/> - <meta name="viewport" content="width=device-width, initial-scale=1.0"/> - <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> - <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> - <script type="text/javascript">var _deferredFunctions = [];</script> - <script type="text/javascript" src="/deferred.js" defer="defer"></script> - <!--[if lte IE 8]> - <link rel="stylesheet" href="/ie.css" type="text/css"/> - <script type="text/javascript" src="/html5shiv.js"></script> - <![endif]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </div> - - <div id="-search" class="panel" style="display: none;"> - <form action="http://www.google.com/search" method="get"> - <input type="hidden" name="sitesearch" value="qpid.apache.org"/> - <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> - <button type="submit">Search</button> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Appendix A. Exceptions</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix A. Exceptions</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Maven.html">Next</a></td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Appendix-Exceptions"></a>Appendix A. Exceptions</h1></div></div></div><p>The methods of Qpid JMS Client throw <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/JMSException.html" target="_top">JMSExceptions</a> in response to error conditions. Typically the exception's message - (#getMessage()) summarises the error condition, with contextual information being provided by - the messages of linked exception(s). To understand the problem, it is important to read the messages - associated with <span class="emphasis"><em>all</em></span> the linked exceptions.</p><p>The following table describes some of the more common exceptions linked to JMSException - thrown by JMS methods whilst using the client:</p><div class="table"><a id="idp3557808"></a><p class="title"><strong>Table A.1. Exceptions linked to JMSExceptions thrown by JMS methods</strong></p><div class="table-contents"><table border="1" summary="Exceptions linked to JMSExceptions thrown by JMS methods" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Linked Exception</th><th>Message</th><th>Explanation/Common Causes</th></tr></thead><tbody><tr><td>AMQUnresolvedAddressException</td><td><span class="emphasis"><em>message varies</em></span></td><td><p>Indicates that the hostname included in the Connection URL's <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>, could not be resolved, . This could mean that the hostname is - mispelt, or there is name resolution problem.</p></td></tr><tr><td>AMQConnectionFailure</td><td>Connection refused</td><td><p>Indicates that the host included in the Connection URL's <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>, actively refused the connection. This could mean that the - hostname and/or port number is incorrect, or the Broker may not be - running.</p></td></tr><tr><td>AMQConnectionFailure</td><td>connect timed out</td><td><p>Indicates that the host included in the Connection URL's <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-ConnectionOptions-Brokerlist">brokerlist</a>, could not be contacted within the <a class="link" href="JMS-Client-0-8-Connection-URL.html#JMS-Client-0-8-Connection-URL-BrokerOptions-ConnectTimeout">connecttimeout</a>. This could mean that the host is shutdown, or a networking - routing problem means the host is unreachable.</p></td></tr><tr><td>AMQConnectionFailure</td><td>General SSL Problem; PKIX path building failed; unable to find valid certification - path to requested target</td><td><p>Indicates that the CA that signed the Broker's certificate is not trusted by - the JVM of the client. If the Broker is using a private-CA (or a self signed - certificate) check that the client has been properly configured with a truststore. See - <a class="xref" href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-SSL" title="5.3.3. SSL">Section 5.3.3, “SSL”</a></p></td></tr><tr><td>AMQTimeoutException</td><td>Server did not respond in a timely fashion; Request Timeout</td><td><p>Indicates that the broker did not respond to a request sent by the client in - a reasonable length of time. The timeout is governed by <a class="link" href="JMS-Client-0-8-System-Properties.html#JMS-Client-0-8-System-Properties-SyncOpTimeout"><code class="literal">qpid.sync_op_timeout</code></a>.</p><p>This can be a symptom - of a heavily loaded broker that cannot respond or the Broker may have failed in - unexpected manner. Check the broker and the host on which it runs and performance of - its storage.</p></td></tr></tbody></table></div></div><br class="table-break" /><p>The following table describes some of the more common exceptions linked to JMSException sent - to <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jmx/ExceptionListener.html" target="_top">ExceptionListener</a> - instances.</p><div class="table"><a id="idp1664464"></a><p class="title"><strong>Table A.2. Exceptions linked to JMSExceptions received by ExceptionListeners</strong></p><div class="table-contents"><table border="1" summary="Exceptions linked to JMSExceptions received by ExceptionListeners" width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Linked Exception</th><th>Message</th><th>Explanation/Common Causes</th></tr></thead><tbody><tr><td><a id="JMS-Client-0-8-Appendix-Exceptions-AMQNoRouteException"></a>AMQNoRouteException</td><td>No Route for message [Exchange: <span class="emphasis"><em>exchange name</em></span>, Routing key: - <span class="emphasis"><em>routing key</em></span>] [error code 312: no route]</td><td><p>Indicate that the named exchange is unable to route a message to at least one - queue.</p> - <p>This will occur if a queue has been improperly bound to an exchange. Use the - Broker's management interface to check the bindings. See <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-MandatoryMessage" title="5.5.1. Mandatory Messages">Section 5.5.1, “Mandatory Messages”</a></p></td></tr><tr><td><a id="JMS-Client-0-8-Appendix-Exceptions-AMQNoConsumersException"></a>AMQNoConsumersException</td><td>Immediate delivery is not possible. [error code 313: no consumers]</td><td><p>Immediate delivery was requested by the MessageProducer, but as there are no - consumers on any target queue, the message has been returned to the publisher. See - <a class="xref" href="JMS-Client-0-8-Client-Understanding-MessageProducer.html#JMS-Client-0-8-Client-Understanding-MessageProducer-ImmediateMessage" title="5.5.3. Immediate Messages">Section 5.5.3, “Immediate Messages”</a> - </p></td></tr><tr><td>AMQDisconnectedException</td><td>Server closed connection and reconnection not permitted</td><td><p>Indicates that the connection was closed by the Broker, and as <a class="link" href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover" title="5.3.1. Failover">failover - options</a> are not included in the Connection URL, the client has been unable to - reestablish connection.</p> - <p>The Connection is now closed and any attempt to use either Connection object, or - any objects created from the Connection will receive an <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/IllegalStateException.html" target="_top">IllegalStateException</a>.</p></td></tr><tr><td><a id="JMS-Client-0-8-Appendix-Exceptions-AMQDisconnectedException"></a>AMQDisconnectedException</td><td>Server closed connection and no failover was successful</td><td><p>Indicates that the connection was closed by the Broker. The client has tried - failover according to the rules of the <a class="link" href="JMS-Client-0-8-Client-Understanding-Connection.html#JMS-Client-0-8-Client-Understanding-Connection-Failover" title="5.3.1. Failover">failover - options</a>within the Connection URL, but these attempts were all - unsuccessful.</p> - <p>The Connection is now closed and any attempt to use either Connection object, or - any objects created from the Connection will receive an <a class="ulink" href="http://docs.oracle.com/javaee/6/api/javax/jms/IllegalStateException.html" target="_top">IllegalStateException</a>.</p></td></tr></tbody></table></div></div><br class="table-break" /></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Logging-EnablingDebugLogging.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-Appendix-Maven.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">10.2. Enabling Debug </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Appendix B. Minimal Maven POM</td></tr></table></div></div> - - <hr/> - - <ul id="-apache-navigation"> - <li><a href="http://www.apache.org/">Apache</a></li> - <li><a href="http://www.apache.org/licenses/">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li> - <li><a href="http://www.apache.org/security/">Security</a></li> - <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - The Apache Software Foundation; Licensed under - the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache - License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, - Proton, Apache, the Apache feather logo, and the Apache Qpid - project logo are trademarks of The Apache Software - Foundation; All other marks mentioned may be trademarks or - registered trademarks of their respective owners - </p> - </div> - </div> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html deleted file mode 100644 index 66e3a69..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Appendix-Maven.html +++ /dev/null @@ -1,167 +0,0 @@ -<!DOCTYPE html> -<!-- - - - - Licensed to the Apache Software Foundation (ASF) under one - - or more contributor license agreements. See the NOTICE file - - distributed with this work for additional information - - regarding copyright ownership. The ASF licenses this file - - to you under the Apache License, Version 2.0 (the - - "License"); you may not use this file except in compliance - - with the License. You may obtain a copy of the License at - - - - http://www.apache.org/licenses/LICENSE-2.0 - - - - Unless required by applicable law or agreed to in writing, - - software distributed under the License is distributed on an - - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - - KIND, either express or implied. See the License for the - - specific language governing permissions and limitations - - under the License. - - ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> - <head> - <title>Appendix B. Minimal Maven POM - Apache Qpid™</title> - <meta http-equiv="X-UA-Compatible" content="IE=edge"/> - <meta name="viewport" content="width=device-width, initial-scale=1.0"/> - <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> - <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> - <script type="text/javascript">var _deferredFunctions = [];</script> - <script type="text/javascript" src="/deferred.js" defer="defer"></script> - <!--[if lte IE 8]> - <link rel="stylesheet" href="/ie.css" type="text/css"/> - <script type="text/javascript" src="/html5shiv.js"></script> - <![endif]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </div> - - <div id="-search" class="panel" style="display: none;"> - <form action="http://www.google.com/search" method="get"> - <input type="hidden" name="sitesearch" value="qpid.apache.org"/> - <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> - <button type="submit">Search</button> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Appendix B. Minimal Maven POM</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Appendix B. Minimal Maven POM</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Appendix-Exceptions.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> </td></tr></table><hr /></div><div class="appendix"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Appendix-Maven"></a>Appendix B. Minimal Maven POM</h1></div></div></div><p> The following is a minimal Maven POM required to use the Qpid Client. It is suitable for - use with the <a class="link" href="JMS-Client-0-8-Examples.html" title="Chapter 4. Examples">examples</a> included in this - book.</p><div class="example"><a id="idp3576320"></a><p class="title"><strong>Example B.1. Minimal Maven POM </strong></p><div class="example-contents"><pre class="programlisting"> - -<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" - xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> - <modelVersion>4.0.0</modelVersion> - <groupId>test</groupId> - <artifactId>test</artifactId> - <version>0.0.1-SNAPSHOT</version> - <dependencies> - <dependency> - <groupId>org.apache.qpid</groupId> - <artifactId>qpid-client</artifactId> - <version>0.26</version> - </dependency> - <dependency> - <groupId>org.slf4j</groupId> - <artifactId>slf4j-log4j12</artifactId> - <version>1.6.4</version> - </dependency> - <dependency> - <groupId>org.apache.geronimo.specs</groupId> - <artifactId>geronimo-jms_1.1_spec</artifactId> - <version>1.1.1</version> - </dependency> - </dependencies> -</project> - - </pre></div></div><br class="example-break" /><p>Note: We use the SLF4J Binding for Log4J12 here, but any SLF4J Binding could be used - instead. Similarly, Geronimo JMS Spec is used, but any dependency that provides the JMS 1.1 - specification could be subsituted.</p></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Appendix-Exceptions.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> </td></tr><tr><td align="left" valign="top" width="40%">Appendix A. Exceptions </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> </td></tr></table></div></div> - - <hr/> - - <ul id="-apache-navigation"> - <li><a href="http://www.apache.org/">Apache</a></li> - <li><a href="http://www.apache.org/licenses/">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li> - <li><a href="http://www.apache.org/security/">Security</a></li> - <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - The Apache Software Foundation; Licensed under - the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache - License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, - Proton, Apache, the Apache feather logo, and the Apache Qpid - project logo are trademarks of The Apache Software - Foundation; All other marks mentioned may be trademarks or - registered trademarks of their respective owners - </p> - </div> - </div> - </body> -</html> http://git-wip-us.apache.org/repos/asf/qpid-site/blob/a39b425b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Binding-URL.html ---------------------------------------------------------------------- diff --git a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Binding-URL.html b/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Binding-URL.html deleted file mode 100644 index 578eb8e..0000000 --- a/content/releases/qpid-0.26/jms-client-0-8/book/JMS-Client-0-8-Binding-URL.html +++ /dev/null @@ -1,212 +0,0 @@ -<!DOCTYPE html> -<!-- - - - - Licensed to the Apache Software Foundation (ASF) under one - - or more contributor license agreements. See the NOTICE file - - distributed with this work for additional information - - regarding copyright ownership. The ASF licenses this file - - to you under the Apache License, Version 2.0 (the - - "License"); you may not use this file except in compliance - - with the License. You may obtain a copy of the License at - - - - http://www.apache.org/licenses/LICENSE-2.0 - - - - Unless required by applicable law or agreed to in writing, - - software distributed under the License is distributed on an - - "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY - - KIND, either express or implied. See the License for the - - specific language governing permissions and limitations - - under the License. - - ---> -<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"> - <head> - <title>Chapter 8. Binding URL - Apache Qpid™</title> - <meta http-equiv="X-UA-Compatible" content="IE=edge"/> - <meta name="viewport" content="width=device-width, initial-scale=1.0"/> - <link rel="stylesheet" href="/site.css" type="text/css" async="async"/> - <link rel="stylesheet" href="/deferred.css" type="text/css" defer="defer"/> - <script type="text/javascript">var _deferredFunctions = [];</script> - <script type="text/javascript" src="/deferred.js" defer="defer"></script> - <!--[if lte IE 8]> - <link rel="stylesheet" href="/ie.css" type="text/css"/> - <script type="text/javascript" src="/html5shiv.js"></script> - <![endif]--> - </head> - <body> - <div id="-content"> - <div id="-top" class="panel"> - <a id="-menu-link"><img width="16" height="16" src="data:image/png;base64," alt="Menu"/></a> - - <a id="-search-link"><img width="22" height="16" src="data:image/png;base64," alt="Search"/></a> - - <ul id="-global-navigation"> - <li><a id="-logotype" href="/index.html">Apache Qpid<sup>™</sup></a></li> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source Code</a></li> - <li><a href="/resources.html">More Resources</a></li> - </ul> - </div> - - <div id="-menu" class="panel" style="display: none;"> - <section> - <h3>Project</h3> - - <ul> - <li><a href="/overview.html">Overview</a></li> - <li><a href="/proton/index.html">Qpid Proton</a></li> - <li><a href="/contributors.html">Contributors</a></li> - <li><a href="/get-involved.html">Get involved</a></li> - </ul> - </section> - - <section> - <h3>Software</h3> - - <ul> - <li><a href="/download.html">Download</a></li> - <li><a href="/documentation.html">Documentation</a></li> - <li><a href="/components/index.html">Components</a></li> - <li><a href="/releases/index.html">Releases</a></li> - </ul> - </section> - - <section> - <h3>Resources</h3> - - <ul> - <li><a href="/discussion.html">Discussion</a></li> - <li><a href="/issues.html">Issues</a></li> - <li><a href="/source-code.html">Source code</a></li> - <li><a href="/resources.html">More resources</a></li> - </ul> - </section> - - <section> - <h3>More</h3> - - <ul> - <li><a href="/amqp.html">AMQP</a></li> - <li><a href="/developer.html">Developer central</a></li> - <li><a href="https://cwiki.apache.org/confluence/display/qpid/">Wiki</a></li> - </ul> - </section> - </div> - - <div id="-search" class="panel" style="display: none;"> - <form action="http://www.google.com/search" method="get"> - <input type="hidden" name="sitesearch" value="qpid.apache.org"/> - <input type="text" name="q" maxlength="255" autofocus="autofocus" tabindex="1"/> - <button type="submit">Search</button> - <p><a href="/search.html">More ways to search</a></p> - </form> - </div> - - <div id="-middle" class="panel"> - <ul id="-path-navigation"><li><a href="/releases/index.html">Releases</a></li><li><a href="/releases/qpid-0.26/index.html">Qpid 0.26</a></li><li><a href="/releases/qpid-0.26/jms-client-0-8/book/index.html">Qpid JMS Client for AMQP protocols 0-8, 0-9 and 0-9-1</a></li><li>Chapter 8. Binding URL</li></ul> - <div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">Chapter 8. Binding URL</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="JMS-Client-0-8-Connection-URL.html">Prev</a> </td><th align="center" width="60%"> </th><td align="right" width="20%"> <a accesskey="n" href="JMS-Client-0-8-System-Properties.html">Next</a></td></tr></table><hr /></div><div class="chapter"><div class="titlepage"><div><div><h1 class="title"><a id="JMS-Client-0-8-Binding-URL"></a>Chapter 8. Binding URL</h1></div></div></div><div class="toc"><p><strong>Table of Contents</strong></p><dl class="toc"><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Examples">8.1. Binding URL Examples</a></span></dt><dd><dl><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-JMS-Queues">8.1.1. Binding URLs for declarin g of JMS Queues</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-JMS-Topics">8.1.2. Binding URLs for declaring of JMS Topics</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Topics-Wildcards">8.1.3. Wildcard characters in routing keys for topic destinations</a></span></dt><dt><span class="section"><a href="JMS-Client-0-8-Binding-URL.html#JMS-Client-0-8-Binding-URL-Extra-Examples">8.1.4. More Examples</a></span></dt></dl></dd></dl></div><p> The <span class="emphasis"><em>Binding URL</em></span> syntax is the only addressing syntax supported by the - Qpid JMS client for AMQP 0-8, 0-9 and 0-9-1. It allows to specify the bindings that define the - relationship between a queue and an exchange, queue and exchange creation arguments and client - behaviour. </p><p> The format for a <span class="emphasis"><em>Binding URL</em></span> is provided below </p><pre class="screen"> -<Exchange Class>://<Exchange Name>/[<Destination>]/[<Queue>][?<option>='<value>'[&<option>='<value>']] - </pre><p> where </p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p><span class="emphasis"><em>Exchange Class</em></span>, specifies the type of the exchange, for example, - <span class="emphasis"><em>direct</em></span>,<span class="emphasis"><em>topic</em></span>,<span class="emphasis"><em>fanout</em></span>, etc. - </p></li><li class="listitem"><p><span class="emphasis"><em>Exchange Name</em></span>, specifies the name of the exchange, for example, - <span class="emphasis"><em>amq.direct</em></span>,<span class="emphasis"><em>amq.topic</em></span>, etc. </p></li><li class="listitem"><p><span class="emphasis"><em>Destination</em></span>, is an optional part of <span class="emphasis"><em>Binding - URL</em></span>. It can be used to specify a routing key with the non direct exchanges if - an option <span class="emphasis"><em>routingkey</em></span> is not specified. If both - <span class="emphasis"><em>Destination</em></span> and option <span class="emphasis"><em>routingkey</em></span> are - specified, then option <span class="emphasis"><em>routingkey</em></span> has precedence. </p></li><li class="listitem"><p><span class="emphasis"><em>Queue</em></span>, is an optional part of <span class="emphasis"><em>Binding URL</em></span> to - specify a queue name for JMS queue destination. It is ignored in JMS topic destinations. - Queue names may consist of any mixture of digits, letters, and underscores </p></li><li class="listitem"><p><span class="emphasis"><em>Options</em></span>, key-value pairs separated by '=' character specifying - queue and exchange creation arguments, routing key, client behaviour, etc. </p></li></ul></div><p> - </p><div class="important" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Binding URL option quoting</h3><p>Take care with the quoting surrounding option values. Each option value - <span class="emphasis"><em>must</em></span> be surrounded with single quotes ('). </p></div><p> The following <span class="emphasis"><em>Binding URL</em></span> options are currently defined: </p><div class="table"><a id="idp200816"></a><p class="title"><strong>Table 8.1. Binding URL options </strong></p><div class="table-contents"><table border="1" summary="Binding URL options " width="100%"><colgroup><col /><col /><col /></colgroup><thead><tr><th>Option</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><p>durable</p></td><td><p>boolean </p></td><td><p>Queue durability flag. If it is set to <span class="emphasis"><em>true</em></span>, a durable - queue is requested to create. The durable queue should be stored on the Broker and - remained there after Broker restarts until it is explicitly deleted. This option has - no meaning for JMS topic destinations, as by nature a topic destination only exists - when a subscriber is connected. If durability is required for topic destinations, - the durable subscription should be created.</p></td></tr><tr><td><p>exclusive</p></td><td><p>boolean </p></td><td><p>Queue exclusivity flag. The client cannot use a queue that was declared as - exclusive by another still-open connection.</p></td></tr><tr><td><p>autodelete</p></td><td><p>boolean </p></td><td><p>Queue auto-deletion flag. If it is set to <span class="emphasis"><em>true</em></span> on - queue creation, the queue is deleted if there are no remaining - subscribers.</p></td></tr><tr><td><p>exchangeautodelete</p></td><td><p>boolean </p></td><td><p>Exchange auto-deletion flag.</p></td></tr><tr><td><p>exchangedurable</p></td><td><p>boolean </p></td><td><p>Exchange durability flag. If it is set to <span class="emphasis"><em>true</em></span> when - creating a new exchange, the exchange will be marked as durable. Durable exchanges - should remain active after Broker restarts. Non-durable exchanges are deleted on - following Broker restart.</p></td></tr><tr><td><p>routingkey</p></td><td><p>string </p></td><td> - <p> Defines the value of the binding key to bind a queue to the exchange. It is - always required to specify for JMS topic destinations. If routing key option is not - set in <span class="emphasis"><em>Binding URL</em></span> and direct exchange class is specified, the - queue name is used as a routing key. <span class="emphasis"><em>MessagePublisher</em></span> uses - routing key to publish messages onto exchange. </p> - </td></tr><tr><td><p>browse</p></td><td><p>boolean </p></td><td><p>If set to <span class="emphasis"><em>true</em></span> on a destination for a message - consumer, such consumer can only read messages on the queue but cannot consume them. - The consumer behaves like a queue browser in this case.</p></td></tr><tr><td><a id="JMS-Client-0-8-Binding-URL-Options-RejectBehaviour"></a><p>rejectbehaviour</p></td><td><p>string </p></td><td><p>Defines the reject behaviour for the re-delivered messages. If set to - 'SERVER' the client delegates the requeue/DLQ decision to the server. If this option - is not specified, the messages won't be moved to the DLQ (or dropped) when delivery - count exceeds the maximum. </p></td></tr></tbody></table></div></div><p><br class="table-break" /> - </p><div class="section"><div class="titlepage"><div><div><h2 class="title"><a id="JMS-Client-0-8-Binding-URL-Examples"></a>8.1. Binding URL Examples</h2></div></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="JMS-Client-0-8-Binding-URL-JMS-Queues"></a>8.1.1. Binding URLs for declaring of JMS Queues</h3></div></div></div><p>The Qpid client Binding URLs for JMS queue destinations can be declared using direct - exchange (Mostly it is a pre-defined exchange with a name "amq.direct". Also, custom direct - exchanges can be used.): </p><pre class="screen"> -direct://amq.direct//<Queue Name> - </pre><p> - </p><p>The Binding URLs for destinations created with calls to - <span class="emphasis"><em>Session.createQueue(String)</em></span> can be expressed as </p><pre class="screen"> -direct://amq.direct//<Queue Name>?durable='true' - </pre><p> The durability flag is set to <span class="emphasis"><em>true</em></span> in such destinations. </p><div class="example"><a id="idp1280880"></a><p class="title"><strong>Example 8.1. Binding URL examples for JMS queues</strong></p><div class="example-contents"><pre class="screen"> -direct://amq.direct//myNonDurableQueue -direct://amq.direct//myDurableQueue?durable='true' -direct://amq.direct//myAnotherQueue?durable='true'&routingkey='myqueue' -direct://amq.direct//myQueue?durable='true'&routingkey='myqueue'&rejectbehaviour='server' -direct://custom.direct//yetAnotherQueue - </pre></div></div><br class="example-break" /></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="JMS-Client-0-8-Binding-URL-JMS-Topics"></a>8.1.2. Binding URLs for declaring of JMS Topics</h3></div></div></div><p>The Binding URLs for JMS queue destinations can be declared using topic exchange (A - pre-defined exchange having name "amq.topic" is used mainly. However, custom topic exchanges - can be used as well): </p><pre class="screen"> -topic://amq.topic//<Queue name>?routingkey='<Topic Name>'&exclusive='true'&autodelete='true' - </pre><p> - </p><p>The Binding URLs for a topic destination created with calls to - <span class="emphasis"><em>Session.createTopic("hello")</em></span> is provided below: </p><div class="example"><a id="idp5996448"></a><p class="title"><strong>Example 8.2. Binding URL examples for JMS topics</strong></p><div class="example-contents"><pre class="screen"> -topic://amq.topic/hello/tmp_127_0_0_1_36973_1?routingkey='hello'&exclusive='true'&autodelete='true' - </pre></div></div><p><br class="example-break" /> - </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="JMS-Client-0-8-Binding-URL-Topics-Wildcards"></a>8.1.3. Wildcard characters in routing keys for topic destinations</h3></div></div></div><p> AMQP exchanges of class <span class="emphasis"><em>topic</em></span> can route messages to the queues - using special matches containing wildcard characters (a "#" matches one or more words, a "*" - matches a single word). The routing keys words are separated with a "." delimiter to - distinguish words for matching. Thus, if a consumer application specifies a routing key in - the destination like "usa.#", it should receive all the messages matching to that routing - key. For example, "usa.boston", "usa.new-york", etc. </p><p> The examples of the <span class="emphasis"><em>Binding URLs</em></span> having routing keys with - wildcards characters are provided below: </p><pre class="screen"> -topic://amq.topic?routingkey='stocks.#' -topic://amq.topic?routingkey='stocks.*.ibm' -topic://amq.topic?routingkey='stocks.nyse.ibm' - </pre><p> - </p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="JMS-Client-0-8-Binding-URL-Extra-Examples"></a>8.1.4. More Examples</h3></div></div></div><div class="table"><a id="idp6004208"></a><p class="title"><strong>Table 8.2. Binding URL examples</strong></p><div class="table-contents"><table border="1" summary="Binding URL examples"><colgroup><col /><col /></colgroup><thead><tr><th>Binding URL</th><th>Description</th></tr></thead><tbody><tr><td><p>fanout://amq.fanout//myQueue</p></td><td><p>Binding URL binding queue "myQueue" to predefined "amq.fanout" exchange - of class "fanout"</p></td></tr><tr><td><p>topic://custom.topic//anotherQueue?routingkey='aq'</p></td><td><p>Binding URL binding queue "anotherQueue" to the exchange with name - "custom.topic" of class "topic" using binding key "aq".</p></td></tr></tbody></table></div></div><br class="table-break" /></div></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="JMS-Client-0-8-Connection-URL.html">Prev</a> </td><td align="center" width="20%"> </td><td align="right" width="40%"> <a accesskey="n" href="JMS-Client-0-8-System-Properties.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter 7. Connection URLs </td><td align="center" width="20%"><a accesskey="h" href="index.html">Home</a></td><td align="right" valign="top" width="40%"> Chapter 9. System Properties</td></tr></table></div></div> - - <hr/> - - <ul id="-apache-navigation"> - <li><a href="http://www.apache.org/">Apache</a></li> - <li><a href="http://www.apache.org/licenses/">License</a></li> - <li><a href="http://www.apache.org/foundation/sponsorship.html">Sponsorship</a></li> - <li><a href="http://www.apache.org/foundation/thanks.html">Thanks!</a></li> - <li><a href="http://www.apache.org/security/">Security</a></li> - <li><a href="http://www.apache.org/"><img id="-apache-feather" width="48" height="14" src="data:image/png;base64," alt="Apache"/></a></li> - </ul> - - <p id="-legal"> - Apache Qpid, Messaging built on AMQP; Copyright © 2013 - The Apache Software Foundation; Licensed under - the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache - License, Version 2.0</a>; Apache Qpid, Qpid, Qpid Proton, - Proton, Apache, the Apache feather logo, and the Apache Qpid - project logo are trademarks of The Apache Software - Foundation; All other marks mentioned may be trademarks or - registered trademarks of their respective owners - </p> - </div> - </div> - </body> -</html> --------------------------------------------------------------------- To unsubscribe, e-mail: commits-unsubscr...@qpid.apache.org For additional commands, e-mail: commits-h...@qpid.apache.org