/*
* Copyright 2008-present 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.binding;
import com.mongodb.ReadConcern;
import com.mongodb.ReadPreference;
import com.mongodb.connection.Cluster;
import com.mongodb.connection.Connection;
import com.mongodb.connection.Server;
import com.mongodb.connection.ServerDescription;
import com.mongodb.internal.binding.AbstractReferenceCounted;
import com.mongodb.internal.binding.ClusterAwareReadWriteBinding;
import com.mongodb.internal.connection.ReadConcernAwareNoOpSessionContext;
import com.mongodb.selector.ReadPreferenceServerSelector;
import com.mongodb.selector.ServerSelector;
import com.mongodb.selector.WritableServerSelector;
import com.mongodb.session.SessionContext;
import static com.mongodb.assertions.Assertions.notNull;
A simple ReadWriteBinding implementation that supplies write connection sources bound to a possibly different primary each time, and a
read connection source bound to a possible different server each time.
Since: 3.0
/**
* A simple ReadWriteBinding implementation that supplies write connection sources bound to a possibly different primary each time, and a
* read connection source bound to a possible different server each time.
*
* @since 3.0
*/
@Deprecated
public class ClusterBinding extends AbstractReferenceCounted implements ClusterAwareReadWriteBinding {
private final Cluster cluster;
private final ReadPreference readPreference;
private final ReadConcern readConcern;
Creates an instance.
Params: - cluster – a non-null Cluster which will be used to select a server to bind to
- readPreference – a non-null ReadPreference for read operations
Deprecated: Prefer ClusterBinding(Cluster, ReadPreference, ReadConcern)
/**
* Creates an instance.
* @param cluster a non-null Cluster which will be used to select a server to bind to
* @param readPreference a non-null ReadPreference for read operations
* @deprecated Prefer {@link #ClusterBinding(Cluster, ReadPreference, ReadConcern)}
*/
@Deprecated
public ClusterBinding(final Cluster cluster, final ReadPreference readPreference) {
this(cluster, readPreference, ReadConcern.DEFAULT);
}
Creates an instance.
Params: - cluster – a non-null Cluster which will be used to select a server to bind to
- readPreference – a non-null ReadPreference for read operations
- readConcern – a non-null read concern
Since: 3.8
/**
* Creates an instance.
* @param cluster a non-null Cluster which will be used to select a server to bind to
* @param readPreference a non-null ReadPreference for read operations
* @param readConcern a non-null read concern
* @since 3.8
*/
public ClusterBinding(final Cluster cluster, final ReadPreference readPreference, final ReadConcern readConcern) {
this.cluster = notNull("cluster", cluster);
this.readPreference = notNull("readPreference", readPreference);
this.readConcern = notNull("readConcern", readConcern);
}
Return the cluster.
Returns: the cluster Since: 3.11
/**
* Return the cluster.
* @return the cluster
* @since 3.11
*/
public Cluster getCluster() {
return cluster;
}
@Override
public ReadWriteBinding retain() {
super.retain();
return this;
}
@Override
public ReadPreference getReadPreference() {
return readPreference;
}
@Override
public ConnectionSource getReadConnectionSource() {
return new ClusterBindingConnectionSource(new ReadPreferenceServerSelector(readPreference));
}
@Override
public SessionContext getSessionContext() {
return new ReadConcernAwareNoOpSessionContext(readConcern);
}
@Override
public ConnectionSource getWriteConnectionSource() {
return new ClusterBindingConnectionSource(new WritableServerSelector());
}
private final class ClusterBindingConnectionSource extends AbstractReferenceCounted implements ConnectionSource {
private final Server server;
private ClusterBindingConnectionSource(final ServerSelector serverSelector) {
this.server = cluster.selectServer(serverSelector);
ClusterBinding.this.retain();
}
@Override
public ServerDescription getServerDescription() {
return server.getDescription();
}
@Override
public SessionContext getSessionContext() {
return new ReadConcernAwareNoOpSessionContext(readConcern);
}
@Override
public Connection getConnection() {
return server.getConnection();
}
public ConnectionSource retain() {
super.retain();
ClusterBinding.this.retain();
return this;
}
@Override
public void release() {
super.release();
ClusterBinding.this.release();
}
}
}