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
|
// Copyright 2013 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef COMPONENTS_POLICY_CORE_COMMON_EXTERNAL_DATA_MANAGER_H_
#define COMPONENTS_POLICY_CORE_COMMON_EXTERNAL_DATA_MANAGER_H_
#include <string>
#include "components/policy/core/common/external_data_fetcher.h"
#include "components/policy/policy_export.h"
namespace policy {
// Downloads, verifies, caches and retrieves external data referenced by
// policies.
// An implementation of this abstract interface should be provided for each
// policy source (cloud policy, platform policy) that supports external data
// references.
class POLICY_EXPORT ExternalDataManager {
public:
// Retrieves the external data referenced by the (|policy|, |field_name|) pair
// and invokes |callback|
// with the result. Most external policies only reference a single piece of
// data, in which case |field_name| should be empty. If (|policy|,
// |field_name|) does not reference any external data, the
// |callback| is invoked with a NULL pointer. Otherwise, the |callback| is
// invoked with the referenced data once it has been successfully retrieved.
// If retrieval is temporarily impossible (e.g. no network connectivity), the
// |callback| will be invoked when the temporary hindrance is resolved. If
// retrieval is permanently impossible (e.g. |policy| references data that
// does not exist on the server), the |callback| will never be invoked.
virtual void Fetch(const std::string& policy,
const std::string& field_name,
ExternalDataFetcher::FetchCallback callback) = 0;
};
} // namespace policy
#endif // COMPONENTS_POLICY_CORE_COMMON_EXTERNAL_DATA_MANAGER_H_
|
