| OLD | NEW |
| 1 // Copyright 2014 The Chromium Authors. All rights reserved. | 1 // Copyright 2014 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 [DartPackage="mojo"] | 5 [DartPackage="mojo"] |
| 6 module mojo; | 6 module mojo; |
| 7 | 7 |
| 8 import "mojo/public/interfaces/application/application_connector.mojom"; |
| 8 import "mojo/public/interfaces/application/service_provider.mojom"; | 9 import "mojo/public/interfaces/application/service_provider.mojom"; |
| 9 | 10 |
| 10 // An interface through which a Mojo application may communicate with the Mojo | 11 // An interface through which a Mojo application may communicate with the Mojo |
| 11 // system and request connections to other applications. | 12 // system and request connections to other applications. |
| 12 interface Shell { | 13 interface Shell { |
| 13 // Establishes a connection with another application (located at | 14 // See |ApplicationConnector.ConnectToApplication()|. |
| 14 // |application_url|) through which the calling application and the other | 15 // TODO(vtl): Maybe this should be deprecated/removed. |
| 15 // application may request services from one another. | |
| 16 // | |
| 17 // If the calling application would like to request services from the other | |
| 18 // application, it should pass a valid interface request in the |services| | |
| 19 // parameter (i.e. one containing a valid message pipe endpoint). If the other | |
| 20 // application does not wish to offer services, it may either not bind an | |
| 21 // implementation to the interface request, or else bind an implementation | |
| 22 // that will reject some or all service requests. | |
| 23 // | |
| 24 // If the calling application would like to offer services to the other | |
| 25 // application, it should pass a bound interface through the | |
| 26 // |exposed_services| parameter. The other application may then request | |
| 27 // services through that interface. | |
| 28 // | |
| 29 // At least one of |services| or |exposed_services| should be valid/bound in | |
| 30 // the call. | |
| 31 // | |
| 32 // If the |application_url| does not contain a domain, but is of the form | |
| 33 // "mojo:{service}", it is up to the Mojo shell to select an appropriate | |
| 34 // application for the service. Currently, the shell does this based on the | |
| 35 // value of its --origin flag. | |
| 36 ConnectToApplication(string application_url, | 16 ConnectToApplication(string application_url, |
| 37 ServiceProvider&? services, | 17 ServiceProvider&? services, |
| 38 ServiceProvider? exposed_services); | 18 ServiceProvider? exposed_services); |
| 19 |
| 20 CreateApplicationConnector( |
| 21 ApplicationConnector& application_connector_request); |
| 39 }; | 22 }; |
| OLD | NEW |