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
|
// Copyright 2024 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_PRINTING_REMOTE_PPD_FETCHER_H_
#define CHROMEOS_PRINTING_REMOTE_PPD_FETCHER_H_
#include <memory>
#include <string>
#include "base/component_export.h"
#include "base/functional/callback_forward.h"
#include "url/gurl.h"
namespace network::mojom {
class URLLoaderFactory;
}
namespace chromeos {
// A RemotePpdFetcher is used to fetch the contents of a PPD file hosted at an
// HTTP or HTTPS URL. The PPD file will then be used to configure a printer in
// CUPS.
class COMPONENT_EXPORT(CHROMEOS_PRINTING) RemotePpdFetcher {
public:
enum class FetchResultCode {
kSuccess,
// This is a catch-all status code for all network-related error, e.g. the
// given URL was unreachable.
kNetworkError,
};
using FetchCallback = base::OnceCallback<void(FetchResultCode, std::string)>;
virtual ~RemotePpdFetcher() = default;
// Fetch the contents of the given URL.
//
// `url` must be a valid URL with HTTP or HTTPS scheme.
// If successful, `cb` will be invoked with FetchResult::kSuccess and the
// contents of `url`. If unsuccessful, `cb` will be invoked with a FetchResult
// indicating the error.
virtual void Fetch(const GURL& url, FetchCallback cb) const = 0;
// Create a `RemotePpdFetcher` instance.
//
// `loader_factory_dispenser` is a functor that can create fresh
// URLLoaderFactory instances. We use this indirection to avoid
// caching a raw pointer to a URLLoaderFactory instance, which is
// invalidated by network service restarts.
static std::unique_ptr<RemotePpdFetcher> Create(
base::RepeatingCallback<network::mojom::URLLoaderFactory*()>
loader_factory_dispenser);
};
} // namespace chromeos
#endif // CHROMEOS_PRINTING_REMOTE_PPD_FETCHER_H_
|
