/*
* Copyright 2015 LINE Corporation
*
* LINE Corporation licenses this file to you 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.linecorp.armeria.client.pool;
import io.netty.channel.Channel;
import io.netty.util.concurrent.Future;
import io.netty.util.concurrent.Promise;
/**
* An asynchronous {@link Channel} pool that provides key-based acquisition and release.
*
* @param <K> the type of the key, usually {@link PoolKey}
*/
public interface KeyedChannelPool<K> extends KeyedPool<K, Channel> {
/**
* Finds the {@link KeyedChannelPool} that the specified {@link Channel} belongs to.
*
* @return {@code null} if the specified {@link Channel} does not belong to any {@link KeyedChannelPool}
*/
static <K> KeyedChannelPool<K> findPool(Channel channel) {
return KeyedChannelPoolUtil.findPool(channel);
}
/**
* Acquires a {@link Channel} with the specified {@code key}.
*/
@Override
Future<Channel> acquire(K key);
/**
* Acquires a {@link Channel} with the specified {@code key} and get notified with the specified
* {@link Promise}.
*/
@Override
Future<Channel> acquire(K key, Promise<Channel> promise);
/**
* Releases the acquired {@link Channel} to the pool.
*/
@Override
Future<Void> release(K key, Channel value);
/**
* Releases the acquired {@link Channel} to the pool and get notified with the specified {@link Promise}.
*/
@Override
Future<Void> release(K key, Channel value, Promise<Void> promise);
/**
* Closes all {@link Channel}s managed by this pool.
*/
@Override
void close();
}