com.hazelcast.config.TcpIpConfig Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2021, Hazelcast, Inc. All Rights Reserved.
*
* 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 com.hazelcast.config;
import java.util.ArrayList;
import java.util.List;
import java.util.StringTokenizer;
import static com.hazelcast.internal.util.Preconditions.checkHasText;
import static com.hazelcast.internal.util.Preconditions.isNotNull;
/**
* Contains the configuration for the Tcp/Ip join mechanism.
*
* The Tcp/Ip join mechanism relies on one or more well known members. So when a new member wants to join
* a cluster, it will try to connect to one of the well known members. If it is able to connect, it will know
* about all members in the cluster and won't rely on these well known members anymore.
*/
public class TcpIpConfig {
private static final int CONNECTION_TIMEOUT_SEC = 5;
private int connectionTimeoutSeconds = CONNECTION_TIMEOUT_SEC;
private boolean enabled;
private List members = new ArrayList();
private String requiredMember;
/**
* Returns the connection timeout.
*
* @return the connectionTimeoutSeconds
* @see #setConnectionTimeoutSeconds(int)
*/
public int getConnectionTimeoutSeconds() {
return connectionTimeoutSeconds;
}
/**
* Sets the connection timeout. This is the maximum amount of time Hazelcast will try to
* connect to a well known member before giving up. Setting it to a too low value could mean that a
* member is not able to connect to a cluster. Setting it as too high a value means that member startup
* could slow down because of longer timeouts (e.g. when a well known member is not up).
*
* @param connectionTimeoutSeconds the connection timeout in seconds
* @return the updated TcpIpConfig
* @throws IllegalArgumentException if connectionTimeoutSeconds is smaller than 0
* @see #getConnectionTimeoutSeconds()
*/
public TcpIpConfig setConnectionTimeoutSeconds(final int connectionTimeoutSeconds) {
if (connectionTimeoutSeconds < 0) {
throw new IllegalArgumentException("connection timeout can't be smaller than 0");
}
this.connectionTimeoutSeconds = connectionTimeoutSeconds;
return this;
}
/**
* Checks if the Tcp/Ip join mechanism is enabled.
*
* @return {@code true} if enabled, {@code false} otherwise
*/
public boolean isEnabled() {
return enabled;
}
/**
* Enables or disables the Tcp/Ip join mechanism.
*
* @param enabled {@code true} to enable the Tcp/Ip join mechanism, {@code false} to disable
* @return TcpIpConfig the updated TcpIpConfig config
*/
public TcpIpConfig setEnabled(final boolean enabled) {
this.enabled = enabled;
return this;
}
/**
* Gets a list of all the well known members. If there are no well known members, the list will
* be empty.
*
* @return the list members
* @see #setMembers(java.util.List)
*/
public List getMembers() {
if (members == null) {
members = new ArrayList();
}
return members;
}
/**
* Sets the well known members.
*
* If members are empty, calling this method will have the same effect as calling {@link #clear()}.
*
* A member can be a comma separated string, e..g '10.11.12.1,10.11.12.2' which indicates multiple members
* are going to be added.
*
* @param members the members to set
* @return the updated TcpIpConfig
* @throws IllegalArgumentException if members is {@code null}
*/
public TcpIpConfig setMembers(final List members) {
isNotNull(members, "members");
this.members.clear();
for (String member : members) {
addMember(member);
}
return this;
}
/**
* Adds a 'well known' member.
*
* Each HazelcastInstance will try to connect to at least one of the members, to find all other members,
* and create a cluster.
*
* A member can be a comma separated string, e..g '10.11.12.1,10.11.12.2' which indicates multiple members
* are going to be added.
*
* @param member the member to add
* @return the updated configuration
* @throws IllegalArgumentException if member is {@code null} or empty
* @see #getMembers()
*/
public TcpIpConfig addMember(String member) {
String memberText = checkHasText(member, "member must contain text");
StringTokenizer tokenizer = new StringTokenizer(memberText, ",");
while (tokenizer.hasMoreTokens()) {
String s = tokenizer.nextToken();
this.members.add(s.trim());
}
return this;
}
/**
* Removes all members.
*
* Can safely be called when there are no members.
*
* @return the updated configuration
* @see #addMember(String)
*/
public TcpIpConfig clear() {
members.clear();
return this;
}
/**
* Gets the required member. If no required member is configured, null is returned.
*
* @return the requiredMember
* @see #setRequiredMember(String)
*/
public String getRequiredMember() {
return requiredMember;
}
/**
* Sets the required member. If a null value is passed, it means that there is no required member.
*
* With a required member configured, the cluster will only start up when this required member is up.
* Setting the required member can be tricky, since if that member doesn't come up, the cluster won't start.
*
* @param requiredMember the requiredMember to set
* @return TcpIpConfig the updated configuration
* @see #getRequiredMember()
*/
public TcpIpConfig setRequiredMember(final String requiredMember) {
this.requiredMember = requiredMember;
return this;
}
@Override
@SuppressWarnings({"checkstyle:cyclomaticcomplexity", "checkstyle:npathcomplexity"})
public final boolean equals(Object o) {
if (this == o) {
return true;
}
if (o == null || !(o instanceof TcpIpConfig)) {
return false;
}
TcpIpConfig that = (TcpIpConfig) o;
if (connectionTimeoutSeconds != that.connectionTimeoutSeconds) {
return false;
}
if (enabled != that.enabled) {
return false;
}
if (members != null ? !members.equals(that.members) : that.members != null) {
return false;
}
return requiredMember != null ? requiredMember.equals(that.requiredMember) : that.requiredMember == null;
}
@Override
public final int hashCode() {
int result = connectionTimeoutSeconds;
result = 31 * result + (enabled ? 1 : 0);
result = 31 * result + (members != null ? members.hashCode() : 0);
result = 31 * result + (requiredMember != null ? requiredMember.hashCode() : 0);
return result;
}
@Override
public String toString() {
return "TcpIpConfig [enabled=" + enabled
+ ", connectionTimeoutSeconds=" + connectionTimeoutSeconds
+ ", members=" + members
+ ", requiredMember=" + requiredMember
+ "]";
}
}