Home | History | Annotate | Download | only in devtools 
      1 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
      2 // Use of this source code is governed by a BSD-style license that can be
      3 // found in the LICENSE file.
      4 
      5 #ifndef CONTENT_BROWSER_DEVTOOLS_WORKER_DEVTOOLS_MANAGER_H_
      6 #define CONTENT_BROWSER_DEVTOOLS_WORKER_DEVTOOLS_MANAGER_H_
      7 
      8 #include <list>
      9 #include <map>
     10 #include <string>
     11 
     12 #include "base/basictypes.h"
     13 #include "base/memory/singleton.h"
     14 #include "content/browser/worker_host/worker_process_host.h"
     15 #include "content/common/content_export.h"
     16 
     17 namespace content {
     18 
     19 class DevToolsAgentHost;
     20 
     21 // All methods are supposed to be called on the IO thread.
     22 class WorkerDevToolsManager {
     23  public:
     24   typedef std::pair<int, int> WorkerId;
     25   class WorkerDevToolsAgentHost;
     26 
     27   // Returns the WorkerDevToolsManager singleton.
     28   static WorkerDevToolsManager* GetInstance();
     29 
     30   // Called on the UI thread.
     31   static DevToolsAgentHost* GetDevToolsAgentHostForWorker(
     32       int worker_process_id,
     33       int worker_route_id);
     34 
     35   // Called on the UI thread.
     36   static bool HasDevToolsAgentHostForWorker(
     37       int worker_process_id,
     38       int worker_route_id);
     39 
     40   void ForwardToDevToolsClient(int worker_process_id,
     41                                int worker_route_id,
     42                                const std::string& message);
     43   void SaveAgentRuntimeState(int worker_process_id,
     44                              int worker_route_id,
     45                              const std::string& state);
     46 
     47   // Called on the IO thread.
     48   void WorkerCreated(
     49       WorkerProcessHost* process,
     50       const WorkerProcessHost::WorkerInstance& instance);
     51   void WorkerDestroyed(WorkerProcessHost* process, int worker_route_id);
     52   void WorkerContextStarted(WorkerProcessHost* process, int worker_route_id);
     53 
     54  private:
     55   friend struct DefaultSingletonTraits<WorkerDevToolsManager>;
     56   class DetachedClientHosts;
     57   struct InspectedWorker;
     58   typedef std::list<InspectedWorker> InspectedWorkersList;
     59 
     60   WorkerDevToolsManager();
     61   virtual ~WorkerDevToolsManager();
     62 
     63   void RemoveInspectedWorkerData(const WorkerId& id);
     64   InspectedWorkersList::iterator FindInspectedWorker(int host_id, int route_id);
     65 
     66   void ConnectDevToolsAgentHostToWorker(int worker_process_id,
     67                                         int worker_route_id);
     68   void ForwardToWorkerDevToolsAgent(int worker_process_host_id,
     69                                     int worker_route_id,
     70                                     const IPC::Message& message);
     71   static void ForwardToDevToolsClientOnUIThread(
     72       int worker_process_id,
     73       int worker_route_id,
     74       const std::string& message);
     75   static void SaveAgentRuntimeStateOnUIThread(
     76       int worker_process_id,
     77       int worker_route_id,
     78       const std::string& state);
     79   static void NotifyConnectionFailedOnIOThread(int worker_process_id,
     80                                                int worker_route_id);
     81   static void NotifyConnectionFailedOnUIThread(int worker_process_id,
     82                                                int worker_route_id);
     83   static void SendResumeToWorker(const WorkerId& id);
     84 
     85   InspectedWorkersList inspected_workers_;
     86 
     87   struct TerminatedInspectedWorker;
     88   typedef std::list<TerminatedInspectedWorker> TerminatedInspectedWorkers;
     89   // List of terminated workers for which there may be a devtools client on
     90   // the UI thread. Worker entry is added into this list when inspected worker
     91   // is terminated and will be removed in one of two cases:
     92   // - shared worker with the same URL and name is started(in wich case we will
     93   // try to reattach existing DevTools client to the new worker).
     94   // - DevTools client which was inspecting terminated worker is closed on the
     95   // UI thread and and WorkerDevToolsManager is notified about that on the IO
     96   // thread.
     97   TerminatedInspectedWorkers terminated_workers_;
     98 
     99   typedef std::map<WorkerId, WorkerId> PausedWorkers;
    100   // Map from old to new worker id for the inspected workers that have been
    101   // terminated and started again in paused state. Worker data will be removed
    102   // from this list in one of two cases:
    103   // - DevTools client is closed on the UI thread, WorkerDevToolsManager was
    104   // notified about that on the IO thread and sent "resume" message to the
    105   // worker.
    106   // - Existing DevTools client was reattached to the new worker.
    107   PausedWorkers paused_workers_;
    108 
    109   DISALLOW_COPY_AND_ASSIGN(WorkerDevToolsManager);
    110 };
    111 
    112 }  // namespace content
    113 
    114 #endif  // CONTENT_BROWSER_DEVTOOLS_WORKER_DEVTOOLS_MANAGER_H_
    115