1 #ifndef SRC_NODE_MAIN_INSTANCE_H_ 2 #define SRC_NODE_MAIN_INSTANCE_H_ 3 4 #if defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS 5 6 #include <cstddef> 7 #include <memory> 8 9 #include "node.h" 10 #include "util.h" 11 #include "uv.h" 12 #include "v8.h" 13 14 namespace node { 15 16 // TODO(joyeecheung): align this with the Worker/WorkerThreadData class. 17 // We may be able to create an abstract class to reuse some of the routines. 18 class NodeMainInstance { 19 public: 20 // To create a main instance that does not own the isolate, 21 // The caller needs to do: 22 // 23 // Isolate* isolate = Isolate::Allocate(); 24 // platform->RegisterIsolate(isolate, loop); 25 // isolate->Initialize(...); 26 // isolate->Enter(); 27 // std::unique_ptr<NodeMainInstance> main_instance = 28 // NodeMainInstance::Create(isolate, loop, args, exec_args); 29 // 30 // When tearing it down: 31 // 32 // main_instance->Cleanup(); // While the isolate is entered 33 // isolate->Exit(); 34 // isolate->Dispose(); 35 // platform->UnregisterIsolate(isolate); 36 // 37 // After calling Dispose() the main_instance is no longer accessible. 38 static std::unique_ptr<NodeMainInstance> Create( 39 v8::Isolate* isolate, 40 uv_loop_t* event_loop, 41 MultiIsolatePlatform* platform, 42 const std::vector<std::string>& args, 43 const std::vector<std::string>& exec_args); 44 45 void Dispose(); 46 47 // Create a main instance that owns the isolate 48 NodeMainInstance( 49 v8::Isolate::CreateParams* params, 50 uv_loop_t* event_loop, 51 MultiIsolatePlatform* platform, 52 const std::vector<std::string>& args, 53 const std::vector<std::string>& exec_args, 54 const std::vector<size_t>* per_isolate_data_indexes = nullptr); 55 ~NodeMainInstance(); 56 57 // Start running the Node.js instances, return the exit code when finished. 58 int Run(); 59 isolate_data()60 IsolateData* isolate_data() { return isolate_data_.get(); } 61 62 DeleteFnPtr<Environment, FreeEnvironment> CreateMainEnvironment( 63 int* exit_code); 64 65 // If nullptr is returned, the binary is not built with embedded 66 // snapshot. 67 static const std::vector<size_t>* GetIsolateDataIndexes(); 68 static v8::StartupData* GetEmbeddedSnapshotBlob(); 69 70 static const size_t kNodeContextIndex = 0; 71 NodeMainInstance(const NodeMainInstance&) = delete; 72 NodeMainInstance& operator=(const NodeMainInstance&) = delete; 73 NodeMainInstance(NodeMainInstance&&) = delete; 74 NodeMainInstance& operator=(NodeMainInstance&&) = delete; 75 76 private: 77 NodeMainInstance(v8::Isolate* isolate, 78 uv_loop_t* event_loop, 79 MultiIsolatePlatform* platform, 80 const std::vector<std::string>& args, 81 const std::vector<std::string>& exec_args); 82 83 std::vector<std::string> args_; 84 std::vector<std::string> exec_args_; 85 std::unique_ptr<ArrayBufferAllocator> array_buffer_allocator_; 86 v8::Isolate* isolate_; 87 MultiIsolatePlatform* platform_; 88 std::unique_ptr<IsolateData> isolate_data_; 89 bool owns_isolate_ = false; 90 bool deserialize_mode_ = false; 91 }; 92 93 } // namespace node 94 95 #endif // defined(NODE_WANT_INTERNALS) && NODE_WANT_INTERNALS 96 #endif // SRC_NODE_MAIN_INSTANCE_H_ 97