rippled
Classes | Public Member Functions | Static Public Member Functions | Public Attributes | Private Member Functions | Private Attributes | List of all members
ripple::PeerFinder::ManagerImp Class Reference
Inheritance diagram for ripple::PeerFinder::ManagerImp:
Inheritance graph
[legend]
Collaboration diagram for ripple::PeerFinder::ManagerImp:
Collaboration graph
[legend]

Classes

struct  Stats
 

Public Member Functions

 ManagerImp (boost::asio::io_service &io_service, clock_type &clock, beast::Journal journal, BasicConfig const &config, beast::insight::Collector::ptr const &collector)
 
 ~ManagerImp () override
 
void stop () override
 Transition to the stopped state, synchronously. More...
 
void setConfig (Config const &config) override
 Set the configuration for the manager. More...
 
Config config () override
 Returns the configuration for the manager. More...
 
void addFixedPeer (std::string const &name, std::vector< beast::IP::Endpoint > const &addresses) override
 Add a peer that should always be connected. More...
 
void addFallbackStrings (std::string const &name, std::vector< std::string > const &strings) override
 Add a set of strings as fallback IP::Endpoint sources. More...
 
void addFallbackURL (std::string const &name, std::string const &url)
 
std::shared_ptr< Slotnew_inbound_slot (beast::IP::Endpoint const &local_endpoint, beast::IP::Endpoint const &remote_endpoint) override
 Add a URL as a fallback location to obtain IP::Endpoint sources. More...
 
std::shared_ptr< Slotnew_outbound_slot (beast::IP::Endpoint const &remote_endpoint) override
 Create a new outbound slot with the specified remote endpoint. More...
 
void on_endpoints (std::shared_ptr< Slot > const &slot, Endpoints const &endpoints) override
 Called when mtENDPOINTS is received. More...
 
void on_closed (std::shared_ptr< Slot > const &slot) override
 Called when the slot is closed. More...
 
void on_failure (std::shared_ptr< Slot > const &slot) override
 Called when an outbound connection is deemed to have failed. More...
 
void onRedirects (boost::asio::ip::tcp::endpoint const &remote_address, std::vector< boost::asio::ip::tcp::endpoint > const &eps) override
 Called when we received redirect IPs from a busy peer. More...
 
bool onConnected (std::shared_ptr< Slot > const &slot, beast::IP::Endpoint const &local_endpoint) override
 Called when an outbound connection attempt succeeds. More...
 
Result activate (std::shared_ptr< Slot > const &slot, PublicKey const &key, bool reserved) override
 Request an active slot type. More...
 
std::vector< Endpointredirect (std::shared_ptr< Slot > const &slot) override
 Returns a set of endpoints suitable for redirection. More...
 
std::vector< beast::IP::Endpointautoconnect () override
 Return a set of addresses we should connect to. More...
 
void once_per_second () override
 Perform periodic activity. More...
 
std::vector< std::pair< std::shared_ptr< Slot >, std::vector< Endpoint > > > buildEndpointsForPeers () override
 
void start () override
 Transition to the started state, synchronously. More...
 
void onWrite (beast::PropertyStream::Map &map) override
 Subclass override. More...
 
std::string const & name () const
 Returns the name of this source. More...
 
void add (Source &source)
 Add a child source. More...
 
template<class Derived >
Derived * add (Derived *child)
 Add a child source by pointer. More...
 
void remove (Source &child)
 Remove a child source from this Source. More...
 
void removeAll ()
 Remove all child sources from this Source. More...
 
void write_one (PropertyStream &stream)
 Write only this Source to the stream. More...
 
void write (PropertyStream &stream)
 write this source and all its children recursively to the stream. More...
 
void write (PropertyStream &stream, std::string const &path)
 Parse the path and write the corresponding Source and optional children. More...
 
std::pair< Source *, bool > find (std::string path)
 Parse the dot-delimited Source path and return the result. More...
 
Sourcefind_one_deep (std::string const &name)
 
PropertyStream::Source * find_path (std::string path)
 
PropertyStream::Source * find_one (std::string const &name)
 

Static Public Member Functions

static bool peel_leading_slash (std::string *path)
 
static bool peel_trailing_slashstar (std::string *path)
 
static std::string peel_name (std::string *path)
 

Public Attributes

boost::asio::io_service & io_service_
 
std::optional< boost::asio::io_service::work > work_
 
clock_typem_clock
 
beast::Journal m_journal
 
StoreSqdb m_store
 
Checker< boost::asio::ip::tcp > checker_
 
Logic< decltype(checker_)> m_logic
 
BasicConfig const & m_config
 

Private Member Functions

void collect_metrics ()
 

Private Attributes

