// Copyright 2021 gRPC authors. // // 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. #ifndef GRPC_SRC_CORE_LIB_PROMISE_CONTEXT_H #define GRPC_SRC_CORE_LIB_PROMISE_CONTEXT_H #include #include "absl/log/check.h" #include "absl/meta/type_traits.h" #include #include #include "src/core/lib/gprpp/down_cast.h" namespace grpc_core { // To avoid accidentally creating context types, we require an explicit // specialization of this template per context type. The specialization need // not contain any members, only exist. // The reason for avoiding this is that context types each use a thread local. template struct ContextType; // Some contexts can be subclassed. If the subclass is set as that context // then GetContext() will return the base, and GetContext() will // DownCast to the derived type. // Specializations of this type should be created for each derived type, and // should have a single using statement Base pointing to the derived base class. // Example: // class SomeContext {}; // class SomeDerivedContext : public SomeContext {}; // template <> struct ContextType {}; // template <> struct ContextSubclass { // using Base = SomeContext; // }; template struct ContextSubclass; namespace promise_detail { template class Context; template class ThreadLocalContext : public ContextType { public: explicit ThreadLocalContext(T* p) : old_(current_) { current_ = p; } ~ThreadLocalContext() { current_ = old_; } ThreadLocalContext(const ThreadLocalContext&) = delete; ThreadLocalContext& operator=(const ThreadLocalContext&) = delete; static T* get() { return current_; } private: T* const old_; static thread_local T* current_; }; template thread_local T* ThreadLocalContext::current_; template class Context())>> : public ThreadLocalContext { using ThreadLocalContext::ThreadLocalContext; }; template class Context::Base>> : public Context::Base> { public: using Context::Base>::Context; static T* get() { return DownCast(Context::Base>::get()); } }; template class WithContext { public: WithContext(F f, T* context) : context_(context), f_(std::move(f)) {} decltype(std::declval()()) operator()() { Context ctx(context_); return f_(); } private: T* context_; F f_; }; } // namespace promise_detail // Return true if a context of type T is currently active. template bool HasContext() { return promise_detail::Context::get() != nullptr; } // Retrieve the current value of a context, or abort if the value is unset. template T* GetContext() { auto* p = promise_detail::Context::get(); CHECK_NE(p, nullptr); return p; } // Retrieve the current value of a context, or nullptr if the value is unset. template T* MaybeGetContext() { return promise_detail::Context::get(); } // Given a promise and a context, return a promise that has that context set. template promise_detail::WithContext WithContext(F f, T* context) { return promise_detail::WithContext(std::move(f), context); } } // namespace grpc_core #endif // GRPC_SRC_CORE_LIB_PROMISE_CONTEXT_H