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
|
// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROMEOS_ASH_COMPONENTS_DBUS_CUPS_PROXY_CUPS_PROXY_CLIENT_H_
#define CHROMEOS_ASH_COMPONENTS_DBUS_CUPS_PROXY_CUPS_PROXY_CLIENT_H_
#include "base/component_export.h"
#include "base/files/scoped_file.h"
#include "base/functional/callback_forward.h"
#include "dbus/object_proxy.h"
namespace dbus {
class Bus;
} // namespace dbus
namespace ash {
// D-Bus client for the CupsProxyDaemon.
//
// Sole method bootstraps a Mojo connection between the daemon and Chrome,
// allowing Chrome to serve printing requests proxied by the daemon.
class COMPONENT_EXPORT(CUPS_PROXY) CupsProxyClient {
public:
// Creates and initializes the global instance. |bus| must not be null.
static void Initialize(dbus::Bus* bus);
// Creates and initializes a fake global instance if not already created.
static void InitializeFake();
// Destroys the global instance.
static void Shutdown();
// Returns the global instance which may be null if not initialized.
static CupsProxyClient* Get();
CupsProxyClient(const CupsProxyClient&) = delete;
CupsProxyClient& operator=(const CupsProxyClient&) = delete;
// Registers |callback| to run when the CupsProxyDaemon becomes available.
// If the daemon is already available, or if connecting to the name-owner-
// changed signal fails, |callback| will be run once asynchronously.
// Otherwise, |callback| will be run once in the future after the service
// becomes available.
virtual void WaitForServiceToBeAvailable(
dbus::ObjectProxy::WaitForServiceToBeAvailableCallback callback) = 0;
// Passes the file descriptor |fd| over D-Bus to the CupsProxyDaemon.
// * The daemon expects a Mojo invitation in |fd| with an attached Mojo pipe.
// * The daemon will bind the Mojo pipe to an
// chromeos::printing::mojom::CupsProxierPtr.
// * Upon completion of the D-Bus call, |result_callback| will be invoked to
// indicate success or failure.
// * This method will first wait for the CupsProxyService to become available.
virtual void BootstrapMojoConnection(
base::ScopedFD fd,
base::OnceCallback<void(bool success)> result_callback) = 0;
protected:
// Initialize/Shutdown should be used instead.
CupsProxyClient();
virtual ~CupsProxyClient();
};
} // namespace ash
#endif // CHROMEOS_ASH_COMPONENTS_DBUS_CUPS_PROXY_CUPS_PROXY_CLIENT_H_
|
