OLD | NEW |
1 // Copyright 2015 The Chromium Authors. All rights reserved. | 1 // Copyright 2015 The Chromium Authors. All rights reserved. |
2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
4 | 4 |
5 #ifndef CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ | 5 #ifndef CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ |
6 #define CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ | 6 #define CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ |
7 | 7 |
8 #include <memory> | 8 #include <memory> |
9 #include <string> | 9 #include <string> |
| 10 #include <vector> |
10 | 11 |
11 #include "base/macros.h" | 12 #include "base/macros.h" |
| 13 #include "base/memory/ref_counted.h" |
| 14 #include "chromeos/printing/printer_configuration.h" |
12 #include "components/keyed_service/core/keyed_service.h" | 15 #include "components/keyed_service/core/keyed_service.h" |
13 | 16 |
14 class NotificationUIManager; | 17 class NotificationUIManager; |
15 class Profile; | 18 class Profile; |
16 | 19 |
17 namespace chromeos { | 20 namespace chromeos { |
18 | 21 |
19 // Observes device::UsbService for addition of USB printers (devices with | 22 // Observes device::UsbService for addition of USB printers (devices with |
20 // interface class 7). What it does with this depends on whether or not | 23 // interface class 7). What it does with this depends on whether or not |
21 // CUPS printing support is enabled. | 24 // CUPS printing support is enabled. |
22 // | 25 // |
23 // If CUPS is disabled, the Legacy implementation should be used. The legacy | 26 // If CUPS is disabled, the Legacy implementation should be used. The legacy |
24 // implementation shows a notification depending on whether there are printer | 27 // implementation shows a notification depending on whether there are printer |
25 // provider apps that declared support for the USB device installed. If such | 28 // provider apps that declared support for the USB device installed. If such |
26 // app exists, the notification notifies the user the printer is ready. | 29 // app exists, the notification notifies the user the printer is ready. |
27 // Otherwise the notification offers user to search Chrome Web Store for apps | 30 // Otherwise the notification offers user to search Chrome Web Store for apps |
28 // that support the printer. Clicking the notification launches webstore_widget | 31 // that support the printer. Clicking the notification launches webstore_widget |
29 // app for the printer. The notification is shown only for active user's | 32 // app for the printer. The notification is shown only for active user's |
30 // profile. | 33 // profile. |
31 // | 34 // |
32 // If CUPS is enabled, the Cups implementation should be used. This | 35 // If CUPS is enabled, the Cups implementation should be used. This |
33 // implementation to guides the user through setting up a new USB printer in the | 36 // implementation to guides the user through setting up a new USB printer in the |
34 // CUPS backend. | 37 // CUPS backend. |
35 class PrinterDetector : public KeyedService { | 38 class PrinterDetector : public KeyedService { |
36 public: | 39 public: |
| 40 class Observer { |
| 41 public: |
| 42 virtual ~Observer() = default; |
| 43 |
| 44 // The set of available printers has changed |
| 45 virtual void OnAvailableUsbPrintersChanged( |
| 46 const std::vector<Printer>& printers) = 0; |
| 47 }; |
| 48 |
37 // Factory function for the Legacy implementation. | 49 // Factory function for the Legacy implementation. |
38 static std::unique_ptr<PrinterDetector> CreateLegacy(Profile* profile); | 50 static std::unique_ptr<PrinterDetector> CreateLegacy(Profile* profile); |
39 | 51 |
40 // Factory function for the CUPS implementation. | 52 // Factory function for the CUPS implementation. |
41 static std::unique_ptr<PrinterDetector> CreateCups(Profile* profile); | 53 static std::unique_ptr<PrinterDetector> CreateCups(Profile* profile); |
42 ~PrinterDetector() override {} | 54 ~PrinterDetector() override {} |
43 | 55 |
| 56 // Observer management. Note these are only implemented for the cups backend. |
| 57 virtual void AddObserver(Observer* observer) {} |
| 58 virtual void RemoveObserver(Observer* observer) {} |
| 59 |
| 60 // Get the current set of detected printers. |
| 61 virtual std::vector<Printer> GetPrinters() { return {}; } |
| 62 |
44 protected: | 63 protected: |
45 PrinterDetector() = default; | 64 PrinterDetector() = default; |
46 | 65 |
47 private: | 66 private: |
48 friend class PrinterDetectorAppSearchEnabledTest; | 67 friend class PrinterDetectorAppSearchEnabledTest; |
49 | 68 |
50 virtual void SetNotificationUIManagerForTesting( | 69 virtual void SetNotificationUIManagerForTesting( |
51 NotificationUIManager* manager) = 0; | 70 NotificationUIManager* manager) = 0; |
52 | 71 |
53 DISALLOW_COPY_AND_ASSIGN(PrinterDetector); | 72 DISALLOW_COPY_AND_ASSIGN(PrinterDetector); |
54 }; | 73 }; |
55 | 74 |
56 } // namespace chromeos | 75 } // namespace chromeos |
57 | 76 |
58 #endif // CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ | 77 #endif // CHROME_BROWSER_CHROMEOS_PRINTER_DETECTOR_PRINTER_DETECTOR_H_ |
OLD | NEW |