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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
// Copyright 2020 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CHROME_BROWSER_UI_WEBUI_PRINT_PREVIEW_PRINT_PREVIEW_HANDLER_CHROMEOS_H_
#define CHROME_BROWSER_UI_WEBUI_PRINT_PREVIEW_PRINT_PREVIEW_HANDLER_CHROMEOS_H_
#include <string>
#include "base/gtest_prod_util.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "base/values.h"
#include "chrome/browser/ash/printing/print_servers_manager.h"
#include "chrome/common/buildflags.h"
#include "chromeos/crosapi/mojom/local_printer.mojom.h"
#include "components/prefs/pref_service.h"
#include "components/signin/public/identity_manager/identity_manager.h"
#include "content/public/browser/web_ui_message_handler.h"
#include "mojo/public/cpp/bindings/receiver.h"
#include "printing/backend/print_backend.h"
#include "printing/buildflags/buildflags.h"
#include "printing/print_job_constants.h"
namespace content {
class WebContents;
}
namespace printing {
namespace mojom {
enum class PrinterType;
}
class PrinterHandler;
class PrintPreviewHandler;
// The handler for Javascript messages related to the print preview dialog.
class PrintPreviewHandlerChromeOS
: public content::WebUIMessageHandler,
public crosapi::mojom::PrintServerObserver,
public crosapi::mojom::LocalPrintersObserver {
public:
PrintPreviewHandlerChromeOS();
PrintPreviewHandlerChromeOS(const PrintPreviewHandlerChromeOS&) = delete;
PrintPreviewHandlerChromeOS& operator=(const PrintPreviewHandlerChromeOS&) =
delete;
~PrintPreviewHandlerChromeOS() override;
// WebUIMessageHandler implementation.
void RegisterMessages() override;
void OnJavascriptDisallowed() override;
void OnJavascriptAllowed() override;
protected:
// Protected so unit tests can override.
virtual PrinterHandler* GetPrinterHandler(mojom::PrinterType printer_type);
private:
friend class PrintPreviewHandlerChromeOSTest;
friend class TestPrintServersManager;
PrintPreviewHandler* GetPrintPreviewHandler();
void MaybeAllowJavascript();
// Grants an extension access to a provisional printer. First element of
// |args| is the provisional printer ID.
void HandleGrantExtensionPrinterAccess(const base::Value::List& args);
// Performs printer setup. First element of |args| is the printer name.
void HandlePrinterSetup(const base::Value::List& args);
// Gets the EULA URL.
void HandleGetEulaUrl(const base::Value::List& args);
// Send the EULA URL;
void SendEulaUrl(const std::string& callback_id, const std::string& eula_url);
// Send the result of performing printer setup. |settings_info| contains
// printer capabilities.
void SendPrinterSetup(const std::string& callback_id,
const std::string& printer_name,
base::Value::Dict settings_info);
// Called when an extension reports information requested for a provisional
// printer.
// |callback_id|: The javascript callback to resolve or reject.
// |printer_info|: The data reported by the extension.
void OnGotExtensionPrinterInfo(const std::string& callback_id,
const base::Value::Dict& printer_info);
// Called to initiate a status request for a printer.
void HandleRequestPrinterStatusUpdate(const base::Value::List& args);
void HandleRequestPrinterStatusUpdateCompletion(
base::Value callback_id,
std::optional<base::Value::Dict> result);
// crosapi::mojom::PrintServerObserver Implementation
void OnPrintServersChanged(
crosapi::mojom::PrintServersConfigPtr ptr) override;
void OnServerPrintersChanged() override;
// Loads printers corresponding to the print server(s). First element of
// |args| is the print server IDs.
void HandleChoosePrintServers(const base::Value::List& args);
// Gets the list of print servers and fetching mode.
void HandleGetPrintServersConfig(const base::Value::List& args);
// Records the `PrintPreview.PrintAttemptOutcome` histogram.
void HandleRecordPrintAttemptOutcome(const base::Value::List& args);
// Gets the WebContents that initiated print preview request using
// `PrintPreviewDialogController`.
content::WebContents* GetInitiator();
// Gets whether the UI should show the button to open printer settings. Button
// should be hidden if preview launched from the settings SWA.
void HandleGetShowManagePrinters(const base::Value::List& args);
void HandleObserveLocalPrinters(const base::Value::List& args);
// Callback for `HandleGetShowManagePrinters()`.
void OnHandleObserveLocalPrinters(
const std::string& callback_id,
std::vector<crosapi::mojom::LocalDestinationInfoPtr> printers);
// crosapi::mojom::LocalPrintersObserver Implementation:
void OnLocalPrintersUpdated(
std::vector<crosapi::mojom::LocalDestinationInfoPtr> printers) override;
void SetInitiatorForTesting(content::WebContents* test_initiator);
mojo::Receiver<crosapi::mojom::PrintServerObserver> receiver_{this};
mojo::Receiver<crosapi::mojom::LocalPrintersObserver>
local_printers_receiver_{this};
// Used for testing, when `GetInitiator` called and `test_initiator` is set
// then it will be returned instead of calling `PrintPreviewDialogController`
// to find the initiator.
raw_ptr<content::WebContents> test_initiator_ = nullptr;
// Used to transmit mojo interface method calls to ash chrome. Null if
// CrosapiManager is unavailable. In the post-Lacros world, it still bears the
// responsibility of talking to other parts of Ash for printer related
// business logic.
raw_ptr<crosapi::mojom::LocalPrinter, DanglingUntriaged> local_printer_ =
nullptr;
base::WeakPtrFactory<PrintPreviewHandlerChromeOS> weak_factory_{this};
};
} // namespace printing
#endif // CHROME_BROWSER_UI_WEBUI_PRINT_PREVIEW_PRINT_PREVIEW_HANDLER_CHROMEOS_H_
|
