org.springframework.amqp.core.Address Maven / Gradle / Ivy
/*
* Copyright 2002-2014 the original author or authors.
*
* Licensed 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.
*/
package org.springframework.amqp.core;
import java.util.regex.Matcher;
import java.util.regex.Pattern;
import org.springframework.util.StringUtils;
/**
* Represents an address for publication of an AMQP message. The AMQP 0-8 and 0-9 specifications have an unstructured
* string that is used as a "reply to" address. There are however conventions in use and this class makes it easier to
* follow these conventions, which can be easily summarised as:
*
*
* (exchangeType)://(exchange)/(routingKey)
*
*
* Here we also allow the exchange type to default to direct, and the exchange name to default to empty (so just a
* routing key will work if you know the queue name).
*
* @see ExchangeTypes
*
* @author Mark Pollack
* @author Mark Fisher
* @author Dave Syer
*/
public class Address {
private static final Pattern pattern = Pattern.compile("^([^:]+)://([^/]*)/?(.*)$");
private final String exchangeType;
private final String exchangeName;
private final String routingKey;
/**
* Create an Address instance from a structured String in the form
*
*
* (exchangeType)://(exchange)/(routingKey)
*
*
* where examples of valid exchangeType values can be found in the {@link ExchangeTypes} static
* constants.
*
* @param address a structured string.
*/
public Address(String address) {
if (address == null) {
this.exchangeType = ExchangeTypes.DIRECT;
this.exchangeName = "";
this.routingKey = "";
} else {
Matcher matcher = pattern.matcher(address);
boolean matchFound = matcher.find();
if (matchFound) {
this.exchangeType = matcher.group(1);
this.exchangeName = matcher.group(2);
this.routingKey = matcher.group(3);
} else {
this.exchangeType = ExchangeTypes.DIRECT;
this.exchangeName = "";
this.routingKey = address;
}
}
}
/***
* Create an Address given the exchange type, exchange name and routing key. This will set the exchange type, name
* and the routing key explicitly.
*
* @param exchangeType The exchange type.
* @param exchangeName The exchange name.
* @param routingKey The routing key.
*/
public Address(String exchangeType, String exchangeName, String routingKey) {
this.exchangeType = exchangeType;
this.exchangeName = exchangeName;
this.routingKey = routingKey;
}
public String getExchangeType() {
return this.exchangeType;
}
public String getExchangeName() {
return this.exchangeName;
}
public String getRoutingKey() {
return this.routingKey;
}
@Override
public String toString() {
StringBuilder sb = new StringBuilder(this.exchangeType + "://" + this.exchangeName + "/");
if (StringUtils.hasText(this.routingKey)) {
sb.append(this.routingKey);
}
return sb.toString();
}
}