1 // 2 // 3 // Copyright 2017 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_SRC_CORE_LIB_HANDSHAKER_PROXY_MAPPER_H 20 #define GRPC_SRC_CORE_LIB_HANDSHAKER_PROXY_MAPPER_H 21 22 #include <grpc/support/port_platform.h> 23 24 #include <string> 25 26 #include "absl/strings/string_view.h" 27 #include "absl/types/optional.h" 28 29 #include "src/core/lib/channel/channel_args.h" 30 #include "src/core/lib/iomgr/resolved_address.h" 31 32 namespace grpc_core { 33 34 class ProxyMapperInterface { 35 public: 36 virtual ~ProxyMapperInterface() = default; 37 38 /// Determines the proxy name to resolve for \a server_uri. 39 /// If no proxy is needed, returns nullopt. 40 /// Otherwise, updates \a args and returns the name to resolve. 41 virtual absl::optional<std::string> MapName(absl::string_view server_uri, 42 ChannelArgs* args) = 0; 43 44 /// Determines the proxy address to use to contact \a address. 45 /// If no proxy is needed, returns nullopt. 46 /// Otherwise, updates \a args, and returns a new address. 47 virtual absl::optional<grpc_resolved_address> MapAddress( 48 const grpc_resolved_address& address, ChannelArgs* args) = 0; 49 }; 50 51 } // namespace grpc_core 52 53 #endif // GRPC_SRC_CORE_LIB_HANDSHAKER_PROXY_MAPPER_H 54