tonic::DartMessageHandler Class Reference

#include <dart_message_handler.h>

Public Types
using	TaskDispatcher = std::function< void(std::function< void(void)>)>

Public Member Functions
	DartMessageHandler ()
	~DartMessageHandler ()
void	Initialize (TaskDispatcher dispatcher)
void	UnhandledError (Dart_Handle error)
bool	isolate_exited () const
bool	isolate_had_uncaught_exception_error () const
DartErrorHandleType	isolate_last_error () const

Protected Member Functions
void	OnMessage (DartState *dart_state)
void	OnHandleMessage (DartState *dart_state)
bool	handled_first_message () const
void	set_handled_first_message (bool handled_first_message)

Protected Attributes
bool	handled_first_message_
bool	isolate_exited_
bool	isolate_had_uncaught_exception_error_
bool	isolate_had_fatal_error_
DartErrorHandleType	isolate_last_error_
TaskDispatcher	task_dispatcher_

Detailed Description

Definition at line 16 of file dart_message_handler.h.

Member Typedef Documentation

TaskDispatcher

using tonic::DartMessageHandler::TaskDispatcher = std::function<void(std::function<void(void)>)>

Definition at line 18 of file dart_message_handler.h.

Constructor & Destructor Documentation

DartMessageHandler()

tonic::DartMessageHandler::DartMessageHandler

(

)

Definition at line 16 of file dart_message_handler.cc.

    : handled_first_message_(false),
      isolate_exited_(false),
      isolate_had_uncaught_exception_error_(false),
      isolate_had_fatal_error_(false),
      isolate_last_error_(kNoError),
      task_dispatcher_(nullptr) {}

~DartMessageHandler()

tonic::DartMessageHandler::~DartMessageHandler

(

)

Definition at line 24 of file dart_message_handler.cc.

                                        {
  task_dispatcher_ = nullptr;
}

References task_dispatcher_.

Member Function Documentation

handled_first_message()

bool tonic::DartMessageHandler::handled_first_message ( ) const

inlineprotected

Definition at line 47 of file dart_message_handler.h.

{ return handled_first_message_; }

References handled_first_message_.

Referenced by set_handled_first_message().

Initialize()

void tonic::DartMessageHandler::Initialize

(

TaskDispatcher

dispatcher

)

Definition at line 28 of file dart_message_handler.cc.

                                                             {
  // Only can be called once.
  TONIC_CHECK(!task_dispatcher_ && dispatcher);
  task_dispatcher_ = dispatcher;
  Dart_SetMessageNotifyCallback(MessageNotifyCallback);
}

References task_dispatcher_, and TONIC_CHECK.

isolate_exited()

bool tonic::DartMessageHandler::isolate_exited ( ) const

inline

Definition at line 32 of file dart_message_handler.h.

{ return isolate_exited_; }

References isolate_exited_.

isolate_had_uncaught_exception_error()

bool tonic::DartMessageHandler::isolate_had_uncaught_exception_error ( ) const

inline

Definition at line 35 of file dart_message_handler.h.

                                                    {
    return isolate_had_uncaught_exception_error_;
  }

References isolate_had_uncaught_exception_error_.

isolate_last_error()

DartErrorHandleType tonic::DartMessageHandler::isolate_last_error ( ) const

inline

Definition at line 39 of file dart_message_handler.h.

{ return isolate_last_error_; }

References isolate_last_error_.

Referenced by flutter::UIDartState::GetLastError().

OnHandleMessage()

void tonic::DartMessageHandler::OnHandleMessage ( DartState *  dart_state )

protected

