Index: chrome/browser/utility_process_host.h |
diff --git a/chrome/browser/utility_process_host.h b/chrome/browser/utility_process_host.h |
index 8dfee5e1fedac34bf134233f64d98235863ad746..8aadf35cdbf4caf2f161a020cf07e253665b1bc3 100644 |
--- a/chrome/browser/utility_process_host.h |
+++ b/chrome/browser/utility_process_host.h |
@@ -18,11 +18,17 @@ |
#include "ipc/ipc_channel.h" |
class DictionaryValue; |
+class IndexedDBKey; |
+class SerializedScriptValue; |
class SkBitmap; |
// This class acts as the browser-side host to a utility child process. A |
// utility process is a short-lived sandboxed process that is created to run |
// a specific task. This class lives solely on the IO thread. |
+// If you need a single method call in the sandbox, use StartFooBar(p). |
+// If you need multiple batches of work to be done in the sandboxed process, |
+// use StartBatchMode(), then multiple calls to StartFooBar(p), |
+// then finish with EndBatchMode(). |
class UtilityProcessHost : public BrowserChildProcessHost { |
public: |
// An interface to be implemented by consumers of the utility process to |
@@ -72,6 +78,18 @@ class UtilityProcessHost : public BrowserChildProcessHost { |
// Called when image data decoding failed. |
virtual void OnDecodeImageFailed() {} |
+ // Called when we have successfully obtained the IndexedDBKey after |
+ // a call to StartIDBKeysFromValuesAndKeyPath. |
+ // |id| is the corresponding identifier. |
+ // |keys| the corresponding IndexedDBKey. |
+ virtual void OnIDBKeysFromValuesAndKeyPathSucceeded( |
+ int id, const std::vector<IndexedDBKey>& keys) {} |
+ |
+ // Called when IDBKeyPath has failed. |
+ // |id| is the corresponding identifier passed on |
+ // StartIDBKeysFromValuesAndKeyPath. |
+ virtual void OnIDBKeysFromValuesAndKeyPathFailed(int id) {} |
+ |
protected: |
friend class base::RefCountedThreadSafe<Client>; |
@@ -109,12 +127,26 @@ class UtilityProcessHost : public BrowserChildProcessHost { |
// Start image decoding. |
bool StartImageDecoding(const std::vector<unsigned char>& encoded_data); |
+ // Starts extracting |key_path| from |serialized_values|, and replies with the |
+ // corresponding IndexedDBKeys via OnIDBKeysFromValuesAndKeyPathSucceeded. |
+ bool StartIDBKeysFromValuesAndKeyPath( |
+ int id, const std::vector<SerializedScriptValue>& serialized_values, |
+ const string16& key_path); |
+ |
+ // Starts utility process in batch mode. Caller must call EndBatchMode() |
+ // to finish the utility process. |
+ bool StartBatchMode(); |
+ |
+ // Ends the utility process. Must be called after StartBatchMode(). |
+ void EndBatchMode(); |
+ |
protected: |
// Allow these methods to be overridden for tests. |
virtual FilePath GetUtilityProcessCmd(); |
private: |
- // Starts a process. Returns true iff it succeeded. |
+ // Starts a process if necessary. Returns true if it succeeded or a process |
+ // has already been started via StartBatchMode(). |
bool StartProcess(const FilePath& exposed_dir); |
// IPC messages: |
@@ -132,6 +164,9 @@ class UtilityProcessHost : public BrowserChildProcessHost { |
// A pointer to our client interface, who will be informed of progress. |
scoped_refptr<Client> client_; |
ChromeThread::ID client_thread_id_; |
+ // True when running in batch mode, i.e., StartBatchMode() has been called |
+ // and the utility process will run until EndBatchMode(). |
+ bool is_batch_mode_; |
DISALLOW_COPY_AND_ASSIGN(UtilityProcessHost); |
}; |