/*
* Copyright (c) 2008-2014 MongoDB, Inc.
*
* 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.mongodb.connection;
import com.mongodb.ConnectionString;
import com.mongodb.annotations.Immutable;
import com.mongodb.annotations.NotThreadSafe;
import com.mongodb.event.ServerListener;
import com.mongodb.event.ServerMonitorListener;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.util.concurrent.TimeUnit;
import static com.mongodb.assertions.Assertions.notNull;
/**
* Settings relating to monitoring of each server.
*
* @since 3.0
*/
@Immutable
public class ServerSettings {
private final long heartbeatFrequencyMS;
private final long minHeartbeatFrequencyMS;
private final List<ServerListener> serverListeners;
private final List<ServerMonitorListener> serverMonitorListeners;
/**
* Creates a builder for ServerSettings.
*
* @return a new Builder for creating ServerSettings.
*/
public static Builder builder() {
return new Builder();
}
/**
* A builder for the settings.
*/
@NotThreadSafe
public static class Builder {
private long heartbeatFrequencyMS = 10000;
private long minHeartbeatFrequencyMS = 500;
private final List<ServerListener> serverListeners = new ArrayList<ServerListener>();
private final List<ServerMonitorListener> serverMonitorListeners = new ArrayList<ServerMonitorListener>();
/**
* Sets the frequency that the cluster monitor attempts to reach each server. The default value is 10 seconds.
*
* @param heartbeatFrequency the heartbeat frequency
* @param timeUnit the time unit
* @return this
*/
public Builder heartbeatFrequency(final long heartbeatFrequency, final TimeUnit timeUnit) {
this.heartbeatFrequencyMS = TimeUnit.MILLISECONDS.convert(heartbeatFrequency, timeUnit);
return this;
}
/**
* Sets the minimum heartbeat frequency. In the event that the driver has to frequently re-check a server's availability, it will
* wait at least this long since the previous check to avoid wasted effort. The default value is 500 milliseconds.
*
* @param minHeartbeatFrequency the minimum heartbeat frequency
* @param timeUnit the time unit
* @return this
*/
public Builder minHeartbeatFrequency(final long minHeartbeatFrequency, final TimeUnit timeUnit) {
this.minHeartbeatFrequencyMS = TimeUnit.MILLISECONDS.convert(minHeartbeatFrequency, timeUnit);
return this;
}
/**
* Add a server listener.
*
* @param serverListener the non-null server listener
* @return this
* @since 3.3
*/
public Builder addServerListener(final ServerListener serverListener) {
notNull("serverListener", serverListener);
serverListeners.add(serverListener);
return this;
}
/**
* Adds a server monitor listener.
*
* @param serverMonitorListener the non-null server monitor listener
* @return this
* @since 3.3
*/
public Builder addServerMonitorListener(final ServerMonitorListener serverMonitorListener) {
notNull("serverMonitorListener", serverMonitorListener);
serverMonitorListeners.add(serverMonitorListener);
return this;
}
/**
* Take the settings from the given ConnectionString and add them to the builder
*
* @param connectionString a URI containing details of how to connect to MongoDB
* @return this
* @since 3.3
*/
public Builder applyConnectionString(final ConnectionString connectionString) {
if (connectionString.getHeartbeatFrequency() != null) {
heartbeatFrequencyMS = connectionString.getHeartbeatFrequency();
}
return this;
}
/**
* Create a new ServerSettings from the settings applied to this builder.
*
* @return a ServerSettings with the given settings.
*/
public ServerSettings build() {
return new ServerSettings(this);
}
}
/**
* Gets the frequency that the cluster monitor attempts to reach each server. The default value is 10 seconds.
*
* @param timeUnit the time unit
* @return the heartbeat frequency
*/
public long getHeartbeatFrequency(final TimeUnit timeUnit) {
return timeUnit.convert(heartbeatFrequencyMS, TimeUnit.MILLISECONDS);
}
/**
* Gets the minimum heartbeat frequency. In the event that the driver has to frequently re-check a server's availability, it will wait
* at least this long since the previous check to avoid wasted effort. The default value is 500 milliseconds.
*
* @param timeUnit the time unit
* @return the heartbeat reconnect retry frequency
*/
public long getMinHeartbeatFrequency(final TimeUnit timeUnit) {
return timeUnit.convert(minHeartbeatFrequencyMS, TimeUnit.MILLISECONDS);
}
/**
* Gets the server listeners. The default value is an empty list.
*
* @return the server listeners
* @since 3.3
*/
public List<ServerListener> getServerListeners() {
return Collections.unmodifiableList(serverListeners);
}
/**
* Gets the server monitor listeners. The default value is an empty list.
*
* @return the server monitor listeners
* @since 3.3
*/
public List<ServerMonitorListener> getServerMonitorListeners() {
return Collections.unmodifiableList(serverMonitorListeners);
}
@Override
public boolean equals(final Object o) {
if (this == o) {
return true;
}
if (o == null || getClass() != o.getClass()) {
return false;
}
ServerSettings that = (ServerSettings) o;
if (heartbeatFrequencyMS != that.heartbeatFrequencyMS) {
return false;
}
if (minHeartbeatFrequencyMS != that.minHeartbeatFrequencyMS) {
return false;
}
if (!serverListeners.equals(that.serverListeners)) {
return false;
}
if (!serverMonitorListeners.equals(that.serverMonitorListeners)) {
return false;
}
return true;
}
@Override
public int hashCode() {
int result = (int) (heartbeatFrequencyMS ^ (heartbeatFrequencyMS >>> 32));
result = 31 * result + (int) (minHeartbeatFrequencyMS ^ (minHeartbeatFrequencyMS >>> 32));
result = 31 * result + serverListeners.hashCode();
result = 31 * result + serverMonitorListeners.hashCode();
return result;
}
@Override
public String toString() {
return "ServerSettings{"
+ "heartbeatFrequencyMS=" + heartbeatFrequencyMS
+ ", minHeartbeatFrequencyMS=" + minHeartbeatFrequencyMS
+ ", serverListeners='" + serverListeners + '\''
+ ", serverMonitorListeners='" + serverMonitorListeners + '\''
+ '}';
}
ServerSettings(final Builder builder) {
heartbeatFrequencyMS = builder.heartbeatFrequencyMS;
minHeartbeatFrequencyMS = builder.minHeartbeatFrequencyMS;
serverListeners = builder.serverListeners;
serverMonitorListeners = builder.serverMonitorListeners;
}
}