Pref service: expose all read-only PrefStores through Mojo

services/preferences/public/interfaces/preferences.mojom

 // Copyright 2016 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 module prefs.mojom;
 
 import "mojo/common/values.mojom";
 
 const string kServiceName = "preferences";
 
 // Used for the creation of a PreferencesService and to ensure that the
 // PreferencesServiceClient is bound at creation time.
 interface PreferencesServiceFactory {
   // Creates a PreferencesService bound to the provided |observer|.
   Create(PreferencesServiceClient observer, PreferencesService& service);
 };
 
 // Used to subscribe to preference changes within PreferenceManager. After
 // requesting to observe, the current values for all requested keys are sent.
 interface PreferencesServiceClient {
   OnPreferencesChanged(mojo.common.mojom.DictionaryValue preferences);
 };
 
 // Manages actual read/write of preference data. Accepts observers who subscribe
 // to preferences, notifying them of changes.
 interface PreferencesService {
   SetPreferences(mojo.common.mojom.DictionaryValue preferences);
   Subscribe(array<string> preferences);
 };
+
+const string kPrefStoreServiceName = "preferences2";
+
+[Native]
+enum PrefStoreType;
+
+// Allows observing changes to prefs stored in a |PrefStore|.
+interface PrefStoreObserver {
+  OnPreferencesChanged(mojo.common.mojom.DictionaryValue preferences);
+  OnInitializationCompleted(bool succeeded);
+};
+
+// Captures the connections to a PrefStore by supplying the initial state of the
+// store and a handle to receive notifications on.
+struct PrefStoreConnection {
+  PrefStoreObserver& observer;
+  mojo.common.mojom.DictionaryValue initial_prefs;
+  bool is_initialized;
+};
+
+// Manages actual read of preference data. Accepts observers who subscribe to
+// preferences, notifying them of changes.
+interface PrefStore {
+  // Add an observer of changes. This current values of all prefs will not be
+  // communicated through a call to |observer| but instead be returned in
+  // |initial_prefs|.
+  AddObserver() => (PrefStoreConnection connection);
+};
+
+// Manages a registry of all pref stores. Registered pref stores can be
+// connected to through the |PrefStoreConnector| interface.
+interface PrefStoreRegistry {
+  // Register a pref store.
+  Register(PrefStore pref_store, PrefStoreType type);
+};
+
+// Allows connections to pref stores registered with |PrefStoreRegistry|.
+interface PrefStoreConnector {
+  // Connect to all registered pref stores, retrieving the current values of all
+  // prefs in each store and an |observer| interfaces through which updates can
+  // be received.
+  Connect() => (map<PrefStoreType, PrefStoreConnection> connections);
+};