chromeos: Use protocol buffers for Contact class.

chrome/browser/chromeos/contacts/contact.proto

+// 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.
+//
+// Protocol buffer definitions for the user's contacts.
+
+syntax = "proto2";
+
+option optimize_for = LITE_RUNTIME;
+
+package contacts;
+
+// A contact, roughly based on the GData Contact kind:
+// https://developers.google.com/gdata/docs/2.0/elements#gdContactKind
+// All strings are UTF-8.
+message Contact {
+  // Next ID to use: 15
+
+  // Provider-assigned unique identifier.
+  optional string provider_id = 1;
+
+  // Last time at which this contact was updated within the upstream provider.
+  optional int64 update_time = 2;
+
+  // Has the contact been deleted recently within the upstream provider?
+  optional bool deleted = 3 [default = false];

[Daniel Erat, 2012/07/27 18:44:05]

(I know that false is the default, but I think that being explicit about
defaults is probably better.)

+
+  // Taken from https://developers.google.com/gdata/docs/2.0/elements#gdName.
+  optional string full_name = 4;
+  optional string given_name = 5;
+  optional string additional_name = 6;
+  optional string family_name = 7;
+  optional string name_prefix = 8;
+  optional string name_suffix = 9;
+
+  // PNG-encoded photo (which can safely be decoded to a bitmap outside of a
+  // sandbox).  Unset if no photo is available.
+  optional bytes png_photo = 10;

[Daniel Erat, 2012/07/27 20:04:07]

I'm still going back and forth on this.  Using a test account, I'm seeing a
photo come down the wire as 2211 bytes (JPEG, presumably) but end up as 15428
bytes after I recompress it with PNG.  I don't want to do my own lossy JPEG
compression after decoding the image, so I'll probably just store the original
untrusted data here and try to make the other end stay performant (e.g. by
decoding within a sandbox the first time the data is needed and caching the
bitmap somewhere).

[satorux1, 2012/07/27 20:46:33]

Storing the original data makes sense. You might want to name it something like
raw_untrusted_photo, to make it look scary. You might also want to add a new
filed to store the content type (ex. image/jpeg).

[Daniel Erat, 2012/07/27 21:59:01]

Okay, I've switched to storing the original data and renamed the field (I just
had "untrusted_photo" at first, but I guess that throwing in "raw" doesn't
hurt).  I'm punting on the content type for now, since ImageDecoder doesn't use
it and gdata::GetDownloadDataCallback doesn't pass it (I could add a new
callback type that does, but it seems premature if the image-decoding code won't
use it).

+
+  // Describes an address-like message's type.
+  message AddressType {
+    // Next ID to use: 3
+    enum Relation {
+      HOME = 0;
+      WORK = 1;
+      MOBILE = 2;
+      OTHER = 3;
+    }
+    optional Relation relation = 1 [default = OTHER];
+    optional string label = 2;
+  }
+
+  message EmailAddress {
+    // Next ID to use: 4
+    optional string address = 1;
+    optional AddressType type = 2;
+    optional bool primary = 3 [default = false];
+  }
+  repeated EmailAddress email_addresses = 11;
+
+  message PhoneNumber {
+    // Next ID to use: 4
+    optional string number = 1;
+    optional AddressType type = 2;
+    optional bool primary = 3 [default = false];
+  }
+  repeated PhoneNumber phone_numbers = 12;
+
+  message PostalAddress {
+    // Next ID to use: 4
+    optional string address = 1;
+    optional AddressType type = 2;
+    optional bool primary = 3 [default = false];
+  }
+  repeated PostalAddress postal_addresses = 13;
+
+  message InstantMessagingAddress {
+    // Next ID to use: 5
+    optional string address = 1;
+    // Taken from https://developers.google.com/gdata/docs/2.0/elements#gdIm.
+    enum Protocol {
+      AIM = 0;
+      MSN = 1;
+      YAHOO = 2;
+      SKYPE = 3;
+      QQ = 4;
+      GOOGLE_TALK = 5;
+      ICQ = 6;
+      JABBER = 7;
+      OTHER = 8;
+    }
+    optional Protocol protocol = 2 [default = OTHER];
+    optional AddressType type = 3;
+    optional bool primary = 4 [default = false];
+  }
+  repeated InstantMessagingAddress instant_messaging_addresses = 14;
+}