com.rabbitmq.client.AddressResolver Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of amqp-client Show documentation
Show all versions of amqp-client Show documentation
The RabbitMQ Java client library allows Java applications to interface with RabbitMQ.
// Copyright (c) 2007-2020 VMware, Inc. or its affiliates. All rights reserved.
//
// This software, the RabbitMQ Java client library, is triple-licensed under the
// Mozilla Public License 2.0 ("MPL"), the GNU General Public License version 2
// ("GPL") and the Apache License version 2 ("ASL"). For the MPL, please see
// LICENSE-MPL-RabbitMQ. For the GPL, please see LICENSE-GPL2. For the ASL,
// please see LICENSE-APACHE2.
//
// This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND,
// either express or implied. See the LICENSE file for specific language governing
// rights and limitations of this software.
//
// If you have any questions regarding licensing, please contact us at
// [email protected].
package com.rabbitmq.client;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
/** Strategy interface to get the potential servers to connect to. */
public interface AddressResolver {
/**
* Get the potential {@link Address}es to connect to.
*
* @return candidate {@link Address}es
* @throws IOException if it encounters a problem
*/
List getAddresses() throws IOException;
/**
* Optionally shuffle the list of addresses returned by {@link #getAddresses()}.
*
* The automatic connection recovery calls this method after {@link #getAddresses()} to pick a
* random address for reconnecting.
*
*
The default method implementation calls {@link Collections#shuffle(List)}. Custom
* implementations can choose to not do any shuffling to have more predictability in the
* reconnection.
*
* @param input
* @return potentially shuffled list of addresses.
*/
default List
maybeShuffle(List input) {
List list = new ArrayList(input);
Collections.shuffle(list);
return list;
}
}