Changes access policy for embedded nodes

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 58 matching lines @@
   // This fails for any of the following reasons:
   // . |parent| or |child| does not identify a valid node.
   // . |child| is an ancestor of |parent|.
   // . |child| is already a child of |parent|.
   //
   // This may result in a connection getting OnNodeDeleted(). See
   // RemoveNodeFromParent for details.
   AddNode(uint32 parent, uint32 child) => (bool success);
 
   // Removes a view from its current parent. This fails if the node is not
-  // valid, |server_change_id| doesn't match, or the node already has no parent.
+  // valid or the node already has no parent.
   //
   // Removing a node from a parent may result in OnNodeDeleted() being sent to
   // other connections. For example, connection A has nodes 1 and 2, with 2 a
   // child of 1. Connection B has a root 1. If 2 is removed from 1 then B gets
   // OnNodeDeleted(). This is done as node 2 is effectively no longer visible to
   // connection B.
   RemoveNodeFromParent(uint32 node_id) => (bool success);
 
   // Reorders a node in its parent, relative to |relative_node_id| according to
   // |direction|.
@@ skipping 37 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().
   //
+  // When a connection embeds an app the connection no longer has priviledges
+  // to access or see any of the children of the node. If the node had existing
+  // children the children are removed. The one exception is the root
+  // connection.
+  //
   // 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
 // 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. |nodes| are the nodes parented to
   // the root.
   OnViewManagerConnectionEstablished(uint16 connection_id,
                                      string creator_url,
                                      NodeData[] nodes);
 
   // See description of ViewManagerService::Embed() for details as to when
   // this is invoked.
   OnRootAdded(NodeData[] nodes);
 
   // Invoked when a node's bounds have changed.
   OnNodeBoundsChanged(uint32 node, mojo.Rect old_bounds, mojo.Rect new_bounds);
 
   // Invoked when a change is done to the hierarchy. A value of 0 is used to
   // identify a null node. For example, if the old_parent is NULL, 0 is
-  // supplied. See description above ViewManager for details on the change ids.
+  // supplied.
   // |nodes| contains any nodes that are that the client has not been told
   // about. This is not sent for hierarchy changes of nodes not known to this
   // client or not attached to the tree.
   OnNodeHierarchyChanged(uint32 node,
                          uint32 new_parent,
                          uint32 old_parent,
                          NodeData[] nodes);
 
   // Invoked when the order of nodes within a parent changes.
   OnNodeReordered(uint32 node_id,
@@ skipping 29 matching lines @@
   //            once support for derived FIFOs is landed.
 
   // Requests the window manager create a "top level" node embedding |url|.
   Embed(string url);
 
   // Requests the view manager dispatch the event targeted at |view|.
   DispatchOnViewInputEvent(uint32 view, mojo.Event event);
 };
 
 }