Eventi

Introduzione

Gli eventi sono potenti quando hai bisogno di gestire la logica dopo che qualcosa accade nella tua applicazione. Il sistema di eventi di Nylo ti permette di creare, inviare e ascoltare eventi da qualsiasi punto della tua applicazione, rendendo piu' facile costruire applicazioni Flutter reattive e guidate dagli eventi.

Capire gli Eventi

La programmazione guidata dagli eventi e' un paradigma in cui il flusso della tua applicazione e' determinato da eventi come azioni dell'utente, output dei sensori o messaggi da altri programmi o thread. Questo approccio aiuta a disaccoppiare le diverse parti della tua applicazione, rendendo il codice piu' manutenibile e facile da comprendere.

Esempi Comuni di Eventi

Ecco alcuni eventi tipici che la tua applicazione potrebbe utilizzare:

• Registrazione utente completata
• Utente connesso/disconnesso
• Prodotto aggiunto al carrello
• Pagamento elaborato con successo
• Sincronizzazione dati completata
• Notifica push ricevuta

Creare un Evento

Puoi creare un nuovo evento utilizzando la CLI del framework Nylo o Metro:

metro make:event PaymentSuccessfulEvent

Dopo aver eseguito il comando, un nuovo file evento verra' creato nella directory app/events/.

Struttura dell'Evento

Ecco la struttura di un file evento appena creato (es. app/events/payment_successful_event.dart):

import 'package:nylo_framework/nylo_framework.dart';

class PaymentSuccessfulEvent implements NyEvent {
  final listeners = {
    DefaultListener: DefaultListener(),
  };
}

class DefaultListener extends NyListener {
  handle(dynamic event) async {
    // Handle the payload from event
  }
}

Inviare Eventi

Gli eventi possono essere inviati da qualsiasi punto della tua applicazione utilizzando il metodo helper event.

Invio Base di un Evento

Per inviare un evento senza dati:

event<PaymentSuccessfulEvent>();

Invio con Dati

Per passare dati insieme al tuo evento:

event<PaymentSuccessfulEvent>(data: {
  'user': user,
  'amount': amount,
  'transactionId': 'txn_123456'
});

Broadcasting degli Eventi

Per impostazione predefinita, gli eventi Nylo vengono gestiti solo dai listener definiti nella classe evento. Per fare il broadcast di un evento (rendendolo disponibile ai listener esterni), usa il parametro broadcast:

event<PaymentSuccessfulEvent>(
  data: {'user': user, 'amount': amount},
  broadcast: true
);

Ascoltare gli Eventi

Nylo fornisce diversi modi per ascoltare e rispondere agli eventi.

Utilizzare l'Helper listenOn

L'helper listenOn puo' essere usato ovunque nella tua applicazione per ascoltare eventi in broadcast:

NyEventSubscription subscription = listenOn<PaymentSuccessfulEvent>((data) {
  // Access event data
  final user = data['user'];
  final amount = data['amount'];

  // Handle the event
  showSuccessMessage("Payment of $amount received");
});

Utilizzare l'Helper listen

L'helper listen e' disponibile nelle classi NyPage e NyState. Gestisce automaticamente le sottoscrizioni, annullando l'iscrizione quando il widget viene eliminato:

class _CheckoutPageState extends NyPage<CheckoutPage> {
  @override
  get init => () {
    listen<PaymentSuccessfulEvent>((data) {
      // Handle payment success
      routeTo(OrderConfirmationPage.path);
    });

    listen<PaymentFailedEvent>((data) {
      // Handle payment failure
      displayErrorMessage(data['error']);
    });
  };

  // Rest of your page implementation
}

Annullare l'Iscrizione dagli Eventi

Quando usi listenOn, devi annullare manualmente l'iscrizione per prevenire perdite di memoria:

// Store the subscription
final subscription = listenOn<PaymentSuccessfulEvent>((data) {
  // Handle event
});

// Later, when no longer needed
subscription.cancel();

L'helper listen gestisce automaticamente l'annullamento dell'iscrizione quando il widget viene eliminato.

Lavorare con i Listener

I listener sono classi che rispondono agli eventi. Ogni evento puo' avere listener multipli per gestire diversi aspetti dell'evento.

Aggiungere Listener Multipli

Puoi aggiungere listener multipli al tuo evento aggiornando la proprieta' listeners:

class PaymentSuccessfulEvent implements NyEvent {
  final listeners = {
    NotificationListener: NotificationListener(),
    AnalyticsListener: AnalyticsListener(),
    OrderProcessingListener: OrderProcessingListener(),
  };
}

Implementare la Logica del Listener

Ogni listener dovrebbe implementare il metodo handle per elaborare l'evento:

class NotificationListener extends NyListener {
  handle(dynamic event) async {
    // Send notification to user
    final user = event['user'];
    await NotificationService.sendNotification(
      userId: user.id,
      title: "Payment Successful",
      body: "Your payment of ${event['amount']} was processed successfully."
    );
  }
}

class AnalyticsListener extends NyListener {
  handle(dynamic event) async {
    // Log analytics event
    await AnalyticsService.logEvent(
      "payment_successful",
      parameters: {
        'amount': event['amount'],
        'userId': event['user'].id,
      }
    );
  }
}

Broadcasting Globale degli Eventi

Se vuoi che tutti gli eventi vengano trasmessi automaticamente senza specificare broadcast: true ogni volta, puoi abilitare il broadcasting globale.

Abilitare il Broadcasting Globale

Modifica il tuo file app/providers/app_provider.dart e aggiungi il metodo broadcastEvents() alla tua istanza Nylo:

class AppProvider implements NyProvider {
  @override
  boot(Nylo nylo) async {
    // Other configuration

    // Enable broadcasting for all events
    nylo.broadcastEvents();
  }
}

Con il broadcasting globale abilitato, puoi inviare e ascoltare eventi in modo piu' conciso:

// Dispatch event (no need for broadcast: true)
event<PaymentSuccessfulEvent>(data: {
  'user': user,
  'amount': amount,
});

// Listen for the event anywhere
listen<PaymentSuccessfulEvent>((data) {
  // Handle event data
});