std::mutex m_statsMutex
 
Stats m_stats
 
const std::string m_name
 
std::recursive_mutex lock_
 
Item item_
 
Sourceparent_
 
List< Item > children_
 

Detailed Description

Definition at line 34 of file PeerfinderManager.cpp.

Constructor & Destructor Documentation

◆ ManagerImp()

ripple::PeerFinder::ManagerImp::ManagerImp ( boost::asio::io_service &  io_service,
clock_type clock,
beast::Journal  journal,
BasicConfig const &  config,
beast::insight::Collector::ptr const &  collector 
)

Definition at line 48 of file PeerfinderManager.cpp.

◆ ~ManagerImp()

ripple::PeerFinder::ManagerImp::~ManagerImp ( )
override

Definition at line 67 of file PeerfinderManager.cpp.

Member Function Documentation

◆ stop()

void ripple::PeerFinder::ManagerImp::stop ( )
overridevirtual

Transition to the stopped state, synchronously.

Implements ripple::PeerFinder::Manager.

Definition at line 73 of file PeerfinderManager.cpp.

◆ setConfig()

void ripple::PeerFinder::ManagerImp::setConfig ( Config const &  config)
overridevirtual

Set the configuration for the manager.

The new settings will be applied asynchronously. Thread safety: Can be called from any threads at any time.

Implements ripple::PeerFinder::Manager.

Definition at line 90 of file PeerfinderManager.cpp.

◆ config()

Config ripple::PeerFinder::ManagerImp::config ( )
overridevirtual

Returns the configuration for the manager.

Implements ripple::PeerFinder::Manager.

Definition at line 96 of file PeerfinderManager.cpp.

◆ addFixedPeer()

void ripple::PeerFinder::ManagerImp::addFixedPeer ( std::string const &  name,
std::vector< beast::IP::Endpoint > const &  addresses 
)
overridevirtual

Add a peer that should always be connected.

This is useful for maintaining a private cluster of peers. The string is the name as specified in the configuration file, along with the set of corresponding IP addresses.

Implements ripple::PeerFinder::Manager.

Definition at line 102 of file PeerfinderManager.cpp.

◆ addFallbackStrings()

void ripple::PeerFinder::ManagerImp::addFallbackStrings ( std::string const &  name,
std::vector< std::string > const &  strings 
)
overridevirtual

Add a set of strings as fallback IP::Endpoint sources.

Parameters
nameA label used for diagnostics.

Implements ripple::PeerFinder::Manager.

Definition at line 110 of file PeerfinderManager.cpp.

◆ addFallbackURL()

void ripple::PeerFinder::ManagerImp::addFallbackURL ( std::string const &  name,
std::string const &  url 
)

Definition at line 118 of file PeerfinderManager.cpp.

◆ new_inbound_slot()

std::shared_ptr<Slot> ripple::PeerFinder::ManagerImp::new_inbound_slot ( beast::IP::Endpoint const &  local_endpoint,
beast::IP::Endpoint const &  remote_endpoint 
)
overridevirtual

Add a URL as a fallback location to obtain IP::Endpoint sources.

Parameters
nameA label used for diagnostics. Create a new inbound slot with the specified remote endpoint. If nullptr is returned, then the slot could not be assigned. Usually this is because of a detected self-connection.

Implements ripple::PeerFinder::Manager.

Definition at line 126 of file PeerfinderManager.cpp.

◆ new_outbound_slot()

std::shared_ptr<Slot> ripple::PeerFinder::ManagerImp::new_outbound_slot ( beast::IP::Endpoint const &  remote_endpoint)
overridevirtual

Create a new outbound slot with the specified remote endpoint.

If nullptr is returned, then the slot could not be assigned. Usually this is because of a duplicate connection.

Implements ripple::PeerFinder::Manager.

Definition at line 134 of file PeerfinderManager.cpp.

◆ on_endpoints()

void ripple::PeerFinder::ManagerImp::on_endpoints ( std::shared_ptr< Slot > const &  slot,
Endpoints const &  endpoints 
)
overridevirtual

Called when mtENDPOINTS is received.

Implements ripple::PeerFinder::Manager.

Definition at line 140 of file PeerfinderManager.cpp.

◆ on_closed()

void ripple::PeerFinder::ManagerImp::on_closed ( std::shared_ptr< Slot > const &  slot)
overridevirtual

Called when the slot is closed.

This always happens when the socket is closed, unless the socket was canceled.

Implements ripple::PeerFinder::Manager.

Definition at line 148 of file PeerfinderManager.cpp.

◆ on_failure()

void ripple::PeerFinder::ManagerImp::on_failure ( std::shared_ptr< Slot > const &  slot)
overridevirtual

