[DISPATCH-1578] Provide address pattern examples highlighting use of both pattern separator characters

• Type: Improvement
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Affects Version/s: 1.10.0
• Fix Version/s: Backlog
• Component/s: Documentation
• Assignee: Unassigned
• Reporter: Ken Giusti
• Created: 21/Feb/20 16:32
• Updated: 21/Feb/20 16:38

Description

Folks have been tripped up on a subtle property of the address pattern matching syntax:  that the separators '/' and '.' are equivalent.  They've attempted to configure two patterns which actually overlap.  Example:

 

pattern: foo.bar

and pattern: foo/bar

 

The documentation does mention this, however it would probably be more obvious with an example.  For example, highlight that

foo.bar.baz == foo/bar/baz == foo.bar/baz == foo/bar.baz == etc

The reason the router accepts both forms is that legacy applications tend to use the old amqp 0-10 pattern format ('.' is the separator) whilst the proposed AMQP addressing spec uses '/'.