[cros] Display emails of users are stored in a separate dictionary in Local State.

chrome/browser/chromeos/login/user.h

 // Copyright (c) 2011 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_CHROMEOS_LOGIN_USER_H_
 #define CHROME_BROWSER_CHROMEOS_LOGIN_USER_H_
 #pragma once
 
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "third_party/skia/include/core/SkBitmap.h"
 
 namespace chromeos {
 
 // A class representing information about a previously logged in user.
+// Each user has a canonical email (username), returned by |email()| and
+// may have a different displayed email (in the raw form as entered by user),
+// returned by |displayed_email()|.
+// Displayed emails are for use in UI only, anywhere else users must be referred
+// to by |email()|.
 class User {
  public:
   // User OAuth token status according to the last check.
   typedef enum {
     OAUTH_TOKEN_STATUS_UNKNOWN = 0,
     OAUTH_TOKEN_STATUS_INVALID = 1,
     OAUTH_TOKEN_STATUS_VALID   = 2,
   } OAuthTokenStatus;
 
   // Returned as |image_index| when user-selected file or photo is used as
@@ skipping 10 matching lines @@
   std::string GetDisplayName() const;
 
   // Tooltip contains user's display name and his email domain to distinguish
   // this user from the other one with the same display name.
   std::string GetNameTooltip() const;
 
   // Returns true if some users have same display name.
   bool NeedsNameTooltip() const;
 
   // The image for this user.
-  void SetImage(const SkBitmap& image, int image_index);
   const SkBitmap& image() const { return image_; }
   int image_index() const { return image_index_; }
 
   // OAuth token status for this user.
   OAuthTokenStatus oauth_token_status() const { return oauth_token_status_; }
-  void set_oauth_token_status(OAuthTokenStatus status) {
-    oauth_token_status_ = status;
-  }
+
+  // The displayed (non-canonical) user email.
+  std::string display_email() const { return display_email_; }
 
  private:
   friend class UserManager;
 
   // Do not allow anyone else to create new User instances.
   explicit User(const std::string& email);
   ~User();
 
+  // Setters are private so only UserManager can call them.
+  void SetImage(const SkBitmap& image, int image_index);
+
+  void set_oauth_token_status(OAuthTokenStatus status) {
+    oauth_token_status_ = status;
+  }
+
+  void set_display_email(const std::string& display_email) {
+    display_email_ = display_email;
+  }
+
   std::string email_;
+  // The displayed user email, defaults to |email_|.
+  std::string display_email_;
   SkBitmap image_;
   OAuthTokenStatus oauth_token_status_;
 
   // Either index of a default image for the user, |kExternalImageIndex| or
   // |kProfileImageIndex|.
   int image_index_;
 
   DISALLOW_COPY_AND_ASSIGN(User);
 };
 
 // List of known users.
 typedef std::vector<User*> UserList;
 
 }  // namespace chromeos
 
 #endif  // CHROME_BROWSER_CHROMEOS_LOGIN_USER_H_