Called when an outbound connection is deemed to have failed.

Implements ripple::PeerFinder::Manager.

Definition at line 155 of file PeerfinderManager.cpp.

◆ onRedirects()

void ripple::PeerFinder::ManagerImp::onRedirects ( boost::asio::ip::tcp::endpoint const &  remote_address,
std::vector< boost::asio::ip::tcp::endpoint > const &  eps 
)
overridevirtual

Called when we received redirect IPs from a busy peer.

Implements ripple::PeerFinder::Manager.

Definition at line 162 of file PeerfinderManager.cpp.

◆ onConnected()

bool ripple::PeerFinder::ManagerImp::onConnected ( std::shared_ptr< Slot > const &  slot,
beast::IP::Endpoint const &  local_endpoint 
)
overridevirtual

Called when an outbound connection attempt succeeds.

The local endpoint must be valid. If the caller receives an error when retrieving the local endpoint from the socket, it should proceed as if the connection attempt failed by calling on_closed instead of on_connected.

Returns
true if the connection should be kept

Implements ripple::PeerFinder::Manager.

Definition at line 172 of file PeerfinderManager.cpp.

◆ activate()

Result ripple::PeerFinder::ManagerImp::activate ( std::shared_ptr< Slot > const &  slot,
PublicKey const &  key,
bool  reserved 
)
overridevirtual

Request an active slot type.

Implements ripple::PeerFinder::Manager.

Definition at line 181 of file PeerfinderManager.cpp.

◆ redirect()

std::vector<Endpoint> ripple::PeerFinder::ManagerImp::redirect ( std::shared_ptr< Slot > const &  slot)
overridevirtual

Returns a set of endpoints suitable for redirection.

Implements ripple::PeerFinder::Manager.

Definition at line 191 of file PeerfinderManager.cpp.

◆ autoconnect()

std::vector<beast::IP::Endpoint> ripple::PeerFinder::ManagerImp::autoconnect ( )
overridevirtual

Return a set of addresses we should connect to.

Implements ripple::PeerFinder::Manager.

Definition at line 198 of file PeerfinderManager.cpp.

◆ once_per_second()

void ripple::PeerFinder::ManagerImp::once_per_second ( )
overridevirtual

Perform periodic activity.

This should be called once per second.

Implements ripple::PeerFinder::Manager.

Definition at line 204 of file PeerfinderManager.cpp.

◆ buildEndpointsForPeers()

std::vector<std::pair<std::shared_ptr<Slot>, std::vector<Endpoint> > > ripple::PeerFinder::ManagerImp::buildEndpointsForPeers ( )
overridevirtual

Implements ripple::PeerFinder::Manager.

Definition at line 210 of file PeerfinderManager.cpp.

◆ start()

void ripple::PeerFinder::ManagerImp::start ( )
overridevirtual

Transition to the started state, synchronously.

Implements ripple::PeerFinder::Manager.

Definition at line 216 of file PeerfinderManager.cpp.

◆ onWrite()

void ripple::PeerFinder::ManagerImp::onWrite ( beast::PropertyStream::Map )
overridevirtual

Subclass override.

The default version does nothing.

Reimplemented from beast::PropertyStream::Source.

Definition at line 229 of file PeerfinderManager.cpp.

◆ collect_metrics()

void ripple::PeerFinder::ManagerImp::collect_metrics ( )
private

Definition at line 258 of file PeerfinderManager.cpp.

◆ name()

std::string const & beast::PropertyStream::Source::name ( ) const
inherited

Returns the name of this source.

Definition at line 190 of file beast_PropertyStream.cpp.

◆ add() [1/2]

void beast::PropertyStream::Source::add ( Source source)
inherited

Add a child source.

Definition at line 196 of file beast_PropertyStream.cpp.

◆ add() [2/2]

template<class Derived >
Derived* beast::PropertyStream::Source::add ( Derived *  child)
inherited

Add a child source by pointer.

The source pointer is returned so it can be used in ctor-initializers.

Definition at line 360 of file PropertyStream.h.

◆ remove()

void beast::PropertyStream::Source::remove ( Source child)
inherited

Remove a child source from this Source.

Definition at line 208 of file beast_PropertyStream.cpp.

◆ removeAll()

void beast::PropertyStream::Source::removeAll ( )
inherited

Remove all child sources from this Source.

Definition at line 220 of file beast_PropertyStream.cpp.

◆ write_one()

void beast::PropertyStream::Source::write_one ( PropertyStream stream)
inherited

Write only this Source to the stream.

Definition at line 233 of file beast_PropertyStream.cpp.

◆ write() [1/2]

