Print Preview Print Destination Search Widget

chrome/browser/resources/print_preview/data/user_info.js

Index: chrome/browser/resources/print_preview/data/user_info.js
diff --git a/chrome/browser/resources/print_preview/data/user_info.js b/chrome/browser/resources/print_preview/data/user_info.js
new file mode 100644
index 0000000000000000000000000000000000000000..dcab125f63fa7dcc8b921c75bbdf863a147b0891
--- /dev/null
+++ b/chrome/browser/resources/print_preview/data/user_info.js
@@ -0,0 +1,92 @@
+// 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.
+
+cr.define('print_preview', function() {
+  'use strict';
+
+  /**
+   * Repository which stores information about the user. Events are dispatched
+   * when the information changes.
+   * @constructor
+   * @extends {cr.EventTarget}
+   */
+  function UserInfo() {
+    cr.EventTarget.call(this);
+
+    /**
+     * Tracker used to keep track of event listeners.
+     * @type {!EventTracker}
+     * @private
+     */
+    this.tracker_ = new EventTracker();
+
+    /**
+     * Google Cloud Print interface to listen to for events. Currently, through
+     * Google Cloud Print is how we determine the info of the logged in user.
+     * @type {cloudprint.CloudPrintInterface}

[Dan Beam, 2012/05/29 23:36:10]

@type {?cloudprint.CloudPrintInterface}

[Robert Toscano, 2012/05/30 21:08:00]

You only need the ? if the type is a primitive type. E.g. @type {?number} or
@type {?string}, but not @type {?Object} since @type {Object} is equivalent to
@type {?Object}

[Dan Beam, 2012/05/31 00:17:58]

Cool, didn't know that. It does annoy me that ! and ? operators' behaviors
differ for built-ins.

+     * @private
+     */
+    this.cloudPrintInterface_ = null;
+
+    /**
+     * Email address of the logged in user or {@code null} if no user is logged
+     * in.
+     * @type {?string}
+     * @private
+     */
+    this.userEmail_ = null;
+  };

[Dan Beam, 2012/05/29 23:36:10]

general comment: every @constructor function declaration has an unnecessary ;
after them (there are a lot).

[Robert Toscano, 2012/05/30 21:08:00]

I'll remove these in the next CL? (Along with the CSS name refactoring)

+
+  /**
+   * Enumeration of event types dispatched by the user info.
+   * @enum {string}
+   */
+  UserInfo.EventType = {
+    EMIAL_CHANGE: 'print_preview.UserInfo.EMAIL_CHANGE'
+  };
+
+  UserInfo.prototype = {
+    __proto__: cr.EventTarget.prototype,
+
+    /**
+     * @return {?string} Email address of the logged in user or {@code null} if
+     *     no user is logged.
+     */
+    getUserEmail: function() {
+      return this.userEmail_;
+    },
+
+    /**
+     * @param {!cloudprint.CloudPrintInterface} cloudPrintInterface Interface
+     *     to Google Cloud Print that the print preview uses.
+     */
+    setCloudPrintInterface: function(cloudPrintInterface) {
+      this.cloudPrintInterface_ = cloudPrintInterface;
+      this.tracker_.add(
+          this.cloudPrintInterface_,
+          cloudprint.CloudPrintInterface.EventType.SEARCH_DONE,
+          this.onCloudPrintSearchDone_.bind(this));
+    },
+
+    /** Removes all event listeners. */
+    removeEventListeners: function() {
+      this.tracker_.removeAll();
+    },
+
+    /**
+     * Called when a Google Cloud Print printer search completes. Updates user
+     * information.
+     * @type {cr.Event} event Contains information about the logged in user.
+     * @private
+     */
+    onCloudPrintSearchDone_: function(event) {
+      this.userEmail_ = event.email;
+      cr.dispatchSimpleEvent(this, UserInfo.EventType.EMAIL_CHANGE);
+    }
+  };
+
+  return {
+    UserInfo: UserInfo
+  };
+});