Definition at line 65 of file dart_message_handler.cc.

                                                              {
  if (isolate_had_fatal_error_) {
    // Don't handle any more messages.
    return;
  }
 
  DartIsolateScope scope(dart_state->isolate());
  DartApiScope dart_api_scope;
  Dart_Handle result = Dart_Null();
  bool error = false;
 
  // On the first message, check if we should pause on isolate start.
  if (!handled_first_message()) {
    set_handled_first_message(true);
    if (Dart_ShouldPauseOnStart()) {
      // Mark that we are paused on isolate start.
      Dart_SetPausedOnStart(true);
    }
  }
 
  if (Dart_IsPausedOnStart()) {
    // We are paused on isolate start. Only handle service messages until we are
    // requested to resume.
    if (Dart_HasServiceMessages()) {
      bool resume = Dart_HandleServiceMessages();
      if (!resume) {
        return;
      }
      Dart_SetPausedOnStart(false);
      // We've resumed, handle normal messages that are in the queue.
      result = Dart_HandleMessage();
      error = CheckAndHandleError(result);
      dart_state->MessageEpilogue(result);
      if (!Dart_CurrentIsolate()) {
        isolate_exited_ = true;
        return;
      }
    }
  } else if (Dart_IsPausedOnExit()) {
    // We are paused on isolate exit. Only handle service messages until we are
    // requested to resume.
    if (Dart_HasServiceMessages()) {
      bool resume = Dart_HandleServiceMessages();
      if (!resume) {
        return;
      }
      Dart_SetPausedOnExit(false);
    }
  } else {
    // We are processing messages normally.
    result = Dart_HandleMessage();
    // If the Dart program has set a return code, then it is intending to shut
    // down by way of a fatal error, and so there is no need to emit a log
    // message.
    if (dart_state->has_set_return_code() && Dart_IsError(result) &&
        Dart_IsFatalError(result)) {
      error = true;
    } else {
      error = CheckAndHandleError(result);
    }
    dart_state->MessageEpilogue(result);
    if (!Dart_CurrentIsolate()) {
      isolate_exited_ = true;
      return;
    }
  }
 
  if (error) {
    UnhandledError(result);
  } else if (!Dart_HasLivePorts()) {
    // The isolate has no live ports and would like to exit.
    if (!Dart_IsPausedOnExit() && Dart_ShouldPauseOnExit()) {
      // Mark that we are paused on exit.
      Dart_SetPausedOnExit(true);
    } else {
      isolate_exited_ = true;
    }
  }
}

References tonic::CheckAndHandleError(), error, tonic::DartState::has_set_return_code(), tonic::DartState::isolate(), and tonic::DartState::MessageEpilogue().

OnMessage()

void tonic::DartMessageHandler::OnMessage ( DartState *  dart_state )

protected

Definition at line 35 of file dart_message_handler.cc.

                                                        {
  auto task_dispatcher_ = dart_state->message_handler().task_dispatcher_;
 
  // Schedule a task to run on the message loop thread.
  auto weak_dart_state = dart_state->GetWeakPtr();
  task_dispatcher_([weak_dart_state]() {
    if (auto dart_state = weak_dart_state.lock()) {
      if (!dart_state->IsShuttingDown()) {
        dart_state->message_handler().OnHandleMessage(dart_state.get());
      }
    }
  });
}

References tonic::DartState::GetWeakPtr(), tonic::DartState::message_handler(), and task_dispatcher_.

set_handled_first_message()

void tonic::DartMessageHandler::set_handled_first_message ( bool  handled_first_message )

inlineprotected

Definition at line 49 of file dart_message_handler.h.

                                                             {
    handled_first_message_ = handled_first_message;
  }

References handled_first_message(), and handled_first_message_.

UnhandledError()

void tonic::DartMessageHandler::UnhandledError

(

Dart_Handle

error

)

Definition at line 49 of file dart_message_handler.cc.

                                                         {
  TONIC_DCHECK(Dart_CurrentIsolate());
  TONIC_DCHECK(Dart_IsError(error));
 
  isolate_last_error_ = GetErrorHandleType(error);
  // Remember that we had an uncaught exception error.
  isolate_had_uncaught_exception_error_ = true;
  if (Dart_IsFatalError(error)) {
    isolate_had_fatal_error_ = true;
    // Stop handling messages.
    Dart_SetMessageNotifyCallback(nullptr);
    // Shut down the isolate.
    Dart_ShutdownIsolate();
  }
}

References error, tonic::GetErrorHandleType(), and TONIC_DCHECK.

Member Data Documentation

handled_first_message_

bool tonic::DartMessageHandler::handled_first_message_

protected

Definition at line 53 of file dart_message_handler.h.

Referenced by handled_first_message(), and set_handled_first_message().

isolate_exited_

bool tonic::DartMessageHandler::isolate_exited_

protected

Definition at line 54 of file dart_message_handler.h.

Referenced by isolate_exited().

isolate_had_fatal_error_

bool tonic::DartMessageHandler::isolate_had_fatal_error_

protected

Definition at line 56 of file dart_message_handler.h.

isolate_had_uncaught_exception_error_

bool tonic::DartMessageHandler::isolate_had_uncaught_exception_error_

protected

Definition at line 55 of file dart_message_handler.h.

Referenced by isolate_had_uncaught_exception_error().

isolate_last_error_

DartErrorHandleType tonic::DartMessageHandler::isolate_last_error_

protected

Definition at line 57 of file dart_message_handler.h.

Referenced by isolate_last_error().

task_dispatcher_

TaskDispatcher tonic::DartMessageHandler::task_dispatcher_

protected

Definition at line 58 of file dart_message_handler.h.

Referenced by Initialize(), OnMessage(), and ~DartMessageHandler().

---

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

• third_party/tonic/dart_message_handler.h
• third_party/tonic/dart_message_handler.cc