com.netflix.dyno.connectionpool.ConnectionPool Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of dyno-core Show documentation
dyno-core
There is a newer version: 1.9.1
/*******************************************************************************
 * Copyright 2011 Netflix
 *
 * 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.netflix.dyno.connectionpool;

import java.util.Collection;
import java.util.List;
import java.util.concurrent.Future;

import com.netflix.dyno.connectionpool.exception.DynoException;

/**
 * Base interface for a pool of connections. A concrete connection pool will
 * track hosts in a cluster.
 *
 * @param 
 * @author poberai
 */
public interface ConnectionPool {

    /**
     * Add a host to the connection pool.
     *
     * @param host
     * @throws DynoException
     * @returns True if host was added or false if host already exists
     */
    boolean addHost(Host host);

    /**
     * Remove a host from the connection pool.
     *
     * @param host
     * @throws DynoException
     * @returns True if host was added or false if host already exists
     */
    boolean removeHost(Host host);

    /**
     * @param host
     * @return Return true if the host is up
     */
    boolean isHostUp(Host host);

    /**
     * @param host
     * @return Return true if host is contained within the connection pool
     */
    boolean hasHost(Host host);

    /**
     * @return Return list of active hosts on which connections can be created
     */
    List> getActivePools();

    /**
     * @return Get all pools
     */
    List> getPools();

    /**
     * Set the complete set of hosts in the ring
     *
     * @param activeHosts
     * @param inactiveHosts
     */
    Future updateHosts(Collection activeHosts, Collection inactiveHosts);

    /**
     * @param host
     * @return Return an immutable connection pool for this host
     */
    HostConnectionPool getHostPool(Host host);

    /**
     * Execute an operation with failover within the context of the connection
     * pool. The operation will only fail over for connection pool errors and
     * not application errors.
     *
     * @param 
     * @param op
     * @throws DynoException
     */
     OperationResult executeWithFailover(Operation op) throws DynoException;

    /**
     * Scatter gather style operation
     *
     * @param op
     * @return Collection>
     * @throws DynoException
     */
     Collection> executeWithRing(TokenRackMapper tokenRackMapper, Operation op) throws DynoException;

    /**
     * Execute an operation asynchronously.
     *
     * @param op
     * @return ListenableFuture>
     * @throws DynoException
     */
     ListenableFuture> executeAsync(AsyncOperation op) throws DynoException;

    /**
     * Shut down the connection pool and terminate all existing connections
     */
    void shutdown();

    /**
     * Setup the connection pool and start any maintenance threads. This includes priming connections
     * to server hosts.
     */
    Future start() throws DynoException;

    /**
     * Construct the connection pool but do not start any threads. The pool will poll the {@link HostSupplier}
     * once per minute and will start upon finding active hosts.
     * 
     * Note that an {@link IllegalStateException} will be thrown if the connection pool has been successfully
     * started.
     * 
     * This api is utilized by DynoJedisClient and DynoRedissonClient when starting the connection pool unless
     * {@link ConnectionPoolConfiguration#getFailOnStartupIfNoHosts()} is set to true.
     */
    void idle();

    /**
     * Retrieve the runtime configuration of the connection pool instance.
     *
     * @return ConnectionPoolConfiguration
     */
    ConnectionPoolConfiguration getConfiguration();

    /**
     * Retrieve an instance of {@link HealthTracker}
     */
    HealthTracker getHealthTracker();

    boolean isIdle();

}