1 /* 2 * 3 * Copyright 2018 gRPC authors. 4 * 5 * Licensed under the Apache License, Version 2.0 (the "License"); 6 * you may not use this file except in compliance with the License. 7 * You may obtain a copy of the License at 8 * 9 * http://www.apache.org/licenses/LICENSE-2.0 10 * 11 * Unless required by applicable law or agreed to in writing, software 12 * distributed under the License is distributed on an "AS IS" BASIS, 13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 * 17 */ 18 19 #ifndef GRPC_CORE_EXT_FILTERS_CLIENT_CHANNEL_LOCAL_SUBCHANNEL_POOL_H 20 #define GRPC_CORE_EXT_FILTERS_CLIENT_CHANNEL_LOCAL_SUBCHANNEL_POOL_H 21 22 #include <grpc/support/port_platform.h> 23 24 #include <map> 25 26 #include "src/core/ext/filters/client_channel/subchannel_pool_interface.h" 27 28 namespace grpc_core { 29 30 // The local subchannel pool that is owned by a single channel. It doesn't 31 // support subchannel sharing with other channels by nature. Nor does it support 32 // subchannel retention when a subchannel is not used. The only real purpose of 33 // using this subchannel pool is to allow subchannel reuse within the channel 34 // when an incoming resolver update contains some addresses for which the 35 // channel has already created subchannels. 36 // Thread-unsafe. 37 class LocalSubchannelPool final : public SubchannelPoolInterface { 38 public: LocalSubchannelPool()39 LocalSubchannelPool() {} ~LocalSubchannelPool()40 ~LocalSubchannelPool() override {} 41 42 // Implements interface methods. 43 // Thread-unsafe. Intended to be invoked within the client_channel work 44 // serializer. 45 RefCountedPtr<Subchannel> RegisterSubchannel( 46 const SubchannelKey& key, RefCountedPtr<Subchannel> constructed) override; 47 void UnregisterSubchannel(const SubchannelKey& key, 48 Subchannel* subchannel) override; 49 RefCountedPtr<Subchannel> FindSubchannel(const SubchannelKey& key) override; 50 51 private: 52 // A map from subchannel key to subchannel. 53 std::map<SubchannelKey, Subchannel*> subchannel_map_; 54 }; 55 56 } // namespace grpc_core 57 58 #endif /* GRPC_CORE_EXT_FILTERS_CLIENT_CHANNEL_LOCAL_SUBCHANNEL_POOL_H */ 59