1 /*
2 * Copyright (c) 2024 Huawei Device Co., Ltd.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at
6 *
7 * http://www.apache.org/licenses/LICENSE-2.0
8 *
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
14 */
15
16 #ifndef VENDOR_DRIVER_BASE_H
17 #define VENDOR_DRIVER_BASE_H
18
19 #include <string>
20 #include <map>
21 #include <mutex>
22 #include <chrono>
23 #include "vendor_extension.h"
24 #include "printer_info.h"
25 #include "print_constant.h"
26 #include "thread_sync_wait.h"
27
28 namespace OHOS {
29 namespace Print {
30
31 static inline uint64_t GetNowTime();
32
33 struct PrinterVendorStatus {
34 Print_PrinterState state;
35 uint64_t lastUpdateTime;
36 uint64_t lastCheckTime;
PrinterVendorStatusPrinterVendorStatus37 PrinterVendorStatus() : state(PRINTER_UNAVAILABLE), lastUpdateTime(GetNowTime()), lastCheckTime(0) {}
38 };
39
GetNowTime()40 static inline uint64_t GetNowTime()
41 {
42 return std::chrono::duration_cast<std::chrono::milliseconds>(std::chrono::steady_clock::now().time_since_epoch())
43 .count();
44 }
45
46 enum ConnectMethod { ID_AUTO = 0, IP_AUTO, IP_IPP, IP_LPD, IP_SOCKET };
47
48 class IPrinterVendorManager {
49 public:
50 virtual int32_t AddPrinterToDiscovery(const std::string &vendorName, const PrinterInfo &printerInfo) = 0;
51 virtual int32_t UpdatePrinterToDiscovery(const std::string &vendorName, const PrinterInfo &printerInfo) = 0;
52 virtual int32_t RemovePrinterFromDiscovery(const std::string &vendorName, const std::string &printerId) = 0;
53 virtual int32_t AddPrinterToCupsWithPpd(const std::string &vendorName, const std::string &printerId,
54 const std::string &ppdName, const std::string &ppdData) = 0;
55 virtual int32_t RemovePrinterFromCups(const std::string &vendorName, const std::string &printerId) = 0;
56 virtual bool OnPrinterStatusChanged(const std::string &vendorName, const std::string &printerId,
57 const PrinterVendorStatus &status) = 0;
58 virtual bool OnPrinterCapabilityQueried(const std::string &vendorName, const PrinterInfo &printerInfo) = 0;
59 virtual bool OnPrinterPpdQueried(const std::string &vendorName, const std::string &printerId,
60 const std::string &ppdName, const std::string &ppdData) = 0;
61 virtual bool IsConnectingPrinter(const std::string &id, const std::string &uri) = 0;
62 virtual void SetConnectingPrinter(ConnectMethod method, const std::string &printer) = 0;
63 virtual void ClearConnectingPrinter() = 0;
64 virtual bool QueryPrinterCapabilityByUri(const std::string &uri, PrinterCapability &printerCap) = 0;
65 virtual bool QueryPrinterStatusByUri(const std::string &uri, PrinterStatus &status) = 0;
66 virtual std::shared_ptr<PrinterInfo> QueryDiscoveredPrinterInfoById(const std::string &vendorName,
67 const std::string &printerId) = 0;
68 virtual int32_t QueryPrinterInfoByPrinterId(const std::string &vendorName, const std::string &printerId,
69 PrinterInfo &info) = 0;
70 virtual std::vector<std::string> QueryAddedPrintersByIp(const std::string &printerIp) = 0;
71 virtual bool QueryPPDInformation(const std::string &makeModel, std::string &ppdName) = 0;
72 virtual ConnectMethod GetConnectingMethod(const std::string &id) = 0;
73 virtual int32_t DiscoverBackendPrinters(const std::string &vendorName, std::vector<PrinterInfo> &printers) = 0;
74 };
75
76 class VendorDriverBase {
77 public:
78 VendorDriverBase();
79 virtual ~VendorDriverBase();
80 virtual bool Init(IPrinterVendorManager *manager);
81 virtual void UnInit();
82 virtual void OnCreate();
83 virtual void OnDestroy();
84 virtual void OnStartDiscovery();
85 virtual void OnStopDiscovery();
86 virtual bool OnQueryCapability(const std::string &printerId, int timeout);
87 virtual bool OnQueryCapabilityByIp(const std::string &printerIp, const std::string &protocol);
88 virtual bool OnQueryProperties(const std::string &printerId, const std::vector<std::string> &propertyKeys);
89 virtual std::string GetVendorName() = 0;
90 virtual int32_t OnPrinterDiscovered(const std::string &vendorName, const PrinterInfo &printerInfo);
91 virtual bool MonitorPrinterStatus(const std::string &printerId, bool on);
92 virtual bool IsStatusMonitoring(const std::string &printerId);
93 virtual bool QueryProperty(const std::string &printerId, const std::string &key, std::string &value);
94 virtual void UpdateAllPrinterStatus();
95
96 std::shared_ptr<PrinterVendorStatus> GetMonitorVendorStatus(const std::string &printerId);
97 std::string GetGlobalVendorName();
98 std::string GetGlobalPrinterId(const std::string &printerId);
99 void OnPrinterStateQueried(const std::string &printerId, Print_PrinterState state);
100
101 protected:
102 IPrinterVendorManager *vendorManager = nullptr;
103 std::mutex statusMapMutex;
104 std::map<std::string, std::shared_ptr<PrinterVendorStatus>> vendorStatusMap;
105 ThreadSyncWait syncWait;
106 };
107 } // namespace Print
108 } // namespace OHOS
109 #endif // VENDOR_DRIVER_BASE_H
110