void beast::PropertyStream::Source::write ( PropertyStream stream)
inherited

write this source and all its children recursively to the stream.

Definition at line 240 of file beast_PropertyStream.cpp.

◆ write() [2/2]

void beast::PropertyStream::Source::write ( PropertyStream stream,
std::string const &  path 
)
inherited

Parse the path and write the corresponding Source and optional children.

If the source is found, it is written. If the wildcard character '*' exists as the last character in the path, then all the children are written recursively.

Definition at line 252 of file beast_PropertyStream.cpp.

◆ find()

std::pair< PropertyStream::Source *, bool > beast::PropertyStream::Source::find ( std::string  path)
inherited

Parse the dot-delimited Source path and return the result.

The first value will be a pointer to the Source object corresponding to the given path. If no Source object exists, then the first value will be nullptr and the second value will be undefined. The second value is a boolean indicating whether or not the path string specifies the wildcard character '*' as the last character.

print statement examples "parent.child" prints child and all of its children "parent.child." start at the parent and print down to child "parent.grandchild" prints nothing- grandchild not direct discendent "parent.grandchild." starts at the parent and prints down to grandchild "parent.grandchild.*" starts at parent, print through grandchild children

Definition at line 266 of file beast_PropertyStream.cpp.

◆ find_one_deep()

PropertyStream::Source * beast::PropertyStream::Source::find_one_deep ( std::string const &  name)
inherited

Definition at line 333 of file beast_PropertyStream.cpp.

◆ find_path()

PropertyStream::Source * beast::PropertyStream::Source::find_path ( std::string  path)
inherited

Definition at line 350 of file beast_PropertyStream.cpp.

◆ find_one()

PropertyStream::Source * beast::PropertyStream::Source::find_one ( std::string const &  name)
inherited

Definition at line 368 of file beast_PropertyStream.cpp.

◆ peel_leading_slash()

bool beast::PropertyStream::Source::peel_leading_slash ( std::string path)
staticinherited

Definition at line 286 of file beast_PropertyStream.cpp.

◆ peel_trailing_slashstar()

bool beast::PropertyStream::Source::peel_trailing_slashstar ( std::string path)
staticinherited

Definition at line 297 of file beast_PropertyStream.cpp.

◆ peel_name()

std::string beast::PropertyStream::Source::peel_name ( std::string path)
staticinherited

Definition at line 313 of file beast_PropertyStream.cpp.

Member Data Documentation

◆ io_service_

boost::asio::io_service& ripple::PeerFinder::ManagerImp::io_service_

Definition at line 37 of file PeerfinderManager.cpp.

◆ work_

std::optional<boost::asio::io_service::work> ripple::PeerFinder::ManagerImp::work_

Definition at line 38 of file PeerfinderManager.cpp.

◆ m_clock

clock_type& ripple::PeerFinder::ManagerImp::m_clock

Definition at line 39 of file PeerfinderManager.cpp.

◆ m_journal

beast::Journal ripple::PeerFinder::ManagerImp::m_journal

Definition at line 40 of file PeerfinderManager.cpp.

◆ m_store

StoreSqdb ripple::PeerFinder::ManagerImp::m_store

Definition at line 41 of file PeerfinderManager.cpp.

◆ checker_

Checker<boost::asio::ip::tcp> ripple::PeerFinder::ManagerImp::checker_

Definition at line 42 of file PeerfinderManager.cpp.

◆ m_logic

Logic<decltype(checker_)> ripple::PeerFinder::ManagerImp::m_logic

Definition at line 43 of file PeerfinderManager.cpp.

◆ m_config

BasicConfig const& ripple::PeerFinder::ManagerImp::m_config

Definition at line 44 of file PeerfinderManager.cpp.

◆ m_statsMutex

std::mutex ripple::PeerFinder::ManagerImp::m_statsMutex
private

Definition at line 254 of file PeerfinderManager.cpp.

◆ m_stats

Stats ripple::PeerFinder::ManagerImp::m_stats
private

Definition at line 255 of file PeerfinderManager.cpp.

◆ m_name

const std::string beast::PropertyStream::Source::m_name
privateinherited

Definition at line 333 of file PropertyStream.h.

◆ lock_

std::recursive_mutex beast::PropertyStream::Source::lock_
privateinherited

Definition at line 334 of file PropertyStream.h.

◆ item_

Item beast::PropertyStream::Source::item_
privateinherited

Definition at line 335 of file PropertyStream.h.

◆ parent_

Source* beast::PropertyStream::Source::parent_
privateinherited

Definition at line 336 of file PropertyStream.h.

◆ children_

List<Item> beast::PropertyStream::Source::children_
privateinherited

Definition at line 337 of file PropertyStream.h.