44 lines
2.9 KiB
XML
44 lines
2.9 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
|
|
<!-- ============================================================================= -->
|
|
<!-- 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. -->
|
|
<!-- ============================================================================= -->
|
|
|
|
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % BOOK_ENTITIES SYSTEM "ActiveMQ_User_Manual.ent">
|
|
%BOOK_ENTITIES;
|
|
]>
|
|
|
|
<chapter id="wildcard-syntax">
|
|
<title>Understanding the ActiveMQ Wildcard Syntax</title>
|
|
<para>ActiveMQ uses a specific syntax for representing wildcards in security settings,
|
|
address settings and when creating consumers.</para>
|
|
<para>The syntax is similar to that used by <ulink url="http://www.amqp.org">AMQP</ulink>.</para>
|
|
<para>A ActiveMQ wildcard expression contains words delimited by the character '<literal
|
|
>.</literal>' (full stop).</para>
|
|
<para>The special characters '<literal>#</literal>' and '<literal>*</literal>' also have special
|
|
meaning and can take the place of a word.</para>
|
|
<para>The character '<literal>#</literal>' means 'match any sequence of zero or more
|
|
words'.</para>
|
|
<para>The character '<literal>*</literal>' means 'match a single word'.</para>
|
|
<para>So the wildcard 'news.europe.#' would match 'news.europe', 'news.europe.sport',
|
|
'news.europe.politics', and 'news.europe.politics.regional' but would not match 'news.usa',
|
|
'news.usa.sport' nor 'entertainment'.</para>
|
|
<para>The wildcard 'news.*' would match 'news.europe', but not 'news.europe.sport'.</para>
|
|
<para>The wildcard 'news.*.sport' would match 'news.europe.sport' and also 'news.usa.sport', but
|
|
not 'news.europe.politics'.</para>
|
|
</chapter>
|