RaiiTimer class

A managed Timer that integrates with the RAII lifecycle system.

RaiiTimer wraps a standard Timer and provides automatic cancellation when its parent lifecycle is disposed. This prevents common issues like timers firing after their associated widget or component has been disposed.

The timer can be cancelled manually by calling cancel, or it will be automatically cancelled when the parent RaiiLifecycleAware is disposed.

Example usage:

class NotificationManager with RaiiLifecycleMixin {
  void scheduleNotification() {
    // Create timer using the extension method
    final timer = Timer(Duration(seconds: 5), () {
      showNotification('Your task is ready!');
    }).withLifecycle(this);

    // Can manually cancel if needed
    if (userCancelled) {
      timer.cancel();
    }

    // Can check timer state
    if (timer.isActive) {
      print('Timer is still running');
    }
  }

  void schedulePeriodicTask() {
    final timer = Timer.periodic(Duration(seconds: 1), (t) {
      print('Tick: ${t.tick}');
    }).withLifecycle(this);

    // Access the timer's tick count
    print('Current tick: ${timer.tick}');
  }
}

The timer follows this lifecycle:

Created via RaiiTimer.withLifecycle (typically through TimerRaiiExt.withLifecycle)
Registered with parent RaiiLifecycleAware
Timer runs until completion, manual cancellation, or parent disposal
On disposal: timer is cancelled, lifecycle is cleaned up, and unregistered from parent

Constructors

Properties

Methods

Operators

flutter library