blob: fa0a63c6d6c1bf1932f32479e532f8230128769e (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
|
// Copyright (c) 2009 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UTILITY_PROCESS_HOST_H_
#define CHROME_BROWSER_UTILITY_PROCESS_HOST_H_
#include <string>
#include "base/basictypes.h"
#include "base/ref_counted.h"
#include "base/task.h"
#include "chrome/common/child_process_host.h"
#include "chrome/common/extensions/update_manifest.h"
#include "ipc/ipc_channel.h"
class CommandLine;
class DictionaryValue;
class ListValue;
class MessageLoop;
// 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.
class UtilityProcessHost : public ChildProcessHost {
public:
// An interface to be implemented by consumers of the utility process to
// get results back. All functions are called on the thread passed along
// to UtilityProcessHost.
class Client : public base::RefCountedThreadSafe<Client> {
public:
Client() {}
virtual ~Client() {}
// Called when the process has crashed.
virtual void OnProcessCrashed() {}
// Called when the extension has unpacked successfully. |manifest| is the
// parsed manifest.json file. |images| contains a list of decoded images
// and the associated paths where those images live on disk.
virtual void OnUnpackExtensionSucceeded(const DictionaryValue& manifest) {}
// Called when an error occurred while unpacking the extension.
// |error_message| contains a description of the problem.
virtual void OnUnpackExtensionFailed(const std::string& error_message) {}
// Called when the web resource has been successfully parsed. |json_data|
// contains the parsed list of web resource items downloaded from the
// web resource server.
virtual void OnUnpackWebResourceSucceeded(
const DictionaryValue& json_data) {}
// Called when an error occurred while parsing the resource data.
// |error_message| contains a description of the problem.
virtual void OnUnpackWebResourceFailed(
const std::string& error_message) {}
// Called when an update manifest xml file was successfully parsed.
virtual void OnParseUpdateManifestSucceeded(
const UpdateManifest::ResultList& list) {}
// Called when an update manifest xml file failed parsing. |error_message|
// contains details suitable for logging.
virtual void OnParseUpdateManifestFailed(
const std::string& error_message) {}
private:
friend class UtilityProcessHost;
void OnMessageReceived(const IPC::Message& message);
DISALLOW_COPY_AND_ASSIGN(Client);
};
UtilityProcessHost(ResourceDispatcherHost* rdh, Client* client,
MessageLoop* client_loop);
virtual ~UtilityProcessHost();
// Start a process to unpack the extension at the given path. The process
// will be given access to the directory subtree that the extension file is
// in, so the caller is expected to have moved that file into a quarantined
// location first.
bool StartExtensionUnpacker(const FilePath& extension);
// Start a process to unpack and parse a web resource from the given JSON
// data. Any links that need to be downloaded from the parsed data
// (thumbnails, etc.) will be unpacked in resource_dir.
// TODO(mrc): Right now, the unpacker just parses the JSON data, and
// doesn't do any unpacking. This should change once we finalize the
// web resource server format(s).
bool StartWebResourceUnpacker(const std::string& data);
// Start parsing an extensions auto-update manifest xml file.
bool StartUpdateManifestParse(const std::string& xml);
protected:
// Allow these methods to be overridden for tests.
virtual std::wstring GetUtilityProcessCmd();
virtual bool UseSandbox() {
return true;
}
private:
// Starts a process. Returns true iff it succeeded.
bool StartProcess(const FilePath& exposed_dir);
// IPC messages:
void OnMessageReceived(const IPC::Message& message);
// ChildProcessHost:
virtual void OnChannelError();
virtual bool CanShutdown() { return true; }
virtual URLRequestContext* GetRequestContext(
uint32 request_id,
const ViewHostMsg_Resource_Request& request_data) {
return NULL;
}
// A pointer to our client interface, who will be informed of progress.
scoped_refptr<Client> client_;
MessageLoop* client_loop_;
DISALLOW_COPY_AND_ASSIGN(UtilityProcessHost);
};
#endif // CHROME_BROWSER_UTILITY_PROCESS_HOST_H_
|
