ch.rasc.wampspring.method

Class DestinationPatternsMessageCondition

java.lang.Object

org.springframework.messaging.handler.AbstractMessageCondition<DestinationPatternsMessageCondition>

ch.rasc.wampspring.method.DestinationPatternsMessageCondition

All Implemented Interfaces:

org.springframework.messaging.handler.MessageCondition<DestinationPatternsMessageCondition>

public class DestinationPatternsMessageCondition
extends org.springframework.messaging.handler.AbstractMessageCondition<DestinationPatternsMessageCondition>

A MessageCondition for matching the destination of a Message against one or more destination patterns using a PathMatcher.

Author:

Rossen Stoyanchev, Ralph Schaer

Constructor Summary

Constructors

Constructor and Description
DestinationPatternsMessageCondition(String[] patterns, org.springframework.util.PathMatcher pathMatcher) Alternative constructor accepting a custom PathMatcher.

Method Summary

Modifier and Type	Method and Description
DestinationPatternsMessageCondition	combine(DestinationPatternsMessageCondition other) Returns a new instance with URL patterns from the current instance ("this") and the "other" instance as follows: If there are patterns in both instances, combine the patterns in "this" with the patterns in "other" using PathMatcher.combine(String, String).
int	compareTo(DestinationPatternsMessageCondition other, org.springframework.messaging.Message<?> message) Compare the two conditions based on the destination patterns they contain.
protected Collection<String>	getContent()
DestinationPatternsMessageCondition	getMatchingCondition(org.springframework.messaging.Message<?> message) Check if any of the patterns match the given Message destination and return an instance that is guaranteed to contain matching patterns, sorted via PathMatcher.getPatternComparator(String).
Set<String>	getPatterns()
protected String	getToStringInfix()

Methods inherited from class org.springframework.messaging.handler.AbstractMessageCondition

equals, hashCode, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DestinationPatternsMessageCondition

public DestinationPatternsMessageCondition(String[] patterns,
                                           org.springframework.util.PathMatcher pathMatcher)

Alternative constructor accepting a custom PathMatcher.

Parameters:

patterns - the URL patterns to use; if 0, the condition will match to every request.

pathMatcher - the PathMatcher to use

Method Detail

getPatterns

public Set<String> getPatterns()

getContent

protected Collection<String> getContent()

Specified by:

getContent in class org.springframework.messaging.handler.AbstractMessageCondition<DestinationPatternsMessageCondition>

getToStringInfix

protected String getToStringInfix()

Specified by:

getToStringInfix in class org.springframework.messaging.handler.AbstractMessageCondition<DestinationPatternsMessageCondition>

combine

public DestinationPatternsMessageCondition combine(DestinationPatternsMessageCondition other)

Returns a new instance with URL patterns from the current instance ("this") and the "other" instance as follows:

• If there are patterns in both instances, combine the patterns in "this" with the patterns in "other" using PathMatcher.combine(String, String).
• If only one instance has patterns, use them.
• If neither instance has patterns, use an empty String (i.e. "").

getMatchingCondition

public DestinationPatternsMessageCondition getMatchingCondition(org.springframework.messaging.Message<?> message)

Check if any of the patterns match the given Message destination and return an instance that is guaranteed to contain matching patterns, sorted via PathMatcher.getPatternComparator(String).

Parameters:

message - the message to match to

Returns:

the same instance if the condition contains no patterns; or a new condition with sorted matching patterns; or null either if a destination can not be extracted or there is no match

compareTo

public int compareTo(DestinationPatternsMessageCondition other,
                     org.springframework.messaging.Message<?> message)

Compare the two conditions based on the destination patterns they contain. Patterns are compared one at a time, from top to bottom via PathMatcher.getPatternComparator(String). If all compared patterns match equally, but one instance has more patterns, it is considered a closer match.

It is assumed that both instances have been obtained via getMatchingCondition(Message) to ensure they contain only patterns that match the request and are sorted with the best matches on top.