Makes Embed() take a single node

mojo/services/public/interfaces/view_manager/view_manager.mojom

 // Copyright 2014 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.
 
 import "mojo/services/public/interfaces/geometry/geometry.mojom"
 import "mojo/services/public/interfaces/input_events/input_events.mojom"
 import "mojo/services/public/interfaces/view_manager/view_manager_constants.mojom"
 
 module mojo.view_manager {
 
@@ skipping 108 matching lines @@
   SetView(uint32 node_id, uint32 view_id) => (bool success);
 
   // Shows the specified image (png encoded) in the specified view.
   SetViewContents(uint32 view_id,
                   handle<shared_buffer> buffer,
                   uint32 buffer_size) => (bool success);
 
   // Sets focus to the specified node.
   SetFocus(uint32 node_id) => (bool success);
 
-  // Embeds the app at |url| in the specified nodes. More specifically this
+  // Embeds the app for |url| in the specified node. More specifically this
   // creates a new connection to the specified url, expecting to get an
-  // ViewManagerClient and configures it with the root nodes |nodes|. Fails
-  // if |nodes| is empty or contains nodes that were not created by this
-  // connection.
+  // ViewManagerClient and configures it with the root node |node|. Fails
+  // if |node| was not created by this connection.
   // If a particular client invokes Embed() multiple times with the same url,
   // the connection is reused. When this happens the ViewManagerClient is
-  // notified of the additional roots by way of OnRootsAdded().
-  Embed(string url, uint32[] nodes) => (bool success);
+  // notified of the additional roots by way of OnRootAdded().
+  Embed(string url, uint32 node_id) => (bool success);
 
   // TODO(sky): move these to a separate interface when FIFO works.
 
   // Sends OnViewInputEvent() to the owner of the specified view.
   DispatchOnViewInputEvent(uint32 view_id, mojo.Event event);
 };
 
 // Changes to nodes/views are not sent to the connection that originated the
 // change. For example, if connection 1 attaches a view to a node (SetView())
 // connection 1 does not receive OnNodeViewReplaced().
 [Client=ViewManagerService]
 interface ViewManagerClient {
   // Invoked once the connection has been established. |connection_id| is the id
   // that uniquely identifies this connection. |next_server_change_id| is the
   // id of the next change the server is expecting. |nodes| are the nodes
   // parented to the root.
   OnViewManagerConnectionEstablished(uint16 connection_id,
                                      string creator_url,
                                      uint32 next_server_change_id,
                                      NodeData[] nodes);
 
-  // See description of ViewManagerService::Connect() for details as to when
+  // See description of ViewManagerService::Embed() for details as to when
   // this is invoked.
-  OnRootsAdded(NodeData[] nodes);
+  OnRootAdded(NodeData[] nodes);
 
   // This is sent to clients when a change is made to the server that results
   // in the |server_change_id| changing but the client isn't notified. This is
   // not sent if the client receives a callback giving a new
   // |server_change_id|. For example, if a client 1 changes the hierarchy in
   // some way but client 2 isn't notified of the change, then client 2 gets
   // OnServerChangeIdAdvanced().
   OnServerChangeIdAdvanced(uint32 next_server_change_id);
 
   // Invoked when a node's bounds have changed.
@@ skipping 38 matching lines @@
   //             entirely move to the window manager and this method can be
   //             removed.
   OnFocusChanged(uint32 gained_focus_id, uint32 lost_focus_id);
 
   // TODO(sky): move to separate interface when FIFO sorted out.
 
   DispatchOnViewInputEvent(uint32 view, mojo.Event event);
 };
 
 }