sync/internal_api/public/internal_components_factory.h

   1 // Copyright 2012 The Chromium Authors. All rights reserved.
   2 // Use of this source code is governed by a BSD-style license that can be
   3 // found in the LICENSE file.
   4 //
   5 // InternalComponentsFactory exists so that tests can override creation of
   6 // components used by the SyncManager that are not exposed across the sync
   7 // API boundary.
   8
   9 #ifndef SYNC_INTERNAL_API_PUBLIC_INTERNAL_COMPONENTS_FACTORY_H_
  10 #define SYNC_INTERNAL_API_PUBLIC_INTERNAL_COMPONENTS_FACTORY_H_
  11
  12 #include <string>
  13 #include <vector>
  14
  15 #include "base/files/file_path.h"
  16 #include "sync/base/sync_export.h"
  17 #include "sync/internal_api/public/engine/model_safe_worker.h"
  18
  19 namespace syncer {
  20
  21 class CancelationSignal;
  22 class ExtensionsActivity;
  23 class ModelTypeRegistry;
  24 class ServerConnectionManager;
  25 class SyncEngineEventListener;
  26 class SyncScheduler;
  27
  28 namespace sessions {
  29 class DebugInfoGetter;
  30 class SyncSessionContext;
  31 }
  32
  33 namespace syncable {
  34 class Directory;
  35 class DirectoryBackingStore;
  36 }
  37
  38 class SYNC_EXPORT InternalComponentsFactory {
  39  public:
  40   enum EncryptionMethod {
  41     ENCRYPTION_LEGACY,
  42     // Option to enable support for keystore key based encryption.
  43     ENCRYPTION_KEYSTORE
  44   };
  45
  46   enum BackoffOverride {
  47     BACKOFF_NORMAL,
  48     // Use this value for integration testing to avoid long delays /
  49     // timing out tests. Uses kInitialBackoffShortRetrySeconds (see
  50     // polling_constants.h) for all initial retries.
  51     BACKOFF_SHORT_INITIAL_RETRY_OVERRIDE
  52   };
  53
  54   enum PreCommitUpdatesPolicy {
  55     // By default, the server will enable or disable this experiment through the
  56     // sync protocol's experiments data type.
  57     SERVER_CONTROLLED_PRE_COMMIT_UPDATE_AVOIANCE,
  58
  59     // This flag overrides the server's decision and enables the pre-commit
  60     // update avoidance experiment.
  61     FORCE_ENABLE_PRE_COMMIT_UPDATE_AVOIDANCE,
  62   };
  63
  64   // Configuration options for internal components. This struct is expected
  65   // to grow and shrink over time with transient features / experiments,
  66   // roughly following command line flags in chrome. Implementations of
  67   // InternalComponentsFactory can use this information to build components
  68   // with appropriate bells and whistles.
  69   struct Switches {
  70     EncryptionMethod encryption_method;
  71     BackoffOverride backoff_override;
  72     PreCommitUpdatesPolicy pre_commit_updates_policy;
  73   };
  74
  75   virtual ~InternalComponentsFactory() {}
  76
  77   virtual scoped_ptr<SyncScheduler> BuildScheduler(
  78       const std::string& name,
  79       sessions::SyncSessionContext* context,
  80       CancelationSignal* cancelation_signal) = 0;
  81
  82   virtual scoped_ptr<sessions::SyncSessionContext> BuildContext(
  83       ServerConnectionManager* connection_manager,
  84       syncable::Directory* directory,
  85       ExtensionsActivity* extensions_activity,
  86       const std::vector<SyncEngineEventListener*>& listeners,
  87       sessions::DebugInfoGetter* debug_info_getter,
  88       ModelTypeRegistry* model_type_registry,
  89       const std::string& invalidator_client_id) = 0;
  90
  91   virtual scoped_ptr<syncable::DirectoryBackingStore>
  92   BuildDirectoryBackingStore(
  93       const std::string& dir_name,
  94       const base::FilePath& backing_filepath) = 0;
  95
  96   // Returns the Switches struct that this object is using as configuration, if
  97   // the implementation is making use of one.
  98   virtual Switches GetSwitches() const = 0;
  99 };
 100
 101 }  // namespace syncer
 102
 103 #endif  // SYNC_INTERNAL_API_PUBLIC_INTERNAL_COMPONENTS_FACTORY_H_