Add webui handler for promotions on Android NTP.

chrome/browser/ui/webui/ntp/android/promo_handler.h

+// Copyright (c) 2012 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.
+
+#ifndef CHROME_BROWSER_UI_WEBUI_NTP_ANDROID_PROMO_HANDLER_H_
+#define CHROME_BROWSER_UI_WEBUI_NTP_ANDROID_PROMO_HANDLER_H_
+
+#include "base/memory/scoped_ptr.h"

[Dan Beam, 2012/08/30 18:52:26]

nit: probably not needed now, eh?

[aruslan, 2012/08/30 21:38:17]

Done.

+#include "base/values.h"

[Dan Beam, 2012/08/30 18:52:26]

nit: change to forwards, i.e.

namespace base {
class DictionaryValue;
class List;
}

[aruslan, 2012/08/30 21:38:17]

Done.

+#include "content/public/browser/notification_observer.h"
+#include "content/public/browser/notification_registrar.h"
+#include "content/public/browser/web_ui_message_handler.h"
+
+class PrefService;
+
+// The handler for Javascript messages related to the Android NTP promo.

[Dan Beam, 2012/08/30 18:52:26]

nit: JavaScript

[aruslan, 2012/08/30 21:38:17]

Done.

+class PromoHandler : public content::WebUIMessageHandler,
+                     public content::NotificationObserver {
+ public:
+  PromoHandler();
+  virtual ~PromoHandler();
+
+  // WebUIMessageHandler override and implementation.

[Dan Beam, 2012/08/30 18:52:26]

nit: probably don't need "override and"

[aruslan, 2012/08/30 21:38:17]

Done.

+  virtual void RegisterMessages() OVERRIDE;
+
+  // Register preferences.
+  static void RegisterUserPrefs(PrefService* prefs);
+
+ private:
+  // NotificationObserver override and implementation.
+  virtual void Observe(int type,
+                       const content::NotificationSource& source,
+                       const content::NotificationDetails& details) OVERRIDE;
+
+  // Callback for the "promoSendEmail" message.
+  // |args| is a list [ subject, body, app-chooser-message ].
+  void HandlePromoSendEmail(const base::ListValue* args);
+
+  // Callback for the "promoActionTriggered" message.
+  // |args| is not used, could be empty or NULL.

[Dan Beam, 2012/08/30 18:52:26]

nit: just "No arguments."

[aruslan, 2012/08/30 21:38:17]

Done.

+  void HandlePromoActionTriggered(const base::ListValue* args);
+
+  // Callback for the "promoDisabled" message.
+  // |args| is not used, could be empty or NULL.
+  void HandlePromoDisabled(const base::ListValue* args);
+
+  // Callback for the "getPromotions" message.
+  // |args| is not used, could be empty or NULL.
+  void InjectPromoDecorations(const base::ListValue* args);

[Dan Beam, 2012/08/30 18:52:26]

why isn't this named HandleGetPromotions?

[aruslan, 2012/08/30 21:38:17]

Done.

+
+  // Callback for the "recordImpression" message.
+  // |args| is a list with a name of a page to record an impression from.
+  void RecordImpression(const base::ListValue* args);
+
+  // Records an impression; could trigger a refresh if max_views are exceeded.
+  void RecordPromotionImpression(const std::string& id);
+
+  // Fetches the active promotion and defines what should be passed to JS.
+  // Returns true if the promotion should be shown and the |result| is ready.
+  bool FetchPromotion(base::DictionaryValue* result);
+
+  // Returns true if the Chrome Promo is allowed.
+  bool DoesChromePromoMatchCurrentSync(
+      bool promo_requires_sync,
+      bool promo_requires_no_active_desktop_sync_sessions);
+
+  // Updates the profile preference if any desktop session was discovered.
+  void CheckDesktopSessions();
+
+  // Registrar to receive notification on promo changes.
+  content::NotificationRegistrar registrar_;
+
+  DISALLOW_COPY_AND_ASSIGN(PromoHandler);
+};
+
+#endif  // CHROME_BROWSER_UI_WEBUI_NTP_ANDROID_PROMO_HANDLER_H_