Add EmbedRoot to ViewManagerService.

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 15 matching lines @@
 // ViewManager by embedding it at an approriate Node.
 interface ViewManagerInitService {
   // Embed the application @ |url| at an appropriate Node.
   // The first time this method is called in the lifetime of a View Manager
   // application instance, the "appropriate Node" is defined as being the
   // service root Node.
   // Subsequent times, implementation of this method is delegated to the
   // application embedded at the service root Node. This application is
   // typically referred to as the "window manager", and will have a specific
   // definition of where within its Node hierarchy to embed an unparented URL.
-  EmbedRoot(string url) => (bool success);
+  Embed(string url) => (bool success);
 };
 
 // Nodes and Views are identified by a uint32. The upper 16 bits are the
 // connection id, and the lower 16 the id assigned by the client.
 //
 // The root node is identified with a connection id of 0, and value of 1.
 [Client=ViewManagerClient]
 interface ViewManagerService {
   // Creates a new node with the specified id. It is up to the client to ensure
   // the id is unique to the connection (the id need not be globally unique).
@@ skipping 80 matching lines @@
   //
   // 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 OnRootAdded().
   //
   // A node may only be a root of one connection at a time. Subsequent calls to
   // Embed() for the same node result in the node being removed from the
   // current connection. The current connection is told this by way of
   // OnNodeDeleted().
   //
+  // If |node_id| is 0, the View Manager delegates determination of what node to
+  // embed |url| at to the app embedded at the service root node (i.e. the
+  // window manager).
+  //
   // This advances the server change id.
   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
@@ skipping 53 matching lines @@
   //             removed.
   OnFocusChanged(uint32 gained_focus_id, uint32 lost_focus_id);
 
   // TODO(sky): The following methods represent an interface between the view
   //            manager and the application embedded at the service root node
   //            (i.e. the window manager). These methods are not called on
   //            any other clients. They should be moved to a separate interface
   //            once support for derived FIFOs is landed.
 
   // Requests the window manager create a "top level" node embedding |url|.
-  EmbedRoot(string url);
+  Embed(string url);
 
   // Requests the view manager dispatch the event targeted at |view|.
   DispatchOnViewInputEvent(uint32 view, mojo.Event event);
 };
 
 }