LogViewer
A modern log viewer with AI-assisted analysis (Qt 6)
Loading...
Searching...
No Matches
mvc::IModelObservable Class Reference

Improved IModel with weak_ptr observers for automatic cleanup. More...

#include <IModelObservable.hpp>

Inheritance diagram for mvc::IModelObservable:
Inheritance graph
Collaboration diagram for mvc::IModelObservable:
Collaboration graph

Public Types

using ViewPtr = std::shared_ptr< IView >
 Shared pointer type for views.
 

Public Member Functions

virtual ~IModelObservable ()=default
 
void RegisterView (ViewPtr view)
 Registers a view as observer with automatic cleanup.
 
void UnregisterView (const IView *view)
 Unregisters a view from observations.
 
size_t GetViewCount () const
 Gets count of currently active observers.
 

Protected Member Functions

void NotifyDataChanged ()
 Notifies all registered views that data has changed.
 
void NotifyCurrentIndexUpdated (int index)
 Notifies all views of current item index change.
 
void CleanupDeadObservers ()
 Manually triggers cleanup of dead observers.
 

Private Member Functions

void CleanupDeadViews ()
 Internal method to clean up expired weak pointers.
 

Private Attributes

std::shared_mutex m_viewsMutex
 Storage for observer weak pointers - automatically manages cleanup.
 
std::vector< std::weak_ptr< IView > > m_weakViews
 

Detailed Description

Improved IModel with weak_ptr observers for automatic cleanup.

This interface replaces the raw pointer-based observer pattern with weak_ptr-based observers that automatically detect and remove destroyed views. It provides thread-safe observer notifications with reader-writer locking.

Thread Safety
All observer management and notification methods are thread-safe using shared_mutex for concurrent reads and exclusive writes.
Lifetime Management
  • Views register as shared_ptr, internally stored as weak_ptr
  • Destroyed views are automatically detected and cleaned up
  • No dangling pointers possible
  • Views control their own lifetime via shared_ptr reference counting
Migration Guide
Old API (deprecated):
model->RegisterOndDataUpdated(view.get()); // Raw pointer

New API (recommended):

auto view = std::make_shared<MyView>();
model->RegisterView(view); // Shared pointer - safe!
See also
IModel for backward compatibility interface

Member Typedef Documentation

◆ ViewPtr

using mvc::IModelObservable::ViewPtr = std::shared_ptr<IView>

Shared pointer type for views.

Constructor & Destructor Documentation

◆ ~IModelObservable()

virtual mvc::IModelObservable::~IModelObservable ( )
virtualdefault

Member Function Documentation

◆ CleanupDeadObservers()

void mvc::IModelObservable::CleanupDeadObservers ( )
inlineprotected

Manually triggers cleanup of dead observers.

Can be called explicitly to prune expired weak_ptr entries. Internally, cleanup is also performed on every RegisterView and NotifyDataChanged call.

Here is the call graph for this function:

◆ CleanupDeadViews()

void mvc::IModelObservable::CleanupDeadViews ( )
inlineprivate

Internal method to clean up expired weak pointers.

Called during registration and notifications to remove dead observers. Must be called with unique_lock held.

Here is the call graph for this function:
Here is the caller graph for this function:

◆ GetViewCount()

size_t mvc::IModelObservable::GetViewCount ( ) const
inline

Gets count of currently active observers.

Returns
Number of non-expired weak_ptr observers

◆ NotifyCurrentIndexUpdated()

void mvc::IModelObservable::NotifyCurrentIndexUpdated ( int  index)
inlineprotected

Notifies all views of current item index change.

Parameters
indexThe new current item index
Here is the call graph for this function:
Here is the caller graph for this function:

◆ NotifyDataChanged()

void mvc::IModelObservable::NotifyDataChanged ( )
inlineprotected

Notifies all registered views that data has changed.

Iterates through all observers and calls their OnDataUpdated method. Dead observers (destroyed views) are automatically detected via weak_ptr and skipped without error.

Exception Safety
If a view's OnDataUpdated throws, the exception propagates after notifying remaining views. Uses best-effort notification.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ RegisterView()

void mvc::IModelObservable::RegisterView ( ViewPtr  view)
inline

Registers a view as observer with automatic cleanup.

The view is stored internally as weak_ptr so it's automatically removed when destroyed. No dangling pointers.

Parameters
viewShared pointer to view to register
Example
auto container = std::make_shared<EventsContainer>();
auto view = std::make_shared<ItemDetailsView>();
container->RegisterView(view); // Safe lifetime management
view.reset(); // View destroyed
container->NotifyDataChanged(); // Safe: weak_ptr detects deletion
Here is the call graph for this function:

◆ UnregisterView()

void mvc::IModelObservable::UnregisterView ( const IView *  view)
inline

Unregisters a view from observations.

Parameters
viewPointer to the view to unregister

Safe if view already unregistered or destroyed.

Here is the call graph for this function:

Member Data Documentation

◆ m_viewsMutex

std::shared_mutex mvc::IModelObservable::m_viewsMutex
mutableprivate

Storage for observer weak pointers - automatically manages cleanup.

◆ m_weakViews

std::vector<std::weak_ptr<IView> > mvc::IModelObservable::m_weakViews
private

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