Add assigner support to Blimp

blimp/client/session/blimp_client_session.h

Index: blimp/client/session/blimp_client_session.h
diff --git a/blimp/client/session/blimp_client_session.h b/blimp/client/session/blimp_client_session.h
index afcfd5333608381a4493e7fa9b6dab51bbe91186..b5eced035e24e26085d1ff0894c5de488e5ee23d 100644
--- a/blimp/client/session/blimp_client_session.h
+++ b/blimp/client/session/blimp_client_session.h
@@ -42,19 +42,31 @@ class TabControlFeature;
 // feature proxies must be interacted with on the UI thread.
 class BLIMP_CLIENT_EXPORT BlimpClientSession {
  public:
-  explicit BlimpClientSession(scoped_ptr<AssignmentSource> assignment_source);
+  BlimpClientSession();
 
   // Uses the AssignmentSource to get an Assignment and then uses the assignment
   // configuration to connect to the Blimplet.
-  void Connect();
+  // |client_auth_token| is the login authentication token to use when querying
+  // for an assignment.  This token needs the OAuth2 scope of userinfo.email and

[nyquist, 2016/02/18 01:58:40]

Could you mention that it only needs to be an access token, and not a refresh
token?

[David Trainor- moved to gerrit, 2016/02/18 16:01:55]

Done.

+  // should be signed by this APK.

[nyquist, 2016/02/18 01:58:40]

An APK is an Android concept, and this code lives in //blimp/client/session. Do
you have to mention that?

[David Trainor- moved to gerrit, 2016/02/18 16:01:55]

Good point!  Removed.

+  void Connect(const std::string& client_auth_token);
 
   TabControlFeature* GetTabControlFeature() const;
   NavigationFeature* GetNavigationFeature() const;
   RenderWidgetFeature* GetRenderWidgetFeature() const;
 
+  // The AssignmentCallback for when an assignment is ready. This will trigger
+  // a connection to the engine.
+  virtual void ConnectWithAssignment(AssignmentSource::Result result,
+                                     const Assignment& assignment);
+
  protected:
   virtual ~BlimpClientSession();
 
+  // Notified every time the AssignmentSource returns the result of an attempted
+  // assignment request.
+  virtual void OnAssignmentConnectionAttempted(AssignmentSource::Result result);
+
  private:
   // Registers a message processor which will receive all messages of the |type|
   // specified.  Returns a BlimpMessageProcessor object for sending messages of
@@ -63,19 +75,15 @@ class BLIMP_CLIENT_EXPORT BlimpClientSession {
       BlimpMessage::Type type,
       BlimpMessageProcessor* incoming_processor);
 
-  // The AssignmentCallback for when an assignment is ready. This will trigger
-  // a connection to the engine.
-  void ConnectWithAssignment(const Assignment& assignment);
-
-  // The AssignmentSource is used when the user of BlimpClientSession calls
-  // Connect() to get a valid assignment and later connect to the engine.
-  scoped_ptr<AssignmentSource> assignment_source_;
-
   base::Thread io_thread_;
   scoped_ptr<TabControlFeature> tab_control_feature_;
   scoped_ptr<NavigationFeature> navigation_feature_;
   scoped_ptr<RenderWidgetFeature> render_widget_feature_;
 
+  // The AssignmentSource is used when the user of BlimpClientSession calls
+  // Connect() to get a valid assignment and later connect to the engine.
+  scoped_ptr<AssignmentSource> assignment_source_;
+
   // Container struct for network components.
   // Must be deleted on the IO thread.
   scoped_ptr<ClientNetworkComponents> net_components_;