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
|
// Copyright 2012 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_EXTENSIONS_EXTERNAL_LOADER_H_
#define CHROME_BROWSER_EXTENSIONS_EXTERNAL_LOADER_H_
#include "base/files/file_path.h"
#include "base/memory/raw_ptr.h"
#include "base/memory/ref_counted.h"
#include "base/values.h"
#include "extensions/buildflags/buildflags.h"
static_assert(BUILDFLAG(ENABLE_EXTENSIONS_CORE));
namespace extensions {
class ExternalProviderInterface;
// Base class for gathering a list of external extensions. Subclasses
// implement loading from registry, JSON file, policy.
// Instances are owned by ExternalProviderImpl objects.
// Instances are created on the UI thread and expect public method calls from
// the UI thread. Some subclasses introduce new methods that are executed on the
// FILE thread.
// The sequence of loading the extension list:
// 1.) StartLoading() - checks if a loading task is already running
// 2.) Load() - implemented in subclasses
// 3.) LoadFinished()
// 4.) owner_->SetPrefs()
class ExternalLoader : public base::RefCountedThreadSafe<ExternalLoader> {
public:
ExternalLoader();
ExternalLoader(const ExternalLoader&) = delete;
ExternalLoader& operator=(const ExternalLoader&) = delete;
// Specifies the provider that owns this object.
void Init(ExternalProviderInterface* owner);
// Called by the owner before it gets deleted.
void OwnerShutdown();
// Initiates the possibly asynchronous loading of extension list.
// Implementations of this method should call LoadFinished with results.
virtual void StartLoading() = 0;
// Some external providers allow relative file paths to local CRX files.
// Subclasses that want this behavior should override this method to
// return the absolute path from which relative paths should be resolved.
// By default, return an empty path, which indicates that relative paths
// are not allowed.
virtual const base::FilePath GetBaseCrxFilePath();
protected:
virtual ~ExternalLoader();
virtual void LoadFinished(base::Value::Dict prefs);
void OnUpdated(base::Value::Dict updated_prefs);
// Returns true if this loader has an owner.
// This is useful to know if calling LoadFinished/OnUpdated will propagate
// prefs to our owner.
bool has_owner() const { return owner_ != nullptr; }
private:
friend class base::RefCountedThreadSafe<ExternalLoader>;
raw_ptr<ExternalProviderInterface> owner_ = nullptr;
};
} // namespace extensions
#endif // CHROME_BROWSER_EXTENSIONS_EXTERNAL_LOADER_H_
|
