userver: components::ComponentContext Class Reference
Loading...
Searching...
No Matches
components::ComponentContext Class Referencefinal

#include <userver/components/component_context.hpp>

Detailed Description

Class to retrieve other components.

Only the const member functions of this class are meant for usage in component constructor (because of that this class is always passed as a const reference to the constructors).

For usage outside of the component constructor see components::State

See also
Components
Examples
components/component_sample_test.cpp, components/component_sample_test.hpp, postgresql/functional_tests/basic_chaos/postgres_service.cpp, samples/config_service/config_service.cpp, samples/flatbuf_service/flatbuf_service.cpp, samples/grpc_middleware_service/src/middlewares/client/component.cpp, samples/grpc_middleware_service/src/middlewares/client/component.hpp, samples/grpc_middleware_service/src/middlewares/client/middleware.cpp, samples/grpc_middleware_service/src/middlewares/client/middleware.hpp, samples/grpc_middleware_service/src/middlewares/server/component.cpp, samples/grpc_middleware_service/src/middlewares/server/component.hpp, samples/grpc_service/src/greeter_service.cpp, samples/grpc_service/src/greeter_service.hpp, samples/http_caching/http_caching.cpp, samples/kafka_service/src/consumer_handler.hpp, samples/kafka_service/src/producer_handler.cpp, samples/kafka_service/src/producer_handler.hpp, samples/mongo_service/mongo_service.cpp, samples/postgres_service/postgres_service.cpp, samples/redis_service/redis_service.cpp, samples/s3api/src/s3api_client.cpp, samples/s3api/src/s3api_client.hpp, samples/tcp_full_duplex_service/tcp_full_duplex_service.cpp, samples/tcp_service/tcp_service.cpp, samples/testsuite-support/src/metrics.cpp, samples/testsuite-support/src/metrics.hpp, and samples/testsuite-support/src/tasks.cpp.

Definition at line 74 of file component_context.hpp.

Public Member Functions

template<typename T >
T & FindComponent () const
 Finds a component of type T with specified name (if any) and returns the component after it was initialized.
 
template<typename T >
T & FindComponent (std::string_view name) const
 
template<typename T >
T & FindComponent (std::string_view={})
 
template<typename T >
T * FindComponentOptional () const
 If there's no component with specified type and name return nullptr; otherwise behaves as FindComponent().
 
template<typename T >
T * FindComponentOptional (std::string_view name) const
 
template<typename T >
T & FindComponentOptional (std::string_view={})
 
engine::TaskProcessor & GetTaskProcessor (const std::string &name) const
 Returns an engine::TaskProcessor with the specified name.
 
template<typename T >
engine::TaskProcessor & GetTaskProcessor (const T &)
 
const Manager & GetManager () const
 

Member Function Documentation

◆ FindComponent() [1/3]

template<typename T >
T & components::ComponentContext::FindComponent ( ) const
inline

Finds a component of type T with specified name (if any) and returns the component after it was initialized.

Can only be called from other component's constructor in a task where that constructor was called. May block and asynchronously wait for the creation of the requested component.

Exceptions
ComponentsLoadCancelledExceptionif components loading was cancelled due to errors in the creation of other component.
std::runtime_errorif component missing in component_list was requested.
Examples
components/component_sample_test.cpp, postgresql/functional_tests/basic_chaos/postgres_service.cpp, samples/kafka_service/src/producer_handler.cpp, samples/mongo_service/mongo_service.cpp, samples/s3api/src/s3api_client.cpp, and samples/testsuite-support/src/metrics.cpp.

Definition at line 88 of file component_context.hpp.

◆ FindComponent() [2/3]

template<typename T >
T & components::ComponentContext::FindComponent ( std::string_view name) const
inline

Definition at line 94 of file component_context.hpp.

◆ FindComponent() [3/3]

template<typename T >
T & components::ComponentContext::FindComponent ( std::string_view = {})
inline

Definition at line 109 of file component_context.hpp.

◆ FindComponentOptional() [1/3]

template<typename T >
T * components::ComponentContext::FindComponentOptional ( ) const
inline

If there's no component with specified type and name return nullptr; otherwise behaves as FindComponent().

Definition at line 116 of file component_context.hpp.

◆ FindComponentOptional() [2/3]

template<typename T >
T * components::ComponentContext::FindComponentOptional ( std::string_view name) const
inline

Definition at line 122 of file component_context.hpp.

◆ FindComponentOptional() [3/3]

template<typename T >
T & components::ComponentContext::FindComponentOptional ( std::string_view = {})
inline

Definition at line 130 of file component_context.hpp.

◆ GetTaskProcessor()

template<typename T >
engine::TaskProcessor & components::ComponentContext::GetTaskProcessor ( const T & )
inline

Definition at line 138 of file component_context.hpp.

Friends And Related Symbol Documentation

◆ Manager

friend class Manager
friend

Definition at line 166 of file component_context.hpp.

◆ State

friend class State
friend

Definition at line 167 of file component_context.hpp.


The documentation for this class was generated from the following file: