rippled
Classes | Public Member Functions | Protected Types | Protected Member Functions | Protected Attributes | Private Member Functions | Static Private Member Functions | Private Attributes | Friends | List of all members
ripple::LedgerReplayTask Class Referencefinal
Inheritance diagram for ripple::LedgerReplayTask:
Inheritance graph
[legend]
Collaboration diagram for ripple::LedgerReplayTask:
Collaboration graph
[legend]

Classes

class  TaskParameter
 

Public Member Functions

 LedgerReplayTask (Application &app, InboundLedgers &inboundLedgers, LedgerReplayer &replayer, std::shared_ptr< SkipListAcquire > &skipListAcquirer, TaskParameter &&parameter)
 Constructor. More...
 
 ~LedgerReplayTask ()
 
void init ()
 Start the task. More...
 
void addDelta (std::shared_ptr< LedgerDeltaAcquire > const &delta)
 add a new LedgerDeltaAcquire subtask More...
 
TaskParameter const & getTaskParameter () const
 
bool finished () const
 return if the task is finished More...
 
virtual void cancel ()
 Cancel the task by marking it as failed if the task is not done. More...
 
shared_from_this (T... args)
 
weak_from_this (T... args)
 

Protected Types

using ScopedLockType = std::unique_lock< std::recursive_mutex >
 

Protected Member Functions

void setTimer (ScopedLockType &)
 Schedule a call to queueJob() after mTimerInterval. More...
 
void queueJob (ScopedLockType &)
 Queue a job to call invokeOnTimer(). More...
 
bool isDone () const
 

Protected Attributes

Applicationapp_
 
beast::Journal journal_
 
std::recursive_mutex mtx_
 
const uint256 hash_
 The hash of the object (in practice, always a ledger) we are trying to fetch. More...
 
int timeouts_
 
bool complete_
 
bool failed_
 
bool progress_
 Whether forward progress has been made. More...
 
std::chrono::milliseconds timerInterval_
 The minimum time to wait between calls to execute(). More...
 
QueueJobParameter queueJobParameter_
 

Private Member Functions

void onTimer (bool progress, ScopedLockType &sl) override
 Hook called from invokeOnTimer(). More...
 
std::weak_ptr< TimeoutCounterpmDowncast () override
 Return a weak pointer to this. More...
 
void updateSkipList (uint256 const &hash, std::uint32_t seq, std::vector< uint256 > const &sList)
 Update this task (by a SkipListAcquire subtask) when skip list is ready. More...
 
void deltaReady (uint256 const &deltaHash)
 Notify this task (by a LedgerDeltaAcquire subtask) that a delta is ready. More...
 
void trigger (ScopedLockType &sl)
 Trigger another round. More...
 
void tryAdvance (ScopedLockType &sl)
 Try to build more ledgers. More...
 
void invokeOnTimer ()
 Calls onTimer() if in the right state. More...
 

Static Private Member Functions

static auto & getCounter () noexcept
 

Private Attributes

InboundLedgersinboundLedgers_
 
LedgerReplayerreplayer_
 
TaskParameter parameter_
 
uint32_t maxTimeouts_
 
std::shared_ptr< SkipListAcquireskipListAcquirer_
 
std::shared_ptr< Ledger const > parent_ = {}
 
uint32_t deltaToBuild_ = 0
 
std::vector< std::shared_ptr< LedgerDeltaAcquire > > deltas_
 
boost::asio::basic_waitable_timer< std::chrono::steady_clocktimer_
 

Friends

class test::LedgerReplayClient
 

Detailed Description

Definition at line 40 of file LedgerReplayTask.h.

Member Typedef Documentation

◆ ScopedLockType

Definition at line 81 of file TimeoutCounter.h.

Constructor & Destructor Documentation

◆ LedgerReplayTask()

ripple::LedgerReplayTask::LedgerReplayTask ( Application app,
InboundLedgers inboundLedgers,
LedgerReplayer replayer,
std::shared_ptr< SkipListAcquire > &  skipListAcquirer,
TaskParameter &&  parameter 
)

Constructor.

Parameters
appApplication reference
inboundLedgersInboundLedgers reference
replayerLedgerReplayer reference
skipListAcquirershared_ptr of SkipListAcquire subtask, to make sure it will not be destroyed.
parameterparameter of the task

Definition at line 84 of file LedgerReplayTask.cpp.

◆ ~LedgerReplayTask()

ripple::LedgerReplayTask::~LedgerReplayTask ( )

Definition at line 110 of file LedgerReplayTask.cpp.

Member Function Documentation

◆ init()

void ripple::LedgerReplayTask::init ( )

Start the task.

Definition at line 116 of file LedgerReplayTask.cpp.

◆ addDelta()

void ripple::LedgerReplayTask::addDelta ( std::shared_ptr< LedgerDeltaAcquire > const &  delta)

add a new LedgerDeltaAcquire subtask

Parameters
deltathe new LedgerDeltaAcquire subtask
Note
the LedgerDeltaAcquire subtasks must be added in order

Definition at line 272 of file LedgerReplayTask.cpp.

◆ getTaskParameter()

TaskParameter const& ripple::LedgerReplayTask::getTaskParameter ( ) const

Definition at line 123 of file LedgerReplayTask.h.

◆ finished()

bool ripple::LedgerReplayTask::finished ( ) const

return if the task is finished

Definition at line 300 of file LedgerReplayTask.cpp.

◆ onTimer()

void ripple::LedgerReplayTask::onTimer ( bool  progress,
ScopedLockType  
)
overrideprivatevirtual

Hook called from invokeOnTimer().

Implements ripple::TimeoutCounter.

Definition at line 250 of file LedgerReplayTask.cpp.

◆ pmDowncast()

std::weak_ptr< TimeoutCounter > ripple::LedgerReplayTask::pmDowncast ( )
overrideprivatevirtual

Return a weak pointer to this.

Implements ripple::TimeoutCounter.

Definition at line 266 of file LedgerReplayTask.cpp.

◆ updateSkipList()

void ripple::LedgerReplayTask::updateSkipList ( uint256 const &  hash,
std::uint32_t  seq,
std::vector< uint256 > const &  sList 
)
private

Update this task (by a SkipListAcquire subtask) when skip list is ready.

Parameters
hashhash of the ledger that has the skip list
seqsequence number of the ledger that has the skip list
sListskip list

Definition at line 226 of file LedgerReplayTask.cpp.

◆ deltaReady()

void ripple::LedgerReplayTask::deltaReady ( uint256 const &  deltaHash)
private

Notify this task (by a LedgerDeltaAcquire subtask) that a delta is ready.

Parameters
deltaHashledger hash of the delta

Definition at line 174 of file LedgerReplayTask.cpp.

◆ trigger()

void ripple::LedgerReplayTask::trigger ( ScopedLockType sl)
private

Trigger another round.

Parameters
sllock. this function must be called with the lock

Definition at line 146 of file LedgerReplayTask.cpp.

◆ tryAdvance()

void ripple::LedgerReplayTask::tryAdvance ( ScopedLockType sl)
private

Try to build more ledgers.

Parameters
sllock. this function must be called with the lock

Definition at line 184 of file LedgerReplayTask.cpp.

◆ cancel()

void ripple::TimeoutCounter::cancel ( )
virtualinherited

Cancel the task by marking it as failed if the task is not done.

Note
this function does not attempt to cancel the scheduled timer or to remove the queued job if any. When the timer expires or the queued job starts, however, the code will see that the task is done and returns immediately, if it can lock the weak pointer of the task.

Definition at line 118 of file TimeoutCounter.cpp.

◆ setTimer()

void ripple::TimeoutCounter::setTimer ( ScopedLockType sl)
protectedinherited

Schedule a call to queueJob() after mTimerInterval.

Definition at line 50 of file TimeoutCounter.cpp.

◆ queueJob()

void ripple::TimeoutCounter::queueJob ( ScopedLockType sl)
protectedinherited

Queue a job to call invokeOnTimer().

Definition at line 69 of file TimeoutCounter.cpp.

◆ isDone()

bool ripple::TimeoutCounter::isDone ( ) const
protectedinherited

Definition at line 116 of file TimeoutCounter.h.

◆ invokeOnTimer()

void ripple::TimeoutCounter::invokeOnTimer ( )
privateinherited

Calls onTimer() if in the right state.

Only called by queueJob().

Definition at line 93 of file TimeoutCounter.cpp.

◆ getCounter()

static auto& ripple::CountedObject< LedgerReplayTask >::getCounter
staticprivatenoexceptinherited

Definition at line 128 of file CountedObject.h.

Friends And Related Function Documentation

◆ test::LedgerReplayClient

friend class test::LedgerReplayClient
friend

Definition at line 181 of file LedgerReplayTask.h.

Member Data Documentation

◆ inboundLedgers_

InboundLedgers& ripple::LedgerReplayTask::inboundLedgers_
private

Definition at line 172 of file LedgerReplayTask.h.

◆ replayer_

LedgerReplayer& ripple::LedgerReplayTask::replayer_
private

Definition at line 173 of file LedgerReplayTask.h.

◆ parameter_

TaskParameter ripple::LedgerReplayTask::parameter_
private

Definition at line 174 of file LedgerReplayTask.h.

◆ maxTimeouts_

uint32_t ripple::LedgerReplayTask::maxTimeouts_
private

Definition at line 175 of file LedgerReplayTask.h.

◆ skipListAcquirer_

std::shared_ptr<SkipListAcquire> ripple::LedgerReplayTask::skipListAcquirer_
private

Definition at line 176 of file LedgerReplayTask.h.

◆ parent_

std::shared_ptr<Ledger const> ripple::LedgerReplayTask::parent_ = {}
private

Definition at line 177 of file LedgerReplayTask.h.

◆ deltaToBuild_

uint32_t ripple::LedgerReplayTask::deltaToBuild_ = 0
private

Definition at line 178 of file LedgerReplayTask.h.

◆ deltas_

std::vector<std::shared_ptr<LedgerDeltaAcquire> > ripple::LedgerReplayTask::deltas_
private

Definition at line 179 of file LedgerReplayTask.h.

◆ app_

Application& ripple::TimeoutCounter::app_
protectedinherited

Definition at line 123 of file TimeoutCounter.h.

◆ journal_

beast::Journal ripple::TimeoutCounter::journal_
protectedinherited

Definition at line 124 of file TimeoutCounter.h.

◆ mtx_

std::recursive_mutex ripple::TimeoutCounter::mtx_
mutableprotectedinherited

Definition at line 125 of file TimeoutCounter.h.

◆ hash_

const uint256 ripple::TimeoutCounter::hash_
protectedinherited

The hash of the object (in practice, always a ledger) we are trying to fetch.

Definition at line 129 of file TimeoutCounter.h.

◆ timeouts_

int ripple::TimeoutCounter::timeouts_
protectedinherited

Definition at line 130 of file TimeoutCounter.h.

◆ complete_

bool ripple::TimeoutCounter::complete_
protectedinherited

Definition at line 131 of file TimeoutCounter.h.

◆ failed_

bool ripple::TimeoutCounter::failed_
protectedinherited

Definition at line 132 of file TimeoutCounter.h.

◆ progress_

bool ripple::TimeoutCounter::progress_
protectedinherited

Whether forward progress has been made.

Definition at line 134 of file TimeoutCounter.h.

◆ timerInterval_

std::chrono::milliseconds ripple::TimeoutCounter::timerInterval_
protectedinherited

The minimum time to wait between calls to execute().

Definition at line 136 of file TimeoutCounter.h.

◆ queueJobParameter_

QueueJobParameter ripple::TimeoutCounter::queueJobParameter_
protectedinherited

Definition at line 138 of file TimeoutCounter.h.

◆ timer_

boost::asio::basic_waitable_timer<std::chrono::steady_clock> ripple::TimeoutCounter::timer_
privateinherited

Definition at line 147 of file TimeoutCounter.h.