A Few fixes around docs using GMF (Github Markdown Flavored) on tables

I also did some review of the huge table we have,
removed a few columns such as the datatype and
embedded the default on the description. Just trying to make easier to render and read

Also a few fixes on the doc context such as adding links and improving configuration-index
This commit is contained in:
Clebert Suconic 2015-03-13 18:37:28 -04:00
parent 4afa19b348
commit 0cf2a56fd6
8 changed files with 322 additions and 1900 deletions

File diff suppressed because it is too large Load Diff

View File

@ -53,7 +53,7 @@ Expiry address are defined in the address-setting configuration:
If messages are expired and no expiry address is specified, messages are
simply removed from the queue and dropped. Address wildcards can be used
to configure expiry address for a set of addresses (see [Understanding the HornetQ Wildcard Syntax](wildcard-syntax.md)).
to configure expiry address for a set of addresses (see [Understanding the Wildcard Syntax](wildcard-syntax.md)).
## Configuring The Expiry Reaper Thread

View File

@ -124,7 +124,7 @@ situations. This is discussed in [Paging](paging.md).
If no persistence is required at all, Apache ActiveMQ can also be configured
not to persist any data at all to storage as discussed in the Configuring
HornetQ for Zero Persistence section.
the broker for Zero Persistence section.
## Configuring the bindings journal

View File

@ -1385,48 +1385,17 @@ role your own security by specifying security constraints with your
web.xml for every path of every queue and topic you have deployed. Here
is a list of URI patterns:
<table>
<tr>
<td>/queues </td>
<td>secure the POST operation to secure queue creation</td>
</tr>
<tr>
<td>/queues/{queue-name}</td>
<td>secure the GET HEAD operation to getting information about the queue.</td>
</tr>
<tr>
<td>/queues/{queue-name}/create/\* </td>
<td>secure this URL pattern for producing messages. </td>
</tr>
<tr>
<td>/queues/{queue-name}/pull-consumers/\*</td>
<td>secure this URL pattern for pushing messages.</td>
</tr>
<tr>
<td>/queues/{queue-name}/push-consumers/\*</td>
<td>secure the POST operation to secure topic creation</td>
</tr>
<tr>
<td>/topics</td>
<td>secure the POST operation to secure topic creation</td>
</tr>
<tr>
<td>/topics/{topic-name}</td>
<td>secure the GET HEAD operation to getting information about the topic.</td>
</tr>
<tr>
<td>/topics/{topic-name}/create/\*</td>
<td>secure this URL pattern for producing messages.</td>
</tr>
<tr>
<td>/topics/{topic-name}/pull-subscriptions/\*</td>
<td>secure this URL pattern for pulling messages.</td>
</tr>
<tr>
<td>/topics/{topic-name}/push-subscriptions/\*</td>
<td>secure this URL pattern for pushing messages.</td>
</tr>
</table>
Post | Description
--- | ---
/queues | secure the POST operation to secure queue creation
/queues/{queue-name}/create/ | secure this URL pattern for producing messages.
/queues/{queue-name}/pull-consumers/ | secure this URL pattern for pushing messages.
/queues/{queue-name}/push-consumers/ | secure the POST operation to secure topic creation
/topics | secure the POST operation to secure topic creation
/topics/{topic-name} | secure the GET HEAD operation to getting information about the topic.
/topics/{topic-name}/create/ | secure this URL pattern for producing messages
/topics/{topic-name}/pull-subscriptions/ | secure this URL pattern for pulling messages
/topics/{topic-name}/push-subscriptions/ | secure this URL pattern for pushing messages
## Mixing JMS and REST
@ -1463,10 +1432,12 @@ If you have a REST client producing messages and a JMS consumer,
Apache ActiveMQ REST has a simple helper class for you to transform the HTTP
body to a Java object. Here's some example code:
public void onMessage(Message message)
{
MyType obj = org.apache.activemq.rest.Jms.getEntity(message, MyType.class);
}
```java
public void onMessage(Message message)
{
MyType obj = org.apache.activemq.rest.Jms.getEntity(message, MyType.class);
}
```
The way the `getEntity()` method works is that if the message is an
ObjectMessage, it will try to extract the desired type from it like any

View File

@ -67,7 +67,7 @@ Let's take a simple example, here's a security block from
The '`#`' character signifies "any sequence of words". Words are
delimited by the '`.`' character. For a full description of the wildcard
syntax please see [Understanding the HornetQ Wildcard Syntax](wildcard-syntax.md).
syntax please see [Understanding the Wildcard Syntax](wildcard-syntax.md).
The above security block applies to any address
that starts with the string "globalqueues.europe.":

View File

@ -12,7 +12,9 @@ by eliminating the need so specify a classpath. These tools are:
the bindings and message journals are stored, respectively. For
example:
java -jar activemq-tools-<version>-jar-with-dependencies.jar print-data /home/user/activemq/data/bindings /home/user/activemq/data/journal
```sh
java -jar activemq-tools-<version>-jar-with-dependencies.jar print-data /home/user/activemq/data/bindings /home/user/activemq/data/journal
```
- **`print-pages`**. Used for low-level inspection of paged message
data. It takes two parameters - `paging-directory` and
@ -20,7 +22,9 @@ by eliminating the need so specify a classpath. These tools are:
paged messages and the message journals are stored, respectively.
For example:
java -jar activemq-tools-<version>-jar-with-dependencies.jar print-pages /home/user/activemq/data/paging-directory /home/user/activemq/data/journal
```sh
java -jar activemq-tools-<version>-jar-with-dependencies.jar print-pages /home/user/activemq/data/paging-directory /home/user/activemq/data/journal
```
- **`export`**. Used for exporting all binding and message data
(including paged and large messages) as well as JMS destinations and
@ -39,8 +43,9 @@ by eliminating the need so specify a classpath. These tools are:
directory.
Here's an example:
java -jar activemq-tools-<version>-jar-with-dependencies.jar export /home/user/activemq/data/bindings-directory /home/user/activemq/data/journal-directory /home/user/activemq/data/paging-directory /home/user/activemq/data/large-messages
```
java -jar activemq-tools-<version>-jar-with-dependencies.jar export /home/user/activemq/data/bindings-directory /home/user/activemq/data/journal-directory /home/user/activemq/data/paging-directory /home/user/activemq/data/large-messages
```
This tool will export directly to standard out so if the data needs
to be stored in a file please redirect as appropriate for the
@ -78,7 +83,9 @@ by eliminating the need so specify a classpath. These tools are:
Here's an example:
java -jar activemq-tools-<version>-jar-with-dependencies.jar import /home/user/exportData.xml 127.0.0.1 61616 false false
```sh
java -jar activemq-tools-<version>-jar-with-dependencies.jar import /home/user/exportData.xml 127.0.0.1 61616 false false
```
Like the `export` tool the `import` tool is single threaded so
depending on the size of the XML file it may take awhile for the

View File

@ -73,7 +73,7 @@ Example:
6. Wait Delay Period: 15000 // (10000 * 2) > max-delay-period: Use max-delay-delivery
Address wildcards can be used to configure redelivery delay for a set of
addresses (see [Understanding the HornetQ Wildcard Syntax](wildcard-syntax.md)), so you don't have to specify redelivery delay
addresses (see [Understanding the Wildcard Syntax](wildcard-syntax.md)), so you don't have to specify redelivery delay
individually for each address.
### Example
@ -120,7 +120,7 @@ addresses and you can set `max-delivery-attempts` to -1 for a specific
address setting to allow infinite redeliveries only for this address.
Address wildcards can be used to configure dead letter settings for a
set of addresses (see [Understanding the HornetQ Wildcard Syntax](wildcard-syntax.md)).
set of addresses (see [Understanding the Wildcard Syntax](wildcard-syntax.md)).
### Dead Letter Properties

View File

@ -186,36 +186,15 @@ This can be changed by setting the type like so
In this example it is still set to the default, below shows a list of types that can be set.
#### Configuration for Connection Factory Types
<table>
<tr>
<th>type</th>
<th>interface</th>
</tr>
<tr>
<td>CF (default)</td>
<td>javax.jms.ConnectionFactory</td>
</tr>
<tr>
<td>XA_CF</td>
<td>javax.jms.XAConnectionFactory</td>
</tr>
<tr>
<td>QUEUE_CF</td>
<td>javax.jms.QueueConnectionFactory</td>
</tr>
<tr>
<td>QUEUE_XA_CF</td>
<td>javax.jms.XAQueueConnectionFactory</td>
</tr>
<tr>
<td>TOPIC_CF</td>
<td>javax.jms.TopicConnectionFactory</td>
</tr>
<tr>
<td>TOPIC_XA_CF</td>
<td>javax.jms.XATopicConnectionFactory</td>
</tr>
</table>
type | interface
--- |---
CF (default) | javax.jms.ConnectionFactory
XA_CF | javax.jms.XAConnectionFactory
QUEUE_CF | javax.jms.QueueConnectionFactory
QUEUE_XA_CF | javax.jms.XAQueueConnectionFactory
TOPIC_CF | javax.jms.TopicConnectionFactory
TOPIC_XA_CF | javax.jms.XATopicConnectionFactory
### Destination